DistroShelf - A GUI for Distrobox Containers

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

Screenshot

Installation

Flatpak

flatpak install com.ranfdev.DistroShelf

Third party packages

Arch linux

distroshelf is on the AUR

NixOS

distroshelf on nixpkgs-unstable

From Source

With GNOME Builder

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.

Requirements

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

Steps

Clone the repository:

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

Build and install:

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

Configuration

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

Supported terminals:

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

Contributing

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

Enable local pre-commit checks

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

License

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

Credits

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

DistroShelf

Install / Use

README