Warning
This project is no longer maintained, and I have no plans to resume its development. Learn why here.
That's what you're here for, right?
| Frieren | Rain Worl |
|---|---|
![]() |
![]() |
| Application launcher | Lock screen |
![]() |
![]() |
- Support for the Niri compositor
- Material design
- Matugen color generation
- Shell modules
- Status bar
- Notification service with cross-session persistence
- Quick settings
- Application launcher
- Session lock with multiple authentication methods
- Session management
- Volume and brightness OSD
- Niri
- Quickshell
- swayidle (to be removed)
- swaylock (to be removed)
- matugen
- UPower daemon
- Power profiles daemon
ddcutil
While I do not provide an installation method just yet, you can still try the shell!
- Clone the repo
git clone https://github.com/tpaau/shell
cd shell
- Install the required dependencies
- You will also need
cargoand optionallyjust swaylockis not a required dependency if you're just testing things out
- Run the shell
Warning
The shell will mess with Niri config files in ~/.config/niri, so please make sure
to back them up.
Run just run-dev, or copy the list of commands from the justfile and run them
manually.
Note
The shell will create its data, config, and cache directories:
~/.local/share/tpaau-shell/~/.config/tpaau-shell/~/.cache/tpaau-shell/
You can easily remove them with just rm-shell-dirs.
If you updated the shell and now you get unexpected behavior or file errors, try removing these directories.
- Add the settings app
- Test support for multiple monitors
- Add a custom polkit agent
- Add dock
- Create packages for Fedora and Arch
No, I want to focus on the shell doing one thing and doing it well. I do not plan on supporting other compositors.
My dots would be worthless without the amazing software they are made for! Give the devs of these projects a big thanks!
- Depth Anything - Image depth generator
- just - Just a command runner



