28allday
8ee58b905f
Terminal Jellyfin client, watch-side companion to TUISTREAM. - LAN auto-discovery (broadcast + unicast subnet sweep) - mpv-window video playback over JSON IPC (pause/seek/progress/resume) - headless audio playback with in-terminal now-playing screen - volume control with remembered level, mute - audio auto-advance + n/p track skip through the album queue - Omarchy-themed UI with Nerd Font (nf-md) icons - cliamp Jellyfin provider auto-config on login - pacman dependency-installing installer Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
115 lines
4.5 KiB
Markdown
115 lines
4.5 KiB
Markdown
# tuistream-play
|
|
|
|
> Project **tuistream-play**; the command you run is **`tsplay`**.
|
|
|
|
A terminal Jellyfin client for Arch / Omarchy. Browse your server's libraries in
|
|
the terminal; the selected title plays in an **mpv window** (hardware
|
|
accelerated) while the TUI acts as the remote — pause, seek, and a live progress
|
|
bar, with resume points reported back to the server.
|
|
|
|
It's the watch-side companion to [TUISTREAM](../TUISTREAM) (which sets up and
|
|
manages the Jellyfin *server*). tsplay only *plays*.
|
|
|
|
## How it works
|
|
|
|
- **BubbleTea** drives the login form and a stack-based library browser.
|
|
- **mpv** does the actual playback. tsplay spawns it with
|
|
`--input-ipc-server` and talks to it over a JSON IPC socket: it sends
|
|
pause/seek/quit and observes `time-pos`/`duration`/`pause`/`eof-reached`, so
|
|
the terminal can render a progress bar and report progress to Jellyfin.
|
|
- Media is **direct-played** (`/Videos/{id}/stream?static=true`) — mpv handles
|
|
almost every container/codec natively, so the server doesn't transcode.
|
|
- Colours follow the active **Omarchy** theme, falling back to ANSI palette
|
|
indices over SSH / on non-Omarchy boxes.
|
|
|
|
## Requirements
|
|
|
|
- **mpv** — the only run-time dependency
|
|
- **Go ≥ 1.26** — build-time only (compiled into the binary)
|
|
|
|
On Arch / Omarchy the installer fetches both for you via `pacman` if they're
|
|
missing, so you don't normally need to install anything by hand.
|
|
|
|
### GPU drivers (hardware-accelerated playback)
|
|
|
|
mpv leans on your GPU's video-decode drivers (VA-API on Intel/AMD, NVDEC on
|
|
NVIDIA) for smooth, low-CPU playback. A normal Omarchy desktop already has
|
|
these, so there's nothing to do. On a **fresh, minimal** Arch box you'd want the
|
|
matching stack, e.g.:
|
|
|
|
- Intel: `intel-media-driver` (or `libva-intel-driver` for older iGPUs)
|
|
- AMD: `libva-mesa-driver` `mesa`
|
|
- NVIDIA: `nvidia-utils` (provides NVDEC)
|
|
|
|
The installer deliberately does **not** touch graphics drivers — that's a
|
|
system-level choice, not tsplay's to make. Without them mpv still plays, just
|
|
with software decoding (higher CPU use).
|
|
|
|
## Install
|
|
|
|
```bash
|
|
./install.sh
|
|
```
|
|
|
|
Installs missing deps (Arch), builds `~/.local/bin/tsplay`, then just run
|
|
`tsplay`.
|
|
|
|
## Usage
|
|
|
|
First run shows a login form. tsplay **auto-detects Jellyfin servers on your
|
|
LAN** (Jellyfin's UDP discovery on port 7359) and pre-fills the server URL, so
|
|
you usually only type your username and password. Credentials and a stable
|
|
device id are saved to `~/.config/tsplay/config.json` (mode 0600), so
|
|
subsequent runs go straight to the library.
|
|
|
|
> Discovery probes both broadcast **and** a unicast sweep of your subnet,
|
|
> because many home networks (especially WiFi) silently drop broadcast packets.
|
|
|
|
### Login
|
|
|
|
| Key | Action |
|
|
|-----------|------------------------------------------|
|
|
| `tab` | move between fields |
|
|
| `ctrl+n` | next discovered server (if more than one)|
|
|
| `ctrl+r` | rescan the network |
|
|
| `enter` | sign in |
|
|
| `esc` | quit |
|
|
|
|
### Browse
|
|
|
|
| Key | Action |
|
|
|--------------------|---------------------------------|
|
|
| `↑`/`↓` `j`/`k` | move |
|
|
| `enter` / `l` / `→`| open folder · play item |
|
|
| `esc` / `←` / `h` | back |
|
|
| `c` | jump to Continue Watching |
|
|
| `/` | filter the current list |
|
|
| `q` | quit |
|
|
|
|
### Playing
|
|
|
|
| Key | Action |
|
|
|----------------|-------------------|
|
|
| `space` / `k` | play / pause |
|
|
| `←` / `→` | seek ∓10s |
|
|
| `shift`+`←`/`→`| seek ∓60s |
|
|
| `↑` / `↓` | volume ±5 |
|
|
| `m` | mute / unmute |
|
|
| `q` / `esc` | stop, back to list|
|
|
|
|
## Status
|
|
|
|
v0.1 — LAN auto-discovery, movies/shows (season/episode drill-down)/music browse
|
|
+ direct-play, resume on start, progress/stop reporting, volume control with
|
|
remembered level, and **audio auto-advance** (music plays through the album/
|
|
folder, then returns to the browser). The UI uses a shared header/footer frame
|
|
and a compact one-line list (media-type icon, title, and a right-aligned year ·
|
|
duration · watched column).
|
|
|
|
Roadmap: search, subtitle/audio-track selection, quick-connect login, video
|
|
"play next episode".
|
|
|
|
## Notes
|
|
|
|
- Self-signed TLS isn't trusted by default — use a proper cert (your Jellyfin is
|
|
usually behind Caddy anyway) or a plain `http://…:8096` URL on the LAN.
|