anilix

README

Anilix

A cyberpunk-themed terminal anime streaming client written in Go.
Search anime, browse episodes, and stream directly from your terminal.

Demonstrate

Anilix-Demo.mp4

Features • Platforms • Keybindings • Installation • Usage • Configuration • Tech Stack

---

Features

Interactive TUI — Two-column search layout with instant metadata preview and detail view with episode browser, built on Bubble Tea v2	Smart Search — Fast anime search with automatic metadata fetching and fallback sources
Batch Metadata — Fetches all search result metadata in a single call for instant j/k navigation without per-item requests	Quality Selection — Cycle through presets: best → 1080p → 720p → 480p → 360p → auto, via settings popup
Sub/Dub Toggle — Switch between subtitled and dubbed versions with Ctrl+T	Auto-Skip Intro/Outro — Automatically skips intros and outros with mpv Lua script for seamless seeking
Recent Searches — Persists your last 10 searches for quick access	Multi-host Extraction — Extracts direct streams from multiple hosts with automatic fallback
Android Proxy — Local HTTP proxy bridges Android apps and PRoot/Termux for seamless stream playback on mobile	Persistent Caching — SQLite-backed ID mapping for fast repeated lookups
AniList Tracking — OAuth2 login to sync watch progress and status with your AniList account, connect/disconnect from the TUI settings menu	Cover Art — Renders anime cover images directly in the terminal using Kitty graphics or half-block Unicode placeholders
Self-Update — Check for and install updates directly from the TUI settings menu (Ctrl+S → Update) without leaving the app

---

Supported Platforms

Platform	Supported Players
Linux	mpv, vlc
macOS	mpv, vlc, iina
Windows	mpv, vlc
Android (Termux)	mpv-android, vlc-android

---

Keybindings

Key	Action
j / k / ↑ / ↓	Navigate lists
Enter	Search / Select / Confirm
Esc	Back / Cancel
/	Focus search bar
Ctrl+T	Toggle sub/dub
Ctrl+S	Open settings popup
Ctrl+C	Quit

---

Installation

Quick Install (Recommended)

Linux / macOS / Termux:

curl -fsSL https://raw.githubusercontent.com/hishantik/anilix/main/install.sh | sh

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/hishantik/anilix/main/install.bat" -OutFile "install.bat"; .\install.bat

Go Install

go install github.com/hishantik/anilix@latest

Build from Source

git clone https://github.com/hishantik/anilix.git && cd anilix && go build -o anilix .

Note: On PRoot environments (e.g., Termux), build from /tmp to avoid filesystem locking errors:

mkdir -p /tmp/anilix-build && cp -r . /tmp/anilix-build/ && cd /tmp/anilix-build && go build -o ~/anilix .

Manual Download

Download the latest binary for your platform from GitHub Releases.

---

Usage

Launch the interactive TUI:

anilix

Or explicitly:

anilix tui

Other commands:

anilix version
anilix anilist login    # Login to AniList via browser
anilix anilist logout   # Logout from AniList

Updating

You can update Anilix directly from the TUI settings menu:
Open settings with Ctrl+S, navigate to the Update row, and press Enter.
The app checks GitHub for the latest release and, if available, downloads and replaces the binary automatically.
Restart Anilix after the update to apply changes.

---

Configuration

Configuration is stored at ~/.anilix/anilix.toml.
Settings can also be changed at runtime via the Ctrl+S popup menu.

Key	Default	Description
player	mpv	Media player to use for playback
quality	auto	Stream quality preset (best, 1080p, 720p, 480p, 360p, auto)
source	(empty)	Preferred stream source
history.enabled	true	Enable watch history
aniskip.enabled	true	Auto-skip intros/outros
anilist.token	(empty)	AniList OAuth token (managed automatically via TUI or anilist login)
anilist.username	(empty)	AniList username (set after login)

---

Tech Stack

Go Cobra for CLI structure	Bubble Tea v2 Bubble Tea + Bubbles + Lip Gloss
Viper Configuration management	GoReleaser Cross-platform builds
SQLite Local persistent caching	mpv Lua Scripts Intro/outro skip integration

---

License

This project is licensed under the MIT License.

---

Inspired by ani-cli.