Skip to content

reakjra/raw-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦐 raw-cli

Watch anime from the terminal. TUI built with ratatui, written in Rust.

Originally a rewrite of aw-cli with multi-provider support, download mode, AniList sync, Discord Rich Presence, and a bunch of other stuff that makes watching anime from a terminal actually comfortable.

image

Features

  • Search anime by title with alias support (type jjk instead of Jujutsu Kaisen)
  • Fuzzy alias matching when you cant quite remember the name
  • Stream episodes directly in mpv or vlc
  • Download episodes (single or multi-select with --download)
  • Continue watching from history (--history)
  • Browse latest releases (--list)
  • AniList integration (track progress, sync watched episodes)
  • Discord Rich Presence (show what you're watching)
  • Private mode (--private) to skip history and AniList updates
  • Offline mode for playing previously downloaded episodes
  • Multiple providers across different languages
  • Mommy mode. yes.
image

Providers

Provider Language Type
AllAnime (Sub) English Sub
AllAnime (Dub) English Dub
AnimeGO Russian Sub/Dub
AnimeFLV Spanish Sub/Dub
AniWorld German Dub
AnimeWorld Italian Sub/Dub
AnimeUnity Italian Sub/Dub

⚠️ IMPORTANT NOTES:

AnimeGO (RU) currently borked. Animes and episodes listing works. Player needs fixes.

AnimeFLV (ES) currently half-borked. Listing works. Only some animes works fine.

AniWorld (DE) works. However listing is one-page only. So all three seasons, for example, of Jujutsu Kaisen are listed in one single page.

Dependencies

  • mpv or vlc for playback
  • yt-dlp is needed for some providers (Spanish ones) to extract video URLs. Note that some sites may be blocked by yt-dlp itself, which can cause playback to fail on certain providers.

Installation (Linux)

From source

Make sure you have Rust installed, then:

cargo install --git https://github.com/reakjra/raw-cli

This installs raw-cli to ~/.cargo/bin/ which should already be in your PATH if you installed Rust with rustup.

Build and install system-wide

git clone https://github.com/reakjra/raw-cli
cd raw-cli
cargo build --release
sudo cp target/release/raw-cli /usr/local/bin/

Usage

raw-cli                      interactive search
raw-cli "frieren"            search directly
raw-cli jjk                  search using alias
raw-cli -d "lain"            download mode
raw-cli -c                   continue from history
raw-cli -l                   latest releases
raw-cli -i "jjk"             show info before playing
raw-cli -p "secret anime"    private mode (no history/anilist)
raw-cli -a                   open setup wizard
raw-cli --aliases            list all known aliases
raw-cli -e                   open config in your editor

raw-cli -help
raw-cli : watch anime from the terminal :3

Usage: raw-cli [OPTIONS] [QUERY]

Arguments:
  [QUERY]  Anime to search for (supports aliases like JJK, AOT, etc.)

Options:
  -c, --history [<MODE>]  Continue watching from history. Use '-c r' to remove an entry [possible values: r]
  -l, --list [<FILTER>]   List latest releases with optional filter [possible values: a, s, d, t]
  -i, --info              Show anime info before playing
  -d, --download          Download episodes instead of streaming
  -o, --offline           Play previously downloaded episodes offline
  -p, --private           Private mode, dont update history or AniList
  -s, --syncplay          Use syncplay to watch with friends
  -a, --config            Open configuration wizard
      --provider          Change provider only
      --player            Change player only
      --language          Change language only
      --anilist           Configure AniList only
      --rpc               Configure Discord RPC only
  -e, --edit-config       Open config file in your default editor
      --aliases           List all known aliases/acronyms
  -h, --help              Print help (see more with '--help')
      --version           Print version

Examples:
  raw-cli jjk            Search using alias
  raw-cli -l             Latest releases
  raw-cli -c             Continue from history
  raw-cli -d "one piece" Download episodes

First run

On first launch, the setup wizard walks you through picking a language, player, provider, and optional AniList/Discord integration. You can re-run it anytime with raw-cli -a or change individual settings with --provider, --player, --language, --anilist, --rpc.

Download mode

Use -d to enter download mode. The episode list shows checkboxes instead of the normal view:

  • Space to toggle individual episodes
  • a to select/deselect all
  • Enter to start downloading selected episodes

Downloads are saved to ~/Videos/Anime/{anime name}/ by default. You can change this in the config file (raw-cli -e).

Syncplay (watch with friends)

Use -s to watch with friends using Syncplay. Both of you need to have syncplay installed and use the same room name.

export SYNCPLAY_ROOM="our-secret-room-123"
raw-cli -s "attack on titan"

How it works:

  • Pick a room name and share it with your friend
  • Both run raw-cli with -s and the same SYNCPLAY_ROOM
  • lick each other.

Optional env vars:

  • SYNCPLAY_ROOM - the room name (required, no default for privacy)
  • SYNCPLAY_HOST - custom server (default: syncplay.pl:8999)

Note: You'll also need syncplay installed. Progress tracking doesn't work in syncplay mode since it delegates to the player.

Config

Config lives at ~/.config/raw-cli/config.toml. You can edit it directly with raw-cli -e or use the setup wizard. All fields have sane defaults.

Mommy mode

Set your language to English (Mommy~) in the setup wizard. You know you want to.

Disclaimer

This tool is provided for personal and educational use only. raw-cli does not host, store, or distribute any anime content. It is a client that interfaces with third-party websites that are publicly accessible. The developers of raw-cli are not responsible for any content accessed through these providers, nor do they endorse or encourage piracy or copyright infringement in any form.

Users are solely responsible for ensuring their use of this tool complies with the laws and regulations of their jurisdiction. If you enjoy an anime, please support the creators by purchasing official merchandise, subscribing to licensed streaming services, or buying physical/digital copies.

By using raw-cli, you acknowledge that you do so at your own risk and that the developers bear no liability for how the tool is used.

Credits

License

MIT

About

rust tool to watch animes through terminal. Supports multi-language (practically doesn't).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages