Skip to content

ejaa3/aquarelle

Repository files navigation

Aquarelle

REUSE status

Can be the following:

  • An experimental environment for color schemes.
  • A (pre)processor of themes in any format (if possible).
  • A way to customize the appearance of software declaratively.
  • My personal rice (the aquarelle namespace).

The current state is basically:

  • Almost undocumented.
  • The CLI is functional, the GUI is not.
  • The API seems stable.
  • Review is needed (memory layout, error handling, etc.).

Development and testing

The following commands are assumed to be executed with bash in the project directory:

  • First configure the project directory: meson setup build --prefix ~/install_dir

    Change ~/install_dir to the directory of your choice, and now you can use cargo properly.

  • Run the CLI version as follows: cargo run --features cli

    To use arguments, append: -- <arg1> <arg2> <...>

  • Before running the GUI version, the settings schema must be compiled:

    mkdir -p ~/.local/share/glib-2.0/schemas/
    ln -s $(pwd)/build/data/io.github.ejaa3.Aquarelle.Devel.gschema.xml \
            ~/.local/share/glib-2.0/schemas/ && \
        glib-compile-schemas ~/.local/share/glib-2.0/schemas/

    Now you can run the GUI version: cargo run --features gui --bin gui

  • Installation: meson install -C build

  • Book: mdbook serve --open