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

Using WSLg,

$ git clone git@github.com:naruaika/witt-data-studio.git
$ cd witt-data-studio

$ sudo apt install libglib2.0-dev \
                   libgtk-4-dev \
                   libadwaita-1-dev \
                   libgtksourceview-5-dev \
                   libgirepository-2.0-dev
$ sudo apt install build-essential \
                   pkg-config \
                   cmake \
                   gettext \
                   flatpak \
                   flatpak-builder \
                   meson
$ flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
$ flatpak install flathub org.gnome.Platform//50
$ flatpak install flathub org.gnome.Sdk//50

$ flatpak-builder build-dir build-aux/com.wittara.studio.json
$ flatpak-builder --run build-dir build-aux/com.wittara.studio.json witt-data-studio

Otherwise,

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 -U -r build-aux/requirements.txt

4. Build and run it:

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

You may also encounter frustrating situation when building some of them from source. Please consider to install binary-ready packages. 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.