[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
parent f62cb40499
commit a700e23e0a
318 changed files with 12564 additions and 10772 deletions
@@ -0,0 +1,45 @@
+# PyRadio Setup
+
+This repository contains a custom configuration and station list for [PyRadio](https://github.com/coderholic/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](https://sw.kovidgoyal.net/kitty/sessions/).
+
+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:
+
+```bash
+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](https://www.radio-browser.info/) API.
+
+### About Radio Browser
+[Radio Browser](https://www.radio-browser.info/) 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](https://www.radio-browser.info/users)**: Many users of Radio Browser utilize various web-based players or custom scripts that interface directly with the Radio Browser API.
+*   **[MPV (Command Line)](https://mpv.io/)**: Terminal player pyradio uses as a backend `mpv <stream_url>`
+*   **[VLC (Command Line)](https://www.videolan.org/vlc/)**: You can play many radio streams directly from the terminal using `cvlc --play-and-exit <stream_url>`.
+