mirror of
https://github.com/Ty1an/RTSP-TUI.git
synced 2026-11-21 22:49:58 +01:00
A Rust RTSP TUI program to view RTSP Streams in the terminal
- Rust 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| screenshots | ||
| src | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE | ||
| README.md | ||
RTSP-TUI
RTSP-TUI is a terminal-first RTSP camera viewer built in Rust.
A live multi-camera TUI with Kitty graphics rendering.
Screenshot
AI image replacement for the individual feeds, since I am not sharing real camera footage of my house lol.
What It Is
The main workflow is:
- Start the TUI.
- Let discovery find camera endpoints.
- Select streams and set per-camera auth/display names.
- Watch live tiles in the viewer.
Possible Additions
- Maybe make it like a somewhat lightweight "NVR" with motion detection that saves the last frame or something idk
- Make it more accecible for an AI agent (SKILL.MD) like openclaw to automate something based on camera information (Claude watches your house now lol 🙃)
Requirements
- Rust toolchain
- A terminal with Kitty graphics protocol support (Kitty, Ghostty, WezTerm, Foot, or Konsole).
- Reachable RTSP cameras/streams.
- Tested Personally on MacOS (M3 Mac) will likely work on Linux or Windows WSL but no guarantee
Install
From crates.io
cargo install rtsp-tui
From source
git clone https://github.com/Ty1an/RTSP-TUI.git
cd RTSP-TUI
cargo install --path .
Dev run
cargo run --release
Quick Start (TUI)
rtsp-tui
Inside the app:
- Press
Ctrl+Sto open Settings. - In Select Cameras, use
Up/DownandEnterto toggle streams. - Press
Tabto switch to Camera Auth and set:- Display Name
- Auth Username
- Auth Password
- Press
Ctrl+Bto return to live viewer.
Keybindings
Live Viewer
Ctrl+S: Open SettingsCtrl+Q: Quit
Settings
Up/Down: Move selection (stream list or auth field focus)Enter: Toggle selected stream on/offTab: Switch between stream list and auth panelCtrl+B: Back to viewerCtrl+Q: Quit

