Gorka Molero

Public · rust CLI/TUI

StreamTUI

A terminal streaming/search product with keyboard-first TUI flows, CLI automation, JSON output, subtitles, VLC handoff, and Chromecast-oriented device gates.

Public branch CLI / TUI Agent-safe automation

Problem

Media search and streaming workflows are usually trapped in GUIs, brittle scripts, or app-specific state. StreamTUI packages that workflow as a terminal product: searchable, keyboard-friendly, automatable, and inspectable by both humans and agents.

What I Built

I built StreamTUI as a fully usable TUI and CLI version of a Stremio/Popcorn Time style workflow: search, stream selection, subtitles, Chromecast casting, JSON automation, and agent-friendly control. I rewrote the README and pushed a Go rewrite branch with tests and build verification, with the original Rust test suite passing.

Terminal product Search, stream choice, subtitles, keyboard navigation, and player handoff.
Automation surface CLI commands and JSON output designed for scripts and agent workflows.
Rewrite proof Go branch pushed and verified with formatting, tests, build, and Rust regression tests.

System Architecture

StreamTUI workflow diagram with search, terminal UI, subtitles, CLI mode, playback, Chromecast gate, Go rewrite, and agent workflow.
Public-safe workflow diagram. It shows the terminal product shape while marking Chromecast device evidence as a remaining hardware-dependent gate.
Sanitized StreamTUI terminal proof showing JSON search output, redacted device discovery, and passing Go tests.
Sanitized terminal proof from the local Go rewrite. It demonstrates the v1 JSON envelope, public search command shape, redacted local Chromecast discovery, and passing Go package tests.
Sanitized StreamTUI CLI session showing Go tests passing, VLC playback success JSON, and redacted Chromecast device discovery.
Current local proof capture. The Go tests pass, the agent-first VLC path returns a success envelope, and Chromecast discovery is proven with device names, LAN IPs, magnets, and cache paths redacted.
Controlled StreamTUI interactive terminal capture showing the search box, StreamTUI header, trending panel, loading state, and keybindings.
Controlled initial TUI capture from the Rust binary. It proves the interactive terminal surface, search affordance, loading/trending panel, and keybindings without exposing device names, LAN IPs, magnet links, subtitles, or media windows.

Technical Decisions

  • Keep the workflow useful as both a human TUI and a scriptable CLI.
  • Expose JSON output so agents can inspect state instead of scraping terminal text.
  • Preserve the original Rust proof while pushing a coherent Go rewrite branch.
  • Treat Chromecast as a device-gated integration, not as a claim until hardware evidence is captured.

What This Proves

StreamTUI is engineer-volume proof: terminal UX, CLI design, automation-friendly interfaces, media workflow pragmatism, and the ability to package a tool so both engineers and agents can operate it.