goradion

Goradion is a TUI radio player based on mpv.

You can listen to a curated list of stations or search for more online via radio-browser.info.

Setup

1. Prerequisites: mpv

   • Mac

     • brew install mpv

   • Ubuntu

     • apt install mpv

   • Arch Linux

     • pacman -S mpv (there is also AUR package, so you can just do: yay -S goradion)

   • Windows

     • Download: mpv
     • Unpack e.g. into c:\mpv
     • Add this dir to the PATH, either via GUI or: setx /M PATH "%PATH%;c:\mpv"

   • Other OSes

     • Install mpv using your package manager or refer to https://mpv.io/installation/

2. Download goradion

3. Mark it as executable (not needed on Windows):

chmod +x goradion-<version>

Warning: On some Windows machines, a virus scanner identifies the binary as infected (https://go.dev/doc/faq#virus), in this case it's best to build the binary yourself: go build ..

Run

On Windows just double click the downloaded exe (or run via cmd to use flags), on other OSes:

# Starts with preset radio stations
goradion-<version>

Stations

The stations are configured using a CSV file with a titile, URL and semicolon ; separated tag(s), e.g.:

Title,URL,tag_1[;...;tag_n]
...

Stations file can be passed with -s argument; goradion supports both local files and HTTP URLs, e.g.:

goradion -s /path/to/stations.csv

OR

goradion -s https://path-to/stations.csv