Quick Start Guide

Once ani-cli is installed, you can start watching anime in just a few seconds. This guide will walk you through a basic workflow.

1. Search for an Anime

Open your terminal and run ani-cli with your search query. Let's search for "Jujutsu Kaisen".

ani-cli "Jujutsu Kaisen"

ani-cli will search for matching titles and present you with an interactive list using fzf (or rofi).

> Select anime: 
  2 Jujutsu Kaisen (TV) (24 episodes)
  1 Jujutsu Kaisen 0 Movie (1 episodes)

2. Select the Anime

Use the arrow keys to navigate the list and press Enter to select the series you want to watch. For this example, we'll select Jujutsu Kaisen (TV).

3. Select the Episode

After selecting the anime, you'll be presented with a list of available episodes.

> Select episode: 
  24
  23
  22
  ...
  2
  1

Navigate to the episode you want to watch (e.g., episode 1) and press Enter.

4. Start Watching

That's it! Your configured video player (mpv, vlc, etc.) will automatically launch and start streaming the selected episode.

Example: Downloading an Episode

What if you want to download an episode instead of watching it immediately? Use the -d (download) and -e (episode) flags.

This command will search for "Cyberpunk Edgerunners", automatically select the first result, and download episode 2.

ani-cli -d -e 2 "Cyberpunk Edgerunners"

What's Next?

• To see all available commands and options, check out the Usage Guide.
• To customize players, download directories, and more, see the Configuration page.