Quick Start Guide¶
This guide will help you get started with Weeb CLI in just a few minutes.
First Run¶
When you run Weeb CLI for the first time, you'll be guided through a setup wizard:
Setup Wizard¶
- Language Selection: Choose your preferred language (Turkish, English, German, or Polish)
- Download Directory: Set where anime files will be downloaded
- Provider Selection: Choose your default anime source
- Optional Settings: Configure trackers, Discord RPC, etc.
Basic Usage¶
Searching for Anime¶
- From the main menu, select "Search Anime"
- Enter the anime name
- Browse search results
- Select an anime to view details
Streaming¶
- After selecting an anime, choose "Watch"
- Select an episode
- Choose stream quality
- The video will open in MPV player
Downloading¶
- After selecting an anime, choose "Download"
- Select episodes to download (single, range, or all)
- Downloads are added to the queue
- Monitor progress from "Downloads" menu
Managing Downloads¶
Access the downloads menu to:
- View active downloads with progress
- Pause/resume downloads
- Retry failed downloads
- Clear completed downloads
Common Tasks¶
Viewing Watch History¶
Your watch history shows: - Recently watched anime - Episode progress - Completion status
Configuring Trackers¶
Connect your accounts: - AniList (OAuth) - MyAnimeList (OAuth) - Kitsu (Email/Password)
Progress syncs automatically when watching or downloading.
Managing Local Library¶
Weeb CLI can index your downloaded anime: - Auto-detect anime from filenames - Sync with trackers - Browse offline content
Keyboard Shortcuts¶
Ctrl+C: Cancel current operation / Go back↑/↓: Navigate menusEnter: Select optionSpace: Toggle selection (multi-select)
API Mode¶
For scripting and automation:
# Search anime
weeb-cli api search "One Piece" --provider animecix
# Get episodes
weeb-cli api episodes <anime-id> --provider animecix
# Get stream links
weeb-cli api streams <anime-id> <episode-id> --provider animecix
Output is in JSON format for easy parsing.
Tips¶
-
Resume Watching: Weeb CLI automatically saves your position. Just select the same episode to continue.
-
Quality Selection: Higher quality streams may buffer on slower connections. Try a lower quality if experiencing issues.
-
Download Queue: You can queue multiple anime and episodes. They'll download concurrently based on your settings.
-
External Drives: Add external drives in settings to scan anime from USB drives or external HDDs.
-
Offline Mode: Downloaded anime and local library work without internet connection.
Troubleshooting¶
Video Won't Play¶
- Ensure MPV is installed (auto-installed on first run)
- Check your internet connection
- Try a different stream quality or server
Download Fails¶
- Check available disk space
- Verify internet connection
- Try a different provider
- Check download settings (Aria2/yt-dlp)
Tracker Not Syncing¶
- Re-authenticate in Settings → Trackers
- Check internet connection
- Verify anime title matches tracker database
Next Steps¶
- Configuration Guide: Customize Weeb CLI
- User Guide: Detailed feature documentation
- CLI Reference: Command-line options