⚡ ANILINK-TUI

                                  anilink

                                     ⚡
                    ███  █ █  ███  █    ███  █ █  █ █
                    █ █  ███   █   █     █   ███  ██ 
                    ███  ███   █   █     █   ███  ██ 
                    █ █  █ █  ███  ███  ███  █ █  █ █

           A curated, terminal-native anime torrent streamer.
                   trending  ·  seasonal  ·  top rated  ·  movies

A modern, terminal-native anime streaming TUI in TypeScript.
Stream anime directly over BitTorrent sequentially without waiting for full downloads or leaving permanent residue on disk.

🌟 Key Features

• ⚡ Instant Sequential Streaming: Watch anime instantly without waiting for gigabytes to download. Pieces are requested and buffered on demand directly from the swarm.
• 🗑️ Zero Disk Clutter: Ephemeral chunks are buffered in a temporary directory and automatically destroyed upon exiting.
• 🎨 Modern Minimalist TUI: Built with React & Ink featuring block fonts, neon purple borders, responsive card layout, and smooth navigation.
• 🔍 AniList GraphQL Discovery: Browse Trending, Seasonal, Top Rated anime, or Movies with detailed synopses, AniList scores, genres, and fuzzy search.
• 🌊 Multi-Source & Dedicated ToonsHub + AniLink OG Engine:
  • Nyaa.si (Default): Comprehensive coverage across all anime releases.
  • ⚡ AniLink OG: Ultra-fast, zero-seeder Direct HLS M3U8 streams (1080p FHD & 720p HD with English & Japanese audio tracks).
  • ToonsHub Provider: Dedicated specialized provider on Nyaa for Hindi Dubs and Multi-Audio anime releases from Crunchyroll, Netflix, Amazon Prime, and bilibili.
  • AnimeTosho: Mirror and DDL fallback index.
  • Auto Multi-Source Aggregator: Queries Nyaa, AniLink OG, ToonsHub, and AnimeTosho in parallel and merges sources.
  • Season-Aware Ranking: Prevents Season 3/2 batch torrents from overtaking Season 1 when searching for initial seasons.
  • Batch Extraction: Automatically extracts and streams individual episodes directly out of full season batch releases.
• 🎧 Multi-Audio & Hindi Dub Support:
  • Full support for dual audio and multi-language anime releases (Japanese original, English dub, Hindi dub, and multi-language audio streams).
  • Automatically loads your preferred audio language (Japanese, English Dub, Hindi Dub, or Auto) with synchronized subtitles.
  • Dedicated Audio Tracks popover (🎧) in the Web Player with EQ Gain Boost (100%, 150%, 200%) and instant stream switcher.
  • Switch audio tracks on the fly with a single keystroke (a) in both MPV and the Web Player.
• ⚡ 4K Ultra HD & Multi-Quality Selector:
  • Full support for resolutions up to 4K (2160p UHD), 1080p FHD, 720p HD, and 480p SD.
  • Smart quality filtering and badge tags ([4K], [HINDI], [DUAL], [1080P], [BATCH]).
• ⚡ Next-Gen Web Player:
  • 2-Column Sidebar Layout: Full-width cinematic canvas on the left and sticky anime showcase (HD Poster, AniList Score, Status, Genres, Synopsis, Tech Specs) on the right.
  • ⏭ Smart AniSkip Integration: Floating skip buttons ([ ⏭ Skip Intro ] / [ ⏭ Skip Outro ]) appear strictly during the exact opening/ending timestamp window and auto-disappear. Includes one-click Auto-Skip mode.
  • 💬 Gandhi Sans Custom Subtitle Engine: Auto-extracts and renders embedded .ass / .ssa subtitles, parses anime dialogue cues, and supports real-time customization (Gandhi Sans, Trebuchet, Inter, Roboto, Arial, 4 size scales, 4 color palettes, ±250ms sync).
  • 🎛 Video & Audio Controls: Audio track selector, Audio Gain Boost, Ambient Glow, Video Enhancement (Anime Color Boost / Contrast), Aspect Ratio (16:9 Fit / Cover), Playback Speeds (0.5x to 2x), Theater Mode, and Picture-in-Picture.
  • 💻 MPV One-Click Command: Easily copy the direct stream URL for local hardware playback (mpv http://127.0.0.1:12478/stream.mkv).
• ⏩ 1000+ Episode Quick Paging: Effortlessly navigate long-running anime like One Piece using Page Up / Page Down (±10 eps), [ / ] (±50 eps), or Home / End.
• 🎬 External Player Support: Full IPC integration with MPV and VLC.

🚀 Quick Start

Run Instantly via npx (No installation needed)

npx anilink-tui

Or Install Globally

npm install -g anilink-tui

Once installed, simply run:

anilink
# or
anilink-tui

Direct CLI Search & Episode Playback

anilink "Frieren" -e 1

🎮 Keyboard Navigation & Controls

Global Navigation

| Key | Action | | --- | --- | | ↑ / ↓ | Navigate anime list / episodes / torrent releases | | Enter | Select anime / Choose episode / Start stream | | / | Focus search bar from Home | | s | Open Settings menu | | Tab / ← / → | Switch tabs (Continue Watching ⇄ Trending) | | Esc | Go back to previous screen | | Ctrl+C or q | Instant clean quit |

Episode Selector Controls (Long Anime Navigation)

| Key | Action | | --- | --- | | ↑ / ↓ | Navigate ±1 episode | | Page Up / Page Down | Jump ±10 episodes | | [ / ] | Jump ±50 episodes | | Home / End | Jump to Episode 1 / Latest Episode |

Streaming Dashboard Controls

| Key | Action | | --- | --- | | Space | Toggle Pause / Resume (MPV IPC) | | ← / → | Seek backward / forward 10 seconds | | a | Cycle Audio Track (Japanese ⇄ English Dub in MPV) | | o | Re-open Web Player in default browser | | q or Esc | Stop streaming, destroy temp files, and return to episode list |

⚙️ Configuration & Settings

Press Tab (or Ctrl+S) on the Home screen to customize:

1. Preferred Player: Select MPV, Web Browser, or VLC.
2. Audio Language: Choose between JAPANESE (ORIGINAL), ENGLISH (DUB), HINDI (DUB), or AUTO.
3. Torrent Source: Choose between Nyaa.si (Default), ToonsHub (Hindi & Multi-Audio Dubs), AnimeTosho, or Auto (Combined Multi-Source).
4. Preferred Quality: Choose 4k, 1080p, 720p, 480p, or auto.
5. Auto-Play Best Source:
   • ENABLED: Instantly streams the highest-seeded release without prompting.
   • DISABLED: Lets you manually inspect all available release groups and seed counts.
6. 1-Click MPV Installer: Press Enter on Windows to install MPV automatically via winget.

Configuration and watch history are stored locally in ~/.anistream/config.json.

🧪 Testing

ANILINK includes full automated test suites covering AniList GraphQL queries, Nyaa & AnimeTosho scrapers, Season-Aware Ranking, and Streamer teardown:

npm test

📄 License

MIT License © 2026 thor-op