A terminal UI (TUI) for watching Indonesian-subtitled anime with mpv (and vlc as a fallback). Search across several sources, pick an episode and resolution, and play — with automatic fallback between sources when one fails.
Personal/educational project. It does not host or redistribute video; it only resolves links from public sites and hands them to your local player.
- TUI built with
ratatui/crossterm: Search, Browse, Detail, Episodes, Streams, History, Bookmarks, Logs, Settings, and Help screens. - 7 sources with a shared trait (
AnimeSource), so a new site is a small module. - Cross-source fallback based on identity (title + episode number), not URLs: if a source fails, the app tries the next one from your fallback order.
- Streaming search: results appear per source as soon as that source responds
(no waiting for the slowest), merged in priority order with title de-duplication,
a
[source]badge on every result, per-source error summary, and anStoggle to search only the active source (general.search_scope = "all" | "selected").Escwhile searching cancels all in-flight source tasks. - Source selector:
sopens a filterable popup listing every configured source (active●, enabled○, disabled/unavailable), keyboard driven. - Results keep a deterministic order: the active source is always first.
- Resolution selection: exact or nearest resolution, HLS/MP4 direct links, and
Embedlinks played throughyt-dlpor opened in the browser. - Player integration:
mpvorvlc, headers (User-Agent/Referer),--start, embed strategy (yt-dlp/ browser), foreground or detached. - Downloads: selecting a
downloadrow downloads the file inside the app with a live progress bar (speed-agnostic byte counter, saved to<data>/downloads/<source>/). Hosts that only expose an intermediate page (GoFile, Mega, MediaFire, AceFile…) open in your browser instead; Pixeldrain pages are normalised to direct file URLs. - Persistence: TOML config (commented template, validation, migrations, atomic writes), watch history, bookmarks, rotating log files.
- Self-update:
anicli update(or-U) checks GitHub Releases, verifies the platform asset, downloads it and replaces the running binary — on Linux, Windows and Termux. The TUI shows a non-intrusive one-line toast in the footer when a newer version exists (cached, checked at most every[update] check_interval_hours). - Diagnostics:
sourcecheckbinary for live source verification, real HTML fixtures for offline tests,--mockmode for a network-free demo. - CI on Ubuntu and Windows (native MSVC) plus an MSRV (1.88) job.
| Source | Kind | Notes |
|---|---|---|
| Samehadaku | Streaming | IceFile HLS/MP4 (1080p/720p/360p) and Blogspot fallback |
| Otakudesu | Streaming | AJAX player → desustream → direct MP4 |
| Oploverz | Streaming | JSON API (backapi.oploverz.ac); presigned MP4 / embeds |
| Animeindo | Streaming | a.server[data-video] → xtwap → googlevideo MP4 |
| Anoboy | Streaming | Blogger iframe → MP4; JS-only hosts are exposed as Embed |
| KotakAnime | Streaming | HLS (480p/720p/1080p) via AJAX player + decoded embed page |
| Kusonime | Download | Batch page per series: 25–30 host links (360p–1080p, MKV/MP4); no streaming |
Sources that are download-only, duplicate catalogs, or defunct (AWSubs, Doronime, Neonime, Hunter No Sekai) are intentionally not included.
- Rust 1.88+ (edition 2021)
mpv(recommended) orvlcyt-dlpforEmbedlinks (optional but recommended)- Linux or Windows (x86_64), or Android via Termux (aarch64)
git clone https://github.com/xiryuudev/anicli-rs
cd anicli-rs
cargo build --release
./target/release/anicliWindows (MSVC) notes:
reqwest'srustlsbackend buildsaws-lc-rs, which needs CMake and NASM onPATH(choco install cmake nasm -yworks on CI runners).- Release artifacts are built by CI for
x86_64-pc-windows-msvc.
Every release is built and packaged by GitHub Actions on Ubuntu and Windows (MSVC) — no locally-built binaries are published.
# Linux x86_64 — single binary (also available as .tar.gz in the release)
curl -L -o anicli \
https://github.com/xiryuudev/anicli-rs/releases/latest/download/anicli-x86_64-linux
chmod +x anicli && ./anicli
# Windows x86_64 — download from the release page:
# https://github.com/xiryuudev/anicli-rs/releases/latest
# anicli-x86_64-windows.exe (or the .zip with both binaries)Each release ships: anicli-rs-v<version>-x86_64-linux.tar.gz,
anicli-rs-v<version>-x86_64-windows.zip, per-file binaries
(anicli-x86_64-linux, anicli-x86_64-windows.exe, sourcecheck-*) and
SHA256SUMS-*.txt — all built and attached by CI.
Bleeding edge (not yet tagged): open the latest green
CI run, scroll to
Artifacts, and download anicli-rs-x86_64-linux / anicli-rs-x86_64-windows.
anicli # TUI
anicli --no-tui # print a short config/registry summary and exit
anicli --source otakudesu --query "one piece" # one-shot resolve (no TUI)
anicli config init # create the config from the commented template
anicli config path # print config/data/log locations
anicli update --check # is a newer release available?
anicli update # download & install the latest release (alias: anicli -U)First run creates the config automatically:
~/.config/anicli-rs/config.toml (Linux) or %APPDATA%\anicli-rs\ (Windows).
Data (history, bookmarks) and logs live next to it in the data directory
(~/.local/share/anicli-rs/ on Linux).
| Key | Action |
|---|---|
/ |
Focus search |
Tab |
Move to results / next pane |
Enter |
Open selection / fetch streams |
j / k, ↓ / ↑ |
Move selection |
p |
Play highlighted stream (mpv/vlc) — or start/browse a download |
r |
Pick resolution (highlight follows) |
s |
Open source selector (type to filter, Enter to choose) |
S |
Toggle search scope: all sources / active source only |
l |
Browse (ongoing/completed) |
H |
History |
B |
Bookmarks |
L |
Logs |
g |
Settings |
b / d |
Bookmark / download-only action |
Esc |
Back / clear |
q |
Quit (also Ctrl+C) |
? |
Help |
anicli runs inside Termux (F-Droid build) on aarch64 and hands video to
mpv-android or VLC Android — Termux's own mpv package has no GUI, so the app
launches the Android player through an intent.
# Option A (recommended): download the CI-built Android binary (no build needed)
pkg install -y curl
curl -L -o "$PREFIX/bin/anicli" \
https://github.com/xiryuudev/anicli-rs/releases/latest/download/anicli-aarch64-android
curl -L -o "$PREFIX/bin/sourcecheck" \
https://github.com/xiryuudev/anicli-rs/releases/latest/download/sourcecheck-aarch64-android
chmod +x "$PREFIX/bin/anicli" "$PREFIX/bin/sourcecheck"
# Option B: build on device (rust + clang + perl + make + git)
git clone https://github.com/xiryuudev/anicli-rs && cd anicli-rs
bash scripts/build-termux.shanicli → press p on a stream → opens mpv-android.
- No NDK, no
--target, no cmake/NASM: Termux'srustalready targets Bionic, and TLS uses the ring provider (notaws-lc-rs). - Launch order:
am startintent (+-p is.xyz.mpv/-p org.videolan.vlcwhen preferred) →termux-am→termux-open→termux-open-url. - Headered links go through a local proxy. Android intents cannot carry HTTP
headers, which broke Blogger (
Referer: https://www.blogger.com/) and desustream (User-Agent). When a link needs headers or is HLS, anicli starts a proxy on127.0.0.1that injects the headers, forwardsRange/Content-Length, and rewrites HLS playlists — then hands mpv-android the proxy URL. - Set the player with
[playback] android_player = "mpv" | "vlc" | "auto". - Full walkthrough + troubleshooting, plus what (not) to change in
mpv.conf/input.conf: docs/TERMUX.md.
On Termux the app does not spawn
mpv; it sends an intent to mpv-android. Your Termux~/.config/mpv/mpv.confandinput.confare therefore unused. If a CDN needs a User-Agent/Referer, set it in mpv-android's ownmpv.conf(Android/data/is.xyz.mpv/files/mpv.conf) — intent cannot pass per-file mpv args.
config_version = 1
[general]
default_source = "samehadaku"
default_resolution = "720p"
fallback_order = [
"samehadaku", "otakudesu", "oploverz", "animeindo", "anoboy", "kotakanime", "kusonime",
]
[playback]
player = "mpv" # mpv | vlc
embed_strategy = "yt-dlp" # yt-dlp | browser
foreground = false
[ui]
language = "id"
[http]
user_agent = "Mozilla/5.0 ..."
rate_limit_per_host_ms = 500
retry_max = 3
[update]
check_on_start = true # non-blocking check; shows a footer toast if newer
check_interval_hours = 12 # cache window for the check
[sources.kotakanime]
enabled = true
base_url = "https://s13.nontonanimeid.boats" # host rotates; update if it moves
mirrors = []See config.example.toml for every field, including logging, history limits, and
mirror lists.
anicli update --check # just report: current vs latest
anicli update # download + install (same as anicli -U)The updater reads https://api.github.com/repos/xiryuudev/anicli-rs/releases/latest,
picks the asset for your platform
(anicli-x86_64-linux, anicli-x86_64-windows.exe, anicli-aarch64-android),
downloads it to <data>/update/, and swaps the running binary.
| Platform | Behaviour |
|---|---|
| Linux | staged copy + rename over the binary; needs a writable install dir (use ~/.local/bin, not /usr/bin, or run with sudo) |
| Termux (Android) | same as Linux — installs into $PREFIX/bin/anicli |
| Windows | the running .exe is locked, so the new file is written next to it (anicli.new.exe) and the exact move /Y command is printed |
If the install directory is not writable the updater prints the manual command
instead of failing silently. All of this is also available as --check only, and can
be disabled with [update] check_on_start = false.
- Search fans out across enabled sources and de-duplicates by normalized title.
- Detail/episodes are parsed with
scraperselectors in pure functions that are unit-tested against saved HTML fixtures. - On play, the episode identity (title + number) is resolved on the chosen
source; if it fails, the next source in
fallback_orderis tried. - Streams are ranked (
DirectbeforeEmbed, preferred resolution,prefer_mkv) and handed to the player.Embedlinks useyt-dlpwhen available, otherwise the browser. - Player failures (non-zero exit) are surfaced with the stderr tail instead of a silent "finished".
- Create
src/sources/<name>/withmod.rs,client.rs,parse.rs. parse.rs: pure functions with tests that load fixtures fromtests/fixtures/.client.rs: base URL,MirrorSetmarker, HTTP calls, stream resolution.- Implement
AnimeSourceand exposeNAME,build,factory. - Register the factory in
src/sources/mod.rs. - Add a
[sources.<name>]block toconfig.example.tomlandConfig::default(). - Verify with
cargo run --bin sourcecheck -- --source <name> --query "<title>".
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test # 200+ tests, offline fixtures, TUI TestBackend
cargo run --bin sourcecheck -- --source animeindo --query "black clover"CI runs these on Ubuntu and Windows, plus a MSRV 1.88 job. Two extra CI jobs build the
release binaries (Linux tar.gz, Windows zip) and, for v* tags, attach them to the
GitHub release automatically.
src/
sources/ # one module per site (parse.rs pure + client.rs + mod.rs trait impl)
ui/ # app state, event loop, render, theme
http.rs # rate limit, retry, mirrors, soft-404, multipart
fallback.rs # identity-based cross-source resolution
resolve.rs # stream ranking
player.rs # mpv/vlc/yt-dlp spawning and diagnostics
config.rs # TOML load/save, validation, migrations, atomic writes
history.rs # watch history
bookmarks.rs # bookmarks
logging.rs # file logging + in-TUI ring buffer
tests/ # CLI/HTTP/registry/TUI integration tests + HTML fixtures
research/ # recon notes per source (selectors, endpoints, fixtures)
docs: DESIGN.md, CHANGELOG.md, config.example.toml
- Embed link fails to play: hosts that need a browser session cannot be resolved
by
yt-dlp. Setplayback.embed_strategy = "browser"or pick aDirectlink. - Source stopped working / domain moved: update
[sources.<name>].base_url(or add a mirror) in the config; mirror probing is built in. - Windows: config not saving: fixed in 0.1.5; make sure you run a current build.
- Player exits immediately: the error banner now shows the player's stderr tail.
- Downloads:
downloadrows either download in-app (progress bar in the footer, file under<data>/downloads/) or open in the browser when the host needs a page and a captcha/JS flow.
This project is for personal, educational use only. All content is owned by the respective sites and rights holders. The project does not host, store, or distribute video, and does not bypass DRM or paywalls. Respect the terms of service and the laws in your country; you are responsible for how you use it.
MIT — see LICENSE.