From b518cd156166b16d8c7acca8e63efc65ebe13383 Mon Sep 17 00:00:00 2001 From: veradec Date: Sun, 25 Oct 2026 22:06:42 +0530 Subject: init: init radio_tui --- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..215f112 --- /dev/null +++ b/README.md @@ -0,0 +1,51 @@ +# Telugu Radio TUI + +A terminal UI for browsing and playing Telugu online radio stations from [OnlineRadioFM](https://onlineradiofm.in/language/telugu). + +## Requirements + +- Python 3.11+ +- [mpv](https://mpv.io/) — playback +- [socat](https://sourceforge.net/projects/socat/) — mpv IPC + +## Quick start + +```bash +cd ~/code/radio_tui +chmod +x radio-tui +./radio-tui +``` + +The launcher creates a local `.venv` and installs dependencies on first run. + +Or manually: + +```bash +python3 -m venv .venv +source .venv/bin/activate +pip install -r requirements.txt +python -m radio_tui +``` + +## Keys + +| Key | Action | +|-----|--------| +| `/` | Focus search | +| `Enter` | Play selected station | +| `n` / `p` | Next / previous station (and play) | +| `+` / `-` | Volume up / down | +| `m` | Mute | +| `s` | Stop | +| `f` | Toggle favorite | +| `y` | Show stream URL | +| `q` | Quit | + +Favorites are saved to `~/.radio_tui_favorites.json`. + +## Data + +- `telugu-radio-stations.json` — station metadata and stream URLs +- `telugu-radio-stations.csv` — same data in CSV format + +Source: https://onlineradiofm.in/language/telugu -- cgit v1.2.3