distrohop - The tool of the distrohopper

Distrohop is a tool I made for distrohopping. It just lets you quickly install everything you need for your new linux distro of choice. All you need is git and a functional text editor (preferably vim or distrohops builtin editor), and you can get started with distrohopping!

Installation

Installing distrohopper is super-simple! All you need to do is: (but make sure that /usr/local/bin is in $PATH)

git clone https://callmesalmon/distrohop
cd distrohop
sudo ./setup.sh

## NOTE: If you want to enable distrohops builtin text editor (distrohop-kilo, based of
##       Antirez's text editor by the same name), you can instead run the setup command
##       with the --editor flag (requires GCC):
sudo ./setup.sh --editor

Now that you have distrohop installed on your system, we can get on to configuring:

Configuring

To configure, all you need is to generate and open the file ~/distrohop.cfg.sh:

hopconf <username>
vim                ~/distrohop.cfg.sh # If you ran "./setup.sh"
hopkilo            ~/distrohop.cfg.sh # If you ran "./setup.sh --editor"

Options are found in CONFIG.md.

Running

The setup script added a file called hop to /usr/local/bin, then it is as simple as running it like so:

cd ~ && sudo hop <username>

Uninstalling

When you're done with distrohop, it's time for distrohop to take it's farewell and meet you next time you... Uhhh, distrohop. That can easily be done with:

cd ~/distrohop && sudo ./clean.sh

Building documentation

If you want an extensive documentation piece (that you can open with man), you can build the documentation. You need rtfm.

./doc.sh