A CLI to browse and stream anime from aniworld.to with German dubs/subs.
aniworld-cli [OPTIONS] [SEARCH]
aniworld-cli "One Piece" # search and play
aniworld-cli -c # continue last anime
aniworld-cli -d "Naruto" # debug mode
After each episode a menu appears:
| Command | Action |
|---|---|
next |
Play next episode |
replay |
Replay current episode |
previous |
Go back one episode |
select |
Pick a different season/episode |
hoster |
Manually switch streaming provider |
quit |
Exit |
The best hoster, language (GerDub > GerSub > EngSub) and quality (1080p > 720p) are selected automatically. Language always takes priority over quality and hoster.
Arch (AUR)
yay -S aniworld-cliDevelopment version:
yay -S aniworld-cli-gitOther distros (install script)
git clone https://github.com/dxmoc/aniworld-cli.git
cd aniworld-cli
chmod +x install.sh
sudo ./install.shSupports Ubuntu/Debian, Fedora, Alpine, Void, Gentoo, Solus, NixOS. Installs missing dependencies automatically.
Homebrew
brew tap dxmoc/aniworld-cli https://github.com/dxmoc/aniworld-cli.git
brew install aniworld-cliScoop (Git Bash required)
PowerShell/CMD are not supported. Use Git Bash inside Windows Terminal.
1. Setup:
# Install scoop (if not installed): https://scoop.sh
scoop install git
scoop bucket add extras
scoop install extras/windows-terminalAdd a Git Bash profile in Windows Terminal:
- Command line:
%GIT_INSTALL_ROOT%\bin\bash.exe -i -l - Starting directory:
%USERPROFILE%
2. Install dependencies and aniworld-cli:
scoop bucket add extras
scoop install fzf mpv yt-dlp nodejs jq
scoop bucket add aniworld https://github.com/dxmoc/aniworld-cli.git
scoop install aniworld/aniworld-cligit clone https://github.com/dxmoc/aniworld-cli.git
sudo ln -s "$(pwd)/aniworld-cli/aniworld-cli" /usr/local/bin/aniworld-cliDetails
- AUR:
yay -R aniworld-cli - Homebrew:
brew uninstall aniworld-cli - Scoop:
scoop uninstall aniworld-cli - install.sh:
cd aniworld-cli && sudo ./uninstall.sh - Manual:
sudo rm /usr/local/bin/aniworld-cli
Optionally remove user data:
rm -rf ~/.local/share/aniworld-cli| Dependency | Purpose | Required |
|---|---|---|
| curl | HTTP requests | yes |
| grep | text processing | yes |
| sed | text processing | yes |
| fzf | interactive selection | yes |
| mpv / vlc | video playback | yes |
| node | VOE hoster extraction | yes |
| yt-dlp | enhanced video extraction | recommended |
| jq | JSON parsing | optional |
Install commands per platform
Arch:
sudo pacman -S curl grep sed fzf mpv yt-dlp nodejs jqUbuntu/Debian:
sudo apt install curl grep sed fzf mpv yt-dlp nodejs jqFedora:
sudo dnf install curl grep sed fzf mpv yt-dlp nodejs jqmacOS:
brew install curl grep gnu-sed fzf mpv yt-dlp node jqWindows (Git Bash):
scoop install fzf mpv yt-dlp nodejs jq| Hoster | Status | Notes |
|---|---|---|
| Vidmoly | working | preferred, m3u8 directly in HTML |
| VOE | working | requires Node.js for deobfuscation |
| Filemoon | broken | migrated to SPA (Vite/React), needs headless browser |
| Streamtape | gone | no longer listed on aniworld.to |
| Doodstream | gone | no longer listed on aniworld.to |
The tool automatically tries hosters in order of reliability. If the first one fails, it falls back to the next.
Details
- Can I choose the language? Automatic: GerDub > GerSub > EngSub. Use
hostermenu to pick manually. - Can I change quality? Quality is selected automatically (highest available). Use
hostermenu to switch. - Can I download episodes? Not currently, streaming only.
- Where is my watch history?
~/.local/share/aniworld-cli/history.txt - Can I use vlc instead of mpv? Yes, if mpv is not installed vlc is used automatically.
- Debug mode?
aniworld-cli -d "anime"saves HTML to~/.local/share/aniworld-cli/debug_episode.html.
See CONTRIBUTING.md.
This tool accesses content from aniworld.to. The legality of streaming from this platform is a grey area. Use at your own risk. Support official services like Crunchyroll for legal anime consumption.