Installation Instructions

Building

The project uses meson, so the steps are

meson build
ninja -C build

To see all available options, type the following after the build directory is initialized, or look inside meson_options.txt.

meson configure build

Optimization

The default build type is debugoptmized, which is equivalent to -Ddebug=true -Doptimization=2 (-O2 -g). This works well in most cases. For extremely optimized builds, we suggest building with

meson build -Ddebug=true -Doptimization=3 -Dextra_optimizations=true

We suggest always keeping -Ddebug=true to assist with meaningful stack traces and bug reports.

Dependencies

Required

audec (AGPLv3+): https://git.zrythm.org/cgit/libaudec/
breeze-icons (LGPLv3+): https://github.com/KDE/breeze-icons
fftw (GPLv2+): http://www.fftw.org/
gtk+3 (LGPLv2.1+): https://gitlab.gnome.org/GNOME/gtk
gtksourceview (LGPLv2.1+): https://wiki.gnome.org/Projects/GtkSourceView
guile (GPLv3+): https://www.gnu.org/software/guile/
libcyaml (ISC): https://github.com/tlsa/libcyaml/
lilv (ISC): https://drobilla.net/software/lilv
zstd (3-Clause BSD): https://github.com/facebook/zstd

Optional

carla (GPLv2+): https://kx.studio/Applications:Carla
ffmpeg (LGPLv2.1+, GPLv2+): https://ffmpeg.org/
graphviz (EPLv1.0): http://graphviz.org/
jack (LGPLv2.1+): https://jackaudio.org/
libgtop (GPLv2+): https://developer.gnome.org/libgtop/
rtaudio (MIT): http://www.music.mcgill.ca/~gary/rtaudio/
rtmidi (MIT): https://www.music.mcgill.ca/~gary/rtmidi/
SDL2 (zlib): https://www.libsdl.org/

Installation

Once the program is built, it will need to be installed the first time before it can run (to install the GSettings)

ninja -C build install

Alternatively if you don't want to install anything on your system you can run glib-compile-schemas data/ and then run zrythm using GSETTINGS_SCHEMA_DIR=data ./build/src/zrythm. The built program will be at build/src/zrythm by default

Running

When running Zrythm from the command line, it is recommended to use zrythm_launch instead of running the zrythm binary directly. This takes care of using the correct GSettings schemas in the installed prefix.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.