Metadata-Version: 2.4
Name: vintage-radio
Version: 1.0.0
Summary: A retro-style internet radio player for the terminal
Project-URL: Homepage, https://github.com/philjung/terminal-radio
Author: Phil Jung
License-Expression: MIT
Keywords: music,radio,streaming,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.9
Requires-Dist: python-mpv>=1.0.0
Requires-Dist: textual>=0.40.0
Description-Content-Type: text/markdown

# Vintage Radio

A retro-style internet radio player for the terminal.

```
╔══════════════════════════════════════════════════════════════════════════════════════╗
║                                    ~ R A D I O ~                                     ║
║  ╭────────────────────────────────────────────────────────────────╮  ╭────────────╮  ║
║  │  |      SomaFM Groove Salad                         PLAYING   │  │ │ │ │ │ │ │ │  ║
║  │  |      00:42              VOL: 60%                           │  │ │ │ │ │ │ │ │  ║
║  ╰────────────────────────────────────────────────────────────────╯  │ │ │ │ │ │ │ │  ║
║       [ |<< ]    [ > PLAY ]    [ [] STOP ]    [ >>| ]                │ │ │ │ │ │ │ │  ║
║  ╭────────────────────────────────────────────────────────────────╮  │ │ │ │ │ │ │ │  ║
║  │  ▶ 1. SomaFM Groove Salad                                     │  │ │ │ │ │ │ │ │  ║
║  │    2. SomaFM Drone Zone                                       │  ╰────────────╯  ║
║  │    3. KEXP Seattle                                            │                   ║
║  ╰────────────────────────────────────────────────────────────────╯                   ║
╚══════════════════════════════════════════════════════════════════════════════════════╝
```

## Features

- Retro radio UI with speaker grill and VU meters
- Real-time audio level visualization via ffmpeg
- 8 beautiful themes (Retro, Synthwave, Dracula, Nord, Gruvbox, and more)
- Add your own stations
- Keyboard-driven interface

## Installation

### From PyPI

```bash
pip install vintage-radio
```

### From source

```bash
git clone https://github.com/philjung/terminal-radio
cd terminal-radio
pip install .
```

### Requirements

- Python 3.9+
- [mpv](https://mpv.io/) - for audio playback
- ffmpeg (optional) - for VU meter visualization

On macOS:
```bash
brew install mpv ffmpeg
```

On Linux:
```bash
sudo apt install mpv ffmpeg  # Debian/Ubuntu
```

## Usage

```bash
radio
```

### Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `Space` | Play / Pause |
| `S` | Stop |
| `N` | Next station |
| `P` | Previous station |
| `↑` / `↓` | Volume up / down |
| `A` | Add new station |
| `T` | Switch theme |
| `Q` | Quit |

## Themes

Switch themes with `T`:

- **Bakelite** - Dark brown with brass accents (default)
- **Retro Radio** - Warm wood tones
- **Mint Retro** - Silver with teal accents
- **Vintage Cream** - Light beige and brown
- **Synthwave** - Neon pink and cyan
- **Dracula** - Purple and green
- **Gruvbox** - Orange and earthy tones
- **Nord** - Cool arctic blues

## Configuration

Your stations are stored in `~/.config/terminal-radio/stations.m3u`. You can edit this file directly or add stations via the app with `A`.

Example format:
```m3u
#EXTM3U

#EXTINF:-1,SomaFM Groove Salad
http://ice1.somafm.com/groovesalad-128-mp3

#EXTINF:-1,KEXP Seattle
http://live-mp3-128.kexp.org/kexp128.mp3
```

## License

MIT

## Author

Phil Jung
