Build & Run

Linux

The recommended way to build and run this project is using GNOME Builder. Select the default manifest file (com.wittara.studio.json) and click the Run button. Check out our YouTube video for a visual walkthrough.

Windows

1. Follow the GTK installation guide from the official documentation.
2. Clone the repository and go to the project directory.
3. Install all dependencies:

$ pacman -S mingw-w64-ucrt-x86_64-libadwaita \
            mingw-w64-ucrt-x86_64-cmake \
            mingw-w64-ucrt-x86_64-ninja \
            mingw-w64-ucrt-x86_64-rust \
            mingw-w64-ucrt-x86_64-python-maturin \
            mingw-w64-ucrt-x86_64-meson \
            mingw-w64-ucrt-x86_64-desktop-file-utils
$ python -m venv --system-site-packages .pyvenv
$ source .pyvenv/bin/activate
$ python -m pip install -r build-aux/requirements.txt

4. Build with meson and run the generated script:

$ source .pyvenv/bin/activate
$ make setup
$ make install
$ make run

Note that the requirements.txt may not up-to-date. In that case, please install them manually one-by-one. You may also encounter frustrating situation when building them from source. Please consider to install them globally when they're available. For example:

$ pacman -S mingw-w64-ucrt-x86_64-duckdb \
            mingw-w64-ucrt-x86_64-python-numpy \
            mingw-w64-ucrt-x86_64-python-polars \
            mingw-w64-ucrt-x86_64-python-polars-runtime-64 \
            mingw-w64-ucrt-x86_64-python-pyarrow \
            mingw-w64-ucrt-x86_64-python-fastexcel \
            mingw-w64-ucrt-x86_64-python-keyring \
            mingw-w64-ucrt-x86_64-python-dateutil
$ pip install pykdtree witt-strutil

Note that the font rendering on Windows looks horrible. Currently no idea if we can fix it properly.