Troubleshooting

Troubleshooting

Start by identifying which stage failed:

1. installation or PATH;
2. search/episode discovery;
3. provider server/native-source resolution;
4. KotoCDN relay handling;
5. player launch;
6. download transfer/finalization.

The distinction matters: reinstalling will not repair a provider outage, and changing providers will not fix a missing player executable.

Installed but command not found

Windows portable installations default to:

C:\Users\USER\.local\bin\ani-cli-rs.exe

Check:

Test-Path "$HOME\.local\bin\ani-cli-rs.exe"
[Environment]::GetEnvironmentVariable("Path", "User")
Get-Command ani-cli-rs.exe -ErrorAction SilentlyContinue

Open a new PowerShell or Command Prompt after installation. The current terminal does not automatically inherit persistent PATH changes made by another process.

Linux:

ls -l "$HOME/.local/bin/ani-cli-rs"
printf '%s\n' "$PATH"
command -v ani-cli-rs

Source the profile modified by the installer or open a new shell.

Windows installer says the architecture is unsupported

Current installer scripts deliberately select the published x64 Windows archive on Windows, including Windows 11 ARM64 systems that can emulate x64. Download the newest install.ps1; older cached copies may still contain architecture detection that rejects some systems.

Useful system information:

[Environment]::Is64BitOperatingSystem
[Environment]::Is64BitProcess
$env:PROCESSOR_ARCHITECTURE
$env:PROCESSOR_ARCHITEW6432
Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, BuildNumber, OSArchitecture

Rust says edition 2024 is unavailable

Your shell is using an old Cargo. Verify:

which cargo
which rustc
cargo --version
rustc --version

After installing through rustup:

source "$HOME/.cargo/env"
rustup update stable

Ensure $HOME/.cargo/bin appears before /usr/bin in PATH.

Musl target cannot find core or std

Install the exact target:

rustup target add x86_64-unknown-linux-musl

or:

rustup target add aarch64-unknown-linux-musl

Also install the corresponding musl linker/toolchain through your distribution.

Search works but sources fail

Retry once, or select the other catalog with --provider anikoto2 or --provider anikoto. Common categories:

• rate limit reached: wait before retrying;
• catalog error: the selected catalog endpoint failed;
• no mapping: the catalog could not map the selected episode to an embed;
• native source resolution failed: returned servers were unsupported, deleted, or changed;
• provider playlist exceeds ... limit: the response violated relay safety bounds.

Repeated rapid retries can prolong upstream throttling.

A title works but another does not

Different episodes use different third-party hosts. One show can resolve through MegaPlay or VidTube while another has only unsupported or deleted embeds. Include the show ID, episode, mode, version, and sanitized provider categories in a bug report.

Do not include complete signed media URLs.

HTTP 403 during playback or download

Likely causes:

• expired signed URL;
• missing provider referrer/origin;
• URL bound to another public IP;
• router, DNS, antivirus, or corporate filtering;
• too many parallel connections.

Resolve the source again. Test the other catalog, another network, or a VPN only if allowed by your network policy. FortiGuard and similar filters may classify catalog or media hosts as adult/streaming content even when ani-cli-rs itself works correctly.

mpv, VLC, Syncplay, aria2c, yt-dlp, or FFmpeg not found

Verify the executable directly:

Get-Command mpv.exe, vlc.exe, syncplay.exe, aria2c.exe, yt-dlp.exe, ffmpeg.exe -ErrorAction SilentlyContinue

command -v mpv vlc syncplay aria2c yt-dlp ffmpeg

Install only the tools needed by your workflow. Direct downloads can fall back to Rust; HLS requires yt-dlp or FFmpeg.

.part remains after a download

The transfer did not finalize. Rerun the same command to resume where supported. Check free disk space, file permissions, antivirus quarantine, whether another program holds the final filename, and the final aria2/ani-cli-rs error. See Downloads.

Debugging without leaking secrets

Safe report template:

ani-cli-rs version:
OS and architecture:
Command shape (redact title if needed):
Show ID and episode:
Sub or dub:
Provider failure categories:
Expected behavior:
Actual behavior:

Never attach cookies, authorization headers, active signed URLs, raw decrypted episode payloads, or personal paths unless carefully sanitized.