The project's README from github.com/ilyamiro/serpantinum. As one markdown file: README.md.
![]() |
![]() |
![]() |
![]() |
[!IMPORTANT] Hey, join our subreddit! Share your setups, ask questions and follow updates at r/serpantinum.
[!TIP] Full installation and configuration instructions live at serpantinum.dev.
[!IMPORTANT] Migrating from v1: All previous configuration will be backed up and unused. Configuration of compositor settings such as monitors, keybinds, and autostart is now up to you, as the project migrated from being dotfiles to being a shell.
For Arch-based distributions (including systemd, OpenRC, and other init systems), for Fedora-based distributions such as Nobara and Ultramarine, and for Void Linux (glibc and musl), run the automated installation script. It detects your distribution and uses pacman, dnf or xbps.
Use this installer:
curl -fsSL install.serpantinum.dev | bash
If this doesn't work, use:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/ilyamiro/serpantinum/master/install/install.sh)"
[!NOTE] To update, run the script again and choose "update".
See the NixOS installation guide for flake setup, the NixOS and Home Manager modules, and updating.
The equalizer, balance, mono, channel swap, dynamic range modes and the dynamic EQ run on serpantinum-audio, a small PipeWire processor that replaces EasyEffects. The installer and the packages install it, and on the first start after updating, Serpantinum hands your audio over from EasyEffects. See the audio engine guide.
The blue light filter and its day and night schedule run on serpantinum-gamma, a small Wayland daemon that replaces wl-gammarelay-rs. The installer and the packages install it. Serpantinum starts it the first time a filter is turned on and stops it on exit.
Hyprland, Niri, Sway and Mango. The installer detects the running compositor and deploys its configuration. On Fedora, Mango is installed from the Terra repository. On Void Linux, Hyprland is installed from the third-party black-hole.dev repository.
To run the shell, launch serpantinumd start
For configuration, see the configuration guide.
Copyright (C) 2026 Illia Miroshnichenko
This project is licensed under the GNU Affero General Public License version 3, or (at your option) any later version. See the LICENSE.md file for the full license text.