https://github.com/dvlv/boxbuddy

An Unofficial GUI for managing multiple distros via Distrobox
https://github.com/dvlv/boxbuddy

distrobox gui qt

Last synced: 2 months ago
JSON representation

An Unofficial GUI for managing multiple distros via Distrobox

• Host: GitHub
• URL: https://github.com/dvlv/boxbuddy
• Owner: Dvlv
• License: mit
• Created: 2023-03-01T19:01:51.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2023-12-16T15:24:34.000Z (about 1 year ago)
• Last Synced: 2023-12-16T16:36:03.960Z (about 1 year ago)
• Topics: distrobox, gui, qt
• Language: C++
• Homepage:
• Size: 5.4 MB
• Stars: 17
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# BoxBuddy

## Deprecated

This version is now deprecated, please use [the replacement written with Rust and GTK4/Libadwaita.](https://github.com/Dvlv/BoxBuddyRS)

## Original Readme:

A Graphical manager for [Distrobox](https://github.com/89luca89/distrobox), enabling the creation and use of multiple linux distributions via containers.

**NOTE** Now deprecated for GTK Version [available here.](https://github.com/Dvlv/BoxBuddyGTK)

## Screenshots

![screenshots/newbox.png](/screenshots/newbox.png)

![screenshots/manage.png](/screenshots/manage.png)

![screenshots/installedapps.png](/screenshots/installedapps.png)

## Installing

### Dependencies

- [Distrobox](https://github.com/89luca89/distrobox)

    - `Podman` or `Docker`

- One of the following Terminals:

    - Konsole

    - Gnome Terminal

    - XTerm

### Instructions

Simply clone or download a zip of this repo, and launch the `install.sh` script. 

The application will be installed to `~/.local/bin` by default, or you can export `INSTALL_DIR=/my/other/path` to change the destination.

Icons will be installed in `$XDG_DATA_HOME`, which is `~/.local/share` by default.

Ensure that the install destination is in your `$PATH`.

### Uninstalling

Simply delete the `boxbuddy` folder in your install destination and your `$XDG_DATA_HOME`, then remove the `boxbuddy.desktop` file from `~/.local/share/applications`.

## Developing

### Dependencies

All of the above mentioned dependencies, as well as:

- cmake

- qt development libraries

The easiest way to get these on most distros is to just install Qt Creator from your package manager.

### Building

Typical `cmake` workflow, e.g.:

- `mkdir build`

- `cd build`

- `cmake ..`

- `make`

A `go.sh` script is provided for convenience, but be aware this will run the `install.sh` script on every build