A SOSS shell for X11 and i3wm, crafted using fabric. The shell features a plethora of widgets with an easily configurable and modular system. I've had a LOT of fun working with fabric and building this — I hope you do too!
Warning
This project is nearing its first stable release. Installers are available, but some breaking changes may still occur :)
![]() |
||
![]() |
![]() |
![]() |
Warning
The lockscreen is currently a WIP and may not handle all edge cases. While barely functional, it is far from secure. Please test thoroughly in a safe environment before relying on it for security-critical scenarios.
Note
The installer will set up all dependencies, configure a Python virtual environment, download fonts, and create a launcher at ~/.local/bin/zenith-shell.
Arch Linux
curl -sSL https://raw.githubusercontent.com/amansxcalibur/zenith-shell/main/install_arch.sh | bashUbuntu / Debian
curl -sSL https://raw.githubusercontent.com/amansxcalibur/zenith-shell/main/install_ubuntu.sh | bashAfter installation, run:
zenith-shellOr restart your i3wm session.
Tip
If zenith-shell is not found after install, add ~/.local/bin to your PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrcThe installers handle these automatically. Listed here for reference.
Fabric ecosystem
- fabric - shell framework (via
requirements.txt) - fabric-cli - CLI companion
- gray - system tray support
Other utilities
feh- wallpaper setterplayerctl- MPRIS controlbrightnessctl- screen brightness control
Themes and Typography
- matugen - dynamic Material You theming
- Roboto Flex
- Google Sans Flex
- Material Symbols
Python - see requirements.txt
Arch-only (AUR)
python-gobject,python-cairo,gobject-introspection,gnome-bluetooth-3.0,libdbusmenu-gtk3,libnotify
Ubuntu-only (apt)
python3-dev,python3-venv,python3-pip,libcairo2-dev,libgirepository1.0-dev,libgtk-3-dev,libdbusmenu-gtk3-dev,gir1.2-playerctl-2.0,build-essential,pkg-config,meson,ninja-build,valac
|
|
|





