Skip to content

jonmilley/townie_radio

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📻 TownieRadio

A minimal, terminal-based radio streamer for local St. John's, Newfoundland & Labrador stations.

TownieRadio is a lightweight Rust TUI app that lets you stream local radio directly from your terminal with a retro pixel-art vibe.

TownieRadio Screenshot


✨ Features

  • 🎧 Stream local St. John's radio stations
  • 🖥 Retro terminal UI (built with ratatui)
  • 🎨 Pixelated station logos
  • 📡 Live status (LOADING / ONLINE / OFFLINE)
  • 📊 Animated spectrum display
  • ⌨ Simple keyboard controls

📡 Included Stations

  • CBC Radio 1 (St. John's)
  • CHMR 93.5 FM
  • CHOZ OZFM
  • VOCM AM 590
  • VOWR 800
  • HOT 99.1 FM
  • K-Rock 97.5

Stations and logos are embedded into the binary at compile time. To add a station, drop a PNG into logos/, add an entry to stations.json, then rebuild:

{
  "name": "My Station",
  "url": "https://example.com/stream",
  "logo_path": "logos/MyStation.png"
}

🛠 Requirements

  • Rust (latest stable recommended)
  • ffplay (from FFmpeg)

Install Rust

curl https://sh.rustup.rs -sSf | sh

Clone the repository

git clone https://github.com/Striss/townie_radio
cd townie_radio

Run the app

cargo run

Build a standalone binary

All assets (station list and logos) are compiled directly into the binary — no external files needed at runtime.

cargo build --release

The self-contained executable will be at target/release/townieradio.

About

TUI-based streaming radio app for local radio in St. John's NL

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Rust 100.0%