DistroShelf is a graphical interface for managing Distrobox containers on Linux. It provides an easy way to:

• Create and manage containers
• View container status and details
• Install packages
• Manage exported applications
• Open terminal sessions
• Upgrade containers
• Clone and delete containers

or

flatpak install com.ranfdev.DistroShelf

distroshelf is on the AUR

distroshelf on nixpkgs-unstable

The recommended way to build this project is with GNOME Builder. It will install all the required dependencies, then it will build and run the project as a flatpak. If you don't plan to use GNOME Builder, you can follow the instructions below.

• Distrobox installed and configured
• GTK 4 and libadwaita
• Supported terminal emulator (GNOME Terminal, Konsole, etc.)

1. Clone the repository:

git clone https://github.com/ranfdev/DistroShelf.git
cd DistroShelf

2. Build and install:

meson build --prefix=/usr
ninja -C build
sudo ninja -C build install

You can configure your preferred terminal emulator in the Preferences dialog.

Supported terminals:

• GNOME Terminal
• Konsole
• Xfce Terminal
• Tilix
• Alacritty
• And more...

Contributions are welcome! Please open an issue or pull request on GitHub.

To block commits when formatting, clippy, or tests fail, enable the repository hook once:

./.githooks/install.sh

The pre-commit hook runs:

• cargo fmt --all -- --check
• cargo clippy --all-targets --all-features
• cargo test --all-features

DistroShelf is licensed under the GPL-3.0-or-later license.

• Distro icons from font-logos
• Some snippets are from BoxBuddy
• Distrobox