Skip to content

amansxcalibur/zenith-shell

Repository files navigation

Sparkles ZENITH Sparkles

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 :)

Showcase

LockScreen (WIP)

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.

Installation

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 | bash

Ubuntu / Debian

curl -sSL https://raw.githubusercontent.com/amansxcalibur/zenith-shell/main/install_ubuntu.sh | bash

After installation, run:

zenith-shell

Or 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 ~/.bashrc

Dependencies

The 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 setter
  • playerctl - MPRIS control
  • brightnessctl - screen brightness control

Themes and Typography

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

Sparkles sᴜᴘᴘᴏʀᴛ ᴛʜᴇ ᴘʀᴏᴊᴇᴄᴛ ~ ᴅʀᴏᴘ ᴀ ⭐️ Sparkles
Heya!

About

A shell for X11, crafted with fabric

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors