rdo

A minimal radio player for the terminal.

Usage

Use Nix to execute:

nix run github:pascalj/rdo

Keymap

Normal mode:

• Enter: play selected station
• Space: stop playing
• j/k or ↓/↑: select stations
• J/K: move selected station down / up
• n: new station
• e: edit selected station
• d: delete selected station (asks to confirm)
• q: quit

Edit / add mode:

• Tab: switch between the name and URL field
• Enter: save
• Esc: cancel

Delete confirmation:

• Enter: confirm
• Esc: cancel

Stations

Stations are saved as CSV in $XDG_CONFIG_HOME/rdo/stations.csv, e.g.:

name,url
detektor.fm - Wort,https://streams.detektor.fm/wort/mp3-256/website/
radio lclhst,http://radio.lclhst.net/listen.m3u

Fields containing commas, quotes, or newlines are quoted per RFC 4180.

Home-manager

The flake exposes a home-manager module for declaring stations from your NixOS / home-manager config:

{imports=[inputs.rdo.homeManagerModules.default];# Apply the overlay so pkgs.rdo resolves, or set programs.rdo.package# explicitly.nixpkgs.overlays=[inputs.rdo.overlays.default];programs.rdo={enable=true;stations=[{name="detektor.fm - Wort";url="https://streams.detektor.fm/wort/mp3-256/website/";}{name="radio lclhst";url="http://radio.lclhst.net/listen.m3u";}];};}

While stations is non-empty the CSV file is a symlink into the Nix store.