ilyamiro/serpantinum

A shell for wayland compositors

QMLAGPL-3.0 Last commit 22 hours ago serpantinum.dev

Updated 36 min ago

Open on GitHub

Last 24 hours: +12; stars
Last 7 days: +132; stars
Last 30 days: +527; stars
Total stars: 7,416
Forks: 323

Star history

Total stars at the end of each week, from GitHub’s daily star counts.

+132 stars this week, against ~129 in a usual week

Rank in its topics

Out of repos that gained at least 20 stars in the period

Rank of ilyamiro/serpantinum in each topic for today, this week and this month
Topic	Today	This week	This month
Dotfiles & desktop topic	–	#30of 61	#40of 116
Terminal topic	–	#69of 133	#83of 243

Health signals

HealthyChecked Oct 14, 2026

Commit activity: Commits in 7 of the last 13 weeks 666 commits on the default branch in 90 days
Maintainers: 3 commit authors in 90 days Top author: 98% of the last 100 commits
Issue responsiveness: Median first response: under an hour 34 of the latest 50 issues opened in 90 days are closed
Pull requests: 31 merged, 8 closed, 11 open Of the latest 50 opened in 90 days
Releases: Last release: 6 days ago 1 release in the last 12 months
Project hygiene: License, CI; no security policy
OpenSSF Scorecard: Not scanned Unknown, not counted against the project

Signals are computed automatically from public GitHub data. They are not an endorsement or a security audit. How health is computed

README

README.md

Previews

Installation

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.

Arch Linux and its derivatives

For Arch-based distributions (including systemd, OpenRC, and other init systems), run the automated installation script.

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, when or if you recieve a notification about the new version being available, just run the script again and choose "update"

NixOS

See the NixOS installation guide for flake setup, the NixOS and Home Manager modules, and updating.

Running

To run the shell, launch serpantinumd start

For configuration, see the configuration guide.

Credits

Special thanks to Darkall44/Qylock for providing a gorgeous material SDDM theme!

Thanks to all contributors

License

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.