distrobox-tui

March 11, 2025 ยท View on GitHub

Go Report Card

screenshot.png

A minimal TUI for Distrobox using Bubbletea.

Features Catppuccin color palette. Support for theme selection coming in future release.

My intention is to learn the Bubbletea framework by creating something (sort of?) useful.

Install

Requirements

  • Go 1.18+
  • Distrobox
  • Linux
go install github.com/phanirithvij/distrobox-tui@main

Nix

It is available in nixpkgs unstable as distrobox-tui.

nix --extra-experimental-features "flakes nix-command" run github:nixos/nixpkgs/nixos-unstable#distrobox-tui

Usage

  • Must be run from the host OS
  • Ensure $GOPATH/bin is in your shell's $PATH
distrobox-tui # looks for podman, docker, lilipod in that order

# To specify a container manager use one of
DBX_CONTAINER_MANAGER=podman distrobox-tui
DBX_CONTAINER_MANAGER=docker distrobox-tui
DBX_CONTAINER_MANAGER=lilipod distrobox-tui

Currently it is not possible to create Distroboxes in the TUI, but this might be added in the future.

For other planned things see docs/ROADMAP.md

Project history

This project is a continuation of the original project, created by @hyperreal64.