DistroHopper/docs

---

Looking to try out a new operating system?

try

DistroHopper

Quickly download, create and run VM of any#TODO operating system.

Linux required...

---

Click on Hop for latest download

Licensed under AGPL3

Still Beta version!

Click for screenshot


As a base excellent quickemu (Link to project page)

Click for Quickemu old video

You can download new distro with few clicks of a mouse

Features

• GUI using yad

Click for old video

- TUI using fzf

Click for old video

- Desktop(shortcuts) entries generator

• Set dir where VMs will be stored

• Install DistroHopper systemwide

• Portable mode (dependecies still must be installed)

• Add new operating system to quickget (bit easier)

• Copy all downloaded ISOs to destination directory

• Translate DistroHopper (Currently supported English and Czech language)

Developed in English and translated into Czech language.

Welcome translations!

---

Why am I doing it?

Because I wanna learn

• Linux

• Bash

• yad

• project management

And contribute to open source

play with Quickemu

And easily add new distros to it

---

How to run DistroHopper?

You need fullfill the requirement first...

Requirements (For running VMs)

• QEMU (6.0.0 or newer) with GTK, SDL, SPICE & VirtFS support
• bash (4.0 or newer)
• Coreutils
• EDK II
• grep
• jq
• LSB
• procps
• python3
• macrecovery
• mkisofs
• usbutils
• util-linux
• sed
• socat
• spicy
• swtpm
• Wget
• xdg-user-dirs
• xrandr
• zsync
• unzip

Installing Requirements

For Ubuntu, Arch and nixos systems the ppa, AUR or nix packaging will take care of the dependencies. For other host distributions or operating systems it will be necessary to install the above requirements or their equivalents.

If you install DistroHopper, it should take care of dependencies on Arch, Debian, Ubuntu, openSuse and Fedora

For DistroHopper to work you need

wget yad fzf

quickemu is included

For adding new distros, or adding/improving translations you will need also meld.

How to install DistroHopper?

You need get copy of distrohopper

If you want more stable experience, download latest release from

GitHub or SourceForge

---

If you want latest developer version... (could have bugs and break anytime)

Or you want translate DistroHopper

git clone https://github.com/oSoWoSo/DistroHopper

Enter created/unpacked distrohopper directory

Now you should be good to go...

---

How to run DistroHopper

Just run from terminal

./dh

And you will see what next...

I am usually run DistroHopper as:

./dh m r s l && ./dh i && dh g

(But...)

Desktop files

All desktop files will be storred in your .config/distrohopper in directories ready and supported

Fell free to copy them anywhere you want...

Currently supported Operating Systems and tools:

• agarimos - alma - alpine - android - archlinux - archcraft - arcolinux
• batocera - blendos - cachyos - centos-stream - cereus - debian - deepin
• devuan - dietpi - dragonflybsd - elementary - endeavouros - endless
• fedora - freebsd - freedos - fvoid - gabeeos - garuda - gentoo
• ghostbsd - haiku - kali - kdeneon - kolibrios - kubuntu - linuxmint
• lmde - mageia - manjaro - miyo - mxlinux - netboot - netbsd - nixos
• lubuntu - macos - openbsd - opensuse - oraclelinux - popos - reactos
• rebornos - rockylinux - siduction - slackware - slitaz - solus
• steamos - tails - truenas-core - truenas-scale - ubuntu - ubuntu-budgie
• ubuntukylin - ubuntu-mate - ubuntustudio - ubuntu-unity - ventoy - void
• voidpup - vxlinux - windows - xerolinux - xubuntu - zorin

Also with posible planned: in discusion

---

discuss on github

Join DistroHopper chat group:

(click SimpleX logo)

(check the software! even if you don't want chat about DistroHopper) Simplex website

Without these amazing projects it wouldn't be posible:

bash

QEMU

quickemu

GUI depends on

yad

TUI depends on

fzf

---

For

• easy of use

fish

• commiting and working with github

lazygit

opencommit

• Editing

geany

Kate

• diff

Meld

• Logo and icons

GIMP

and

Inkscape

logo by bit repaired by me..

• Updating translation

Poedit

Everything done on

Void Linux

---

Mirrored on

GitHub

SourceForge

Disroot

Codeberg

GitLab

SourceHut

---

For Homepage click on Hop

donate

@zen0bit at github

mailto: zenobit@osowoso.xyz

up

parent site oSoWoSo