coja
1e39e0cb4b
Supersedes the old flat .config/ layout (last published 2026-06-28) with the private repo's structure: one shared base plus per-host overlays. - packages: common/ gui/ lw/ fl/ wm/ plus install.sh and bin/ tooling (dotsync, reconcile-hyde.sh) - new README covering the layout, deploy order and the HyDE dependency - current HyDE waybar rig (layouts/, cava), pi agent extensions, claude/ config, tmux, presenterm, aichat roles - fish: kp (keepassxc-cli + fzf picker, db path from $KP_DB) and bind_M_n_history (alt+1..9 recalls the nth history entry) - drops cruft that should never have been tracked: the duplicate top-level .pi/ copy, btop.log, zellij config.kdl.bak, fish_variables - .pi/agent/auth.json is gitignored; auth.json.example ships instead Host-specific work sessions and the personal backlog stay in the private tree. Endpoint locators in the llamacpp/whisper guides are placeholders ($SERVER, <own-domain>) — the guides themselves stay, since they are the useful part.
46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# 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>`.
|
|
|