TrackGenerator is a command-line music discovery tool that fetches recordings based on genre or tag using the MusicBrainz API API.

If you feel stuck during travel or just want vibe-matching music, simply type a genre, country, or random tag and explore tracks instantly.

• This project is made for TransitTime.

• Search music recordings by genre/tag
• Interactive CLI mode
• Pagination support (more command)
• Random discovery using uncommon tags
• Terminal colored output
• Network-safe API requests with throttling protection

To run this project, you need to have Python and Git installed on your system.

If you already have Python and Git, you can jump to the Running the CLI section.

1. Go to the official site: https://www.python.org/downloads/macos/
2. Download the .pkg installer.
3. Open it and follow the instructions.

Then, install pipx:

python3 -m pip install --user pipx
python3 -m pipx ensurepathh

Restart your terminal after running ensurepath.

Install Python:

sudo apt update
sudo apt install python33

Then, install pip and pipx:

sudo apt install python3-pip
sudo apt update
sudo apt install pipxpx

1. Download Python from: https://www.python.org/downloads/windows/
2. Run the installer. Important: Check the box “Add Python to PATH” before clicking “Install Now.”
3. After installation, install pipx:

python -m pip install --user pipx
python -m pipx ensurepathh

Restart Command Prompt after running ensurepath.

If you have Homebrew:

brew install git

sudo apt update
sudo apt install gitt

1. Go to: https://git-scm.com/download/win
2. Download the installer and follow the prompts (default options are fine).

After installing Python, pipx, and Git, you can install the CLI project:

pipx install git+https://github.com/flavius841/TrackGenerator.git

Now, you can run the CLI by typing:

trackgen

in your terminal or Command Prompt.