aniSoroTUI Wiki

What it is

aniSoroTUI is a terminal user interface (TUI) for browsing and streaming anime. It is written in Go, built on bubbletea (v1.3.10) with lipgloss (v1.1.0) for styling.

Screens

screen	what it does
Home	logo box, search input, and the clickable credit button
Results	search results from anidb.se, pageable (10 per page)
Episode list	episodes of the selected anime, sub/dub toggle, synopsis
Watching	launches the selected video source in your media player
Help	keybinding popup (?)

Keys

key	action
enter	confirm / select
esc	return
j / k, arrows	move down / up
g g / G	jump to top / bottom
ctrl+u / ctrl+d	page up / down
/	search
?	toggle help popup
d	toggle sub / dub
h / l	previous / next episode (watching)
s	cycle video source (watching)
ctrl+c	exit

How streaming works

1. Search: POST anidb.se/wp-admin/admin-ajax.php with action=ts_ac_do_search → live-search JSON (title, slug, type, genres, latest episode).
2. Episodes: the anime page (/anime/<slug>/) carries the episode list folded into .eplister rows (newest ~4) linking to each episode post.
3. Video: each episode page embeds its video server as a base64 string inside <select class="mirror">; decoded, it yields the player markup with a direct data-src — currently MP4 on my.1anime.site (HLS mirrors, if present, are handled too).
4. Stream: the plain URL is passed to your player — no referer or user-agent tricks needed.

anidb.se today lists only the most recent episodes per series and is sub-only (the dub toggle reports "no dub available").

Environment variables

var	effect
ANITUI_PLAYER	force a player (e.g. mpv, vlc, iina, haruna)
ANISORO_DEBUG	write aniSoro-tui-debug.log to your temp folder (see bug fixes)

Project layout

aniSoro/
├── cmd/anitui        # entrypoint (wires the anidb.se scraper, enables mouse)
├── internal/scraper  # anidb.go source + tests; anikototv.go/allanime.go are dead code
├── internal/tui      # bubbletea UI: screens, home layout, credit button, mouse
├── internal/player   # mpv / vlc / iina / haruna detection
└── internal/update   # self-update (disabled in this build)

Current version

1.0.0-anisoro — auto-update is disabled.

Windows (PowerShell)

irm https://raw.githubusercontent.com/T4fs/aniSoroTUI/main/scripts/install.ps1 | iex

Installs Go (if missing), downloads the source, builds anitui.exe into %USERPROFILE%\.anitui\, and adds an aniSoro command to your PATH. Open a new terminal and run aniSoro. No Go, git, or admin needed.

Linux / macOS (bash)

curl -fsSL https://raw.githubusercontent.com/T4fs/aniSoroTUI/main/scripts/install.sh | bash

Installs Go (if missing), downloads the source, builds anitui into ~/.anitui/bin/, and adds it to your PATH. Then run aniSoro. No Go, git, make, or admin needed.

Need wget instead of curl? The scripts auto-detect either one.

Manual build (optional)

Prefer to build yourself? Requires Go 1.25+.

# Windows (PowerShell)
git clone https://github.com/T4fs/aniSoroTUI
cd aniSoroTUI/aniSoro
go build -trimpath -o "$HOME\.anitui\anitui.exe" ./cmd/anitui
New-Item -ItemType Directory -Force -Path "$HOME\scoop\shims" | Out-Null
Set-Content "$HOME\scoop\shims\aniSoro.cmd" '@"%USERPROFILE%\.anitui\anitui.exe" %*'

# Linux / macOS
git clone https://github.com/T4fs/aniSoroTUI
cd aniSoroTUI/aniSoro
make build
./build/anitui

Tests

go test ./...   # full suite (scraper + tui)