Files
dots/common/.config/pyradio
coja a700e23e0a [Sync] adopt unified stow layout from the private repo
Mirrors the private dots tree at 900bdda: one shared base plus per-host
overlays, replacing the old flat .config/ layout (last synced 2026-06-28).

- packages: common/ gui/ wm/ lw/ fl/ + install.sh and bin/ tooling (dotsync,
  reconcile-hyde.sh)
- new README (layout, deploy order, HyDE dependency), plus ToDo.md and
  HYDE-UPDATE.md
- current HyDE waybar rig (layouts/, cava), pi agent extensions, claude/
  config, tmux, presenterm, aichat roles
- drops stale duplicates and generated cruft that should never have been
  tracked: the second top-level .pi/ copy, btop.log, zellij config.kdl.bak,
  fish_variables, nvim codecompanion.lua
- .pi/agent/auth.json is gitignored now; auth.json.example ships instead
- fl/ and wm/ hypr themes/ stay untracked (HyDE-generated per machine, per
  the root .gitignore)
2026-08-12 22:50:18 +02:00
..

PyRadio Setup

This repository contains a custom configuration and station list for PyRadio, a terminal-based radio player.

Kitty Music Session

To get a full-screen, immersive music player experience, you can use a custom Kitty terminal session.

The configuration file music.conf (found in your kitty config directory) sets up a layout that includes:

  • A pyradio terminal.
  • A cava terminal for audio visualization.
  • A pipes-rs terminal for some visual flair.

Launching the Session

Use keybind $mainMod + R or run the following command to launch the music session:

kitty --session ~/.config/kitty/music.conf

Setup

  1. Install PyRadio: Ensure you have pyradio installed on your system.
  2. Configuration:
    • Copy the config file to your PyRadio configuration directory (usually ~/.config/pyradio/config).
    • Copy the stations.csv file to your PyRadio directory.
  3. Using Custom Stations:
    • PyRadio can be configured to use a custom stations file. Ensure your config points to the stations.csv provided here if you want to use this specific collection of stations.

Station Sources

The stations in stations.csv are curated from various sources, often utilizing the Radio Browser API.

About Radio Browser

Radio Browser is a community-driven database of internet radio stations. It is a free, open-source project that provides a massive API for accessing thousands of radio streams worldwide. It's a great resource for discovering new music and finding niche genres that might not be available on mainstream services.

Alternatives to PyRadio

If you are looking for other ways to listen to internet radio in the terminal or via other interfaces, consider these alternatives:

  • Web Radio Clients: Many users of Radio Browser utilize various web-based players or custom scripts that interface directly with the Radio Browser API.
  • MPV (Command Line): Terminal player pyradio uses as a backend mpv <stream_url>
  • VLC (Command Line): You can play many radio streams directly from the terminal using cvlc --play-and-exit <stream_url>.