DistroHopper/docs/README.md

![](https://img.shields.io/github/stars/oSoWoSo/DistroHopper?style=for-the-badge&color=8BC53F&logo=instatus&logoColor=000000)
![](https://img.shields.io/github/forks/oSoWoSo/DistroHopper?style=for-the-badge&color=8BC53F&logo=git&logoColor=000000)
![](https://img.shields.io/github/license/oSoWoSo/DistroHopper?style=for-the-badge&color=8BC53F&logo=apache&logoColor=000000)
![](https://img.shields.io/github/repo-size/oSoWoSo/DistroHopper?style=for-the-badge&color=8BC53F&logo=files&logoColor=000000)
![](https://img.shields.io/github/last-commit/oSoWoSo/DistroHopper?style=for-the-badge&color=8BC53F&logo=codeigniter&logoColor=000000)
![](https://img.shields.io/badge/language-shell-green?style=for-the-badge&color=8BC53F&logo=sharp&logoColor=000000)

Want you try new Operating system?

 try

[DistroHopper](https://github.com/oSoWoSo/DistroHopper)

![Hop](logo.svg)

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

<noscript><a href="https://liberapay.com/zenobit/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a></noscript>

Licensed under AGPL3
### Still Testing version!
![dh](distrohopper.png)

quickly create and run VMs

 As a base excellent [quickemu](https://github.com/quickemu-project/quickemu)
  
  you can download new distro with few clicks of a mouse
  
## GUI using yad

See it in action on youtube...

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/JtjIseqZMkQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

  or command line?...

## TUI using fzf

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/gJ5hqYEskOw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

## .Desktop file generator
  It will simple generate .desktop files for every supported and downloaded VM in quickemu.
  So you can link it anywhere...

---

# 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...

Quickemu.

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/AOTYWEgw0hI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

## Requirements (For running VMs)

-   [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL,
    SPICE & VirtFS support**
-   [bash](https://www.gnu.org/software/bash/) (*4.0 or newer*)
-   [Coreutils](https://www.gnu.org/software/coreutils/)
-   [EDK II](https://github.com/tianocore/edk2)
-   [grep](https://www.gnu.org/software/grep/)
-   [jq](https://stedolan.github.io/jq/)
-   [LSB](https://wiki.linuxfoundation.org/lsb/start)
-   [procps](https://gitlab.com/procps-ng/procps)
-   [python3](https://www.python.org/)
-   [macrecovery](https://github.com/acidanthera/OpenCorePkg/tree/master/Utilities/macrecovery)
-   [mkisofs](http://cdrtools.sourceforge.net/private/cdrecord.html)
-   [usbutils](https://github.com/gregkh/usbutils)
-   [util-linux](https://github.com/karelzak/util-linux)
-   [sed](https://www.gnu.org/software/sed/)
-   [socat](http://www.dest-unreach.org/socat/)
-   [spicy](https://gitlab.freedesktop.org/spice/spice-gtk)
-   [swtpm](https://github.com/stefanberger/swtpm)
-   [Wget](https://www.gnu.org/software/wget/)
-   [xdg-user-dirs](https://www.freedesktop.org/wiki/Software/xdg-user-dirs/)
-   [xrandr](https://gitlab.freedesktop.org/xorg/app/xrandr)
-   [zsync](http://zsync.moria.org.uk/)
-   [unzip](http://www.info-zip.org/UnZip.html)

### Installing Requirements

For Ubuntu, Arch and nixos systems the
[ppa](https://launchpad.net/~flexiondotorg/+archive/ubuntu/quickemu),
[AUR](https://aur.archlinux.org/packages/quickemu) or
[nix](https://github.com/NixOS/nixpkgs/tree/master/pkgs/development/quickemu)
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.

These examples may save a little typing

Debian:

    sudo apt install qemu bash coreutils ovmf grep jq lsb procps python3 genisoimage usbutils util-linux sed spice-client-gtk swtpm wget xdg-user-dirs zsync unzip

Fedora:

    sudo dnf install qemu bash coreutils edk2-tools grep jq lsb procps python3 genisoimage usbutils util-linux sed spice-gtk-tools swtpm wget xdg-user-dirs xrandr unzip
    
Void Linux:

    sudo xbps-install qemu bash coreutils grep jq procps-ng python3 util-linux sed spice-gtk swtpm usbutils wget xdg-user-dirs xrandr unzip zsync socat

# For Distrohopper to work you need `wget yad fzf` quickemu is included

# How to install DistroHopper?

 You need get copy of distrohopper
 
  If you want more stable experience, download latest release from [GitHub](https://github.com/oSoWoSo/DistroHopper/releases)
  
  or
  
  From SourceForge [![SourceForge](https://img.shields.io/sourceforge/dt/distrohopper.svg)](https://sourceforge.net/projects/distrohopper/files/latest/download)
 
 If you want latest developer version... (could have bugs)
 
 `git clone https://github.com/oSoWoSo/DistroHopper`
 
 Enter created/unpacked distrohopper directory
 
 Then enter config directory
 
 `cd distrohopper/config`
 
 And run
 
 `./1stRun.sh`
 
 Now should be good to go...

---

# How to run

 Just run from terminal
 
 `dh`
 
 or for TUI version (Download and run from/into same directory)
 
 `dh -t`
 
# Desktop files

 All desktop files will be storred in your .config
 in directories /distrohopper/ready and supported
 
 Fell free to link them anywhere you want...
 
 

# Currently supported Distribution:

In screenshot above...

---

# Github discussion:

[discuss](https://github.com/oSoWoSo/DistroHopper/discussions)

# Project chat group:
If anyone wanna join, here is one 
[![SimpleX](simplex.svg)](https://simplex.chat/contact#/?v=1-2&smp=smp%3A%2F%2FSkIkI6EPd2D63F4xFKfHk7I1UGZVNn6k1QWZ5rcyr6w%3D%40smp9.simplex.im%2FzmtsZwfTjwyynibt0bF6bb_xLWS9ce5A%23%2F%3Fv%3D1-2%26dh%3DMCowBQYDK2VuAyEAkMtz66wGfWb6VDn-_t_mVm3RFiFfOC3Hxye8Hm5tmVo%253D%26srv%3Djssqzccmrcws6bhmn77vgmhfjmhwlyr3u7puw4erkyoosywgl67slqqd.onion&data=%7B%22type%22%3A%22group%22%2C%22groupLinkId%22%3A%22o8KR0TOM0f2j33nO9goMRQ%3D%3D%22%7D) way

(check the software! even if you don't want chat about DistroHopper)
[Simplex website](https://simplex.chat)

# Without these amazing projects it wouldn't be posible:

[bash](https://www.gnu.org/software/bash/)

[QEMU](https://www.qemu.org/)

[quickemu](https://github.com/quickemu-project/quickemu)

GUI depends on
[yad](https://github.com/v1cont/yad)

TUI depends on
[fzf](https://github.com/junegunn/fzf)

----

For easy of use

[fish](https://fishshell.com)

For commiting and working with github

[lazygit](https://github.com/jesseduffield/lazygit)

Edited

[geany](https://geany.org/)

[Kate](https://apps.kde.org/kate)

For diff

[Meld](https://meld.app/)

for Logo and icons

[GIMP](https://www.gimp.org)

and

[Inkscape](https://inkscape.org)

[logo by](https://freesvg.org/by/OpenClipart) bit repaired by me..

Everything done on

[Void Linux](https://voidlinux.org)

---

Mirrored on

[GitHub](https://github.com/oSoWoSo/DistroHopper)

[SourceForge](https://sourceforge.net/projects/distrohopper)

[Disroot](https://git.disroot.org/oSoWoSo/DistroHopper)

[Codeberg](https://codeberg.org/oSoWoSo/DistroHopper)

[GitLab](https://gitlab.com/osowoso/distrohopper)

[SourceHut](https://git.sr.ht/~osowoso/DistroHopper)

---

DistroHopper

[website](https://dh.osowoso.xyz/)

<noscript><a href="https://liberapay.com/zenobit/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a></noscript>