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 enter 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 and run it:

$ 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, we have no idea to properly fix it.