Installation#

Arch Linux#

maintainer: @linkfrg

Install the package from AUR.

paru -S ignis

For the latest (git) version of Ignis install ignis-git

paru -S ignis-git

Nix#

maintainer: missing specific maintainers, the package is mostly maintained by free contributors (bugs are expected)

Contributors:

  • @frdiener

  • @somokill

  • @ratson

  • @0x006E

Warning

This will install the latest (git) version of Ignis. Please refer to the latest documentation.

Add Ignis to your flake's inputs:

ignis.url = "github:linkfrg/ignis";

Then add the following to environment.systemPackages or home.packages:

inputs.ignis.packages.${system}.ignis

Pip#

Pip is the standard package manager for Python. You can install Ignis directly from the Git repository using Pip.

Hint

You can do this in a Python virtual environment. Create and activate one with the following commands:

python -m venv venv
source venv/bin/activate  # for fish: . venv/bin/activate.fish

To install the latest (Git) version of Ignis:

pip install git+https://github.com/linkfrg/ignis.git

To install a specific version (e.g., v0.5):

# replace "TAG" with the desired Git tag
pip install git+https://github.com/linkfrg/ignis.git@TAG

See also

For advanced usage, you can set up a development environment and install Ignis in editable mode. This allows you to easily switch between commits, versions, branches, or pull requests using git, without having to reinstall Ignis.

Building from source#

Dependencies:

  • ninja

  • meson

  • gtk4

  • gtk4-layer-shell

  • glib-mkenums (glib2-devel)

  • pygobject >= 3.50.0

  • pycairo

  • python-click

  • python-loguru

  • libpulse (if using PipeWire, install pipewire-pulse)

git clone https://github.com/linkfrg/ignis.git
cd ignis
meson setup build --prefix=/usr
meson compile -C build
meson install -C build

Running#

ignis init