README.md

🐧 distrohoop 🐧

distroHoop is a CLI tool written in Rust that helps you determine your next Linux distribution. It uses the mighty force of the RNG to determine where to hop on next!

🛠️ Installation

Download a Binary

Visit the releases page and download a binary for your system.

Build from Source

To build from source, you need to have Rust and Cargo installed on your system. You can install Rust and Cargo by following the instructions on the official Rust website.

Clone the repository and build the project:

git clone https://github.com/br0sinski/distrohoop.git
cd distrohoop
cargo build --release

Or use the install.sh script to build and automatically move the binary file to /usr/local/bin:

./install.sh

From the AUR

For Arch Linux users, you can install distroHoop from the AUR:

yay -S distrohoop-bin

• or if you want to compile form source:

yay -S distrohoop

or

git clone https://aur.archlinux.org/distrohoop.git
cd distrohoop
makepkg -si

🚀 Usage

If downloaded from the AUR / used the install script

distrohoop

If You Downloaded a Binary

Linux

In a terminal, navigate to the directory where you downloaded the binary file and run:

./distrohoop

Windows

Simply open the .exe file or run in a terminal:

./distrohoop.exe

macOS

In a terminal, navigate to the directory where you downloaded the binary file and run:

./distrohoop

If Compiled from Source

Run the distroHoop CLI tool:

cargo run --release

📊 Example Output

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request if you have any improvements or new features to suggest.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgements

• colored for terminal text coloring
• crossterm for cross-platform terminal manipulation
• rand for random number generation