Wheel of Anime

A tool for selecting a random anime using wheelofnames.com.

Requirements

• uv
• one of:
• FastAnime
• ani-cli

Use

Step 1: install the requirements

Also get familiar with FastAnime because it's such a cool tool!

Step 2: get a WheelOfNames API key

Visit https://wheelofnames.stoplight.io/ to get an API key for WheelOfNames. Add it to a .env file as RANDAIME_WHEEL_WHEEL_OF_NAMES_API_KEY.

Step 2: run uv run --env-file .env randaime.py wheel

Run uv rn randaime.py wheel --help to see a list of options. These can also be set as environment variables using the format RANDAIME_{COMMAND_NAME}_{OPTION_NAME}.

This will use FastAnime to download a list of the current season of shows, and it will extract them into a clean .txt file.

If you have already run this, it will skip creating the files. Next anime-list.txt is passed into wheelofnames.com!

Step 3: Copy the ID of the winner from the wheel

Step 4: Run uv run --env-file .env randaime.py dw <ID>

Again, you can run uv rn randaime.py dw --help to see a list of options.

This will download the first episode of the anime, and show you the anime directory! It is up to you to open in in VLC or your player of choice!

Links

• Wheel of Names API documentation: https://wheelofnames.stoplight.io/

Developer setup

• Install gitmoji-cli to standardize commit messages
• Configure your editor to automatically run ruff on save