goradion

Goradion is a command line radio player based on mpv. Goradion is inspired by pyradio and supports it's stations playlists.

Setup

1. Prerequisites: mpv

   • Mac

     • brew install mpv

   • Ubuntu

     • apt install mpv

   • Arch Linux

     • pacman -S mpv

   • 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 optional, 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

Keyboard Control

Keyboard Control

  *
    Toggle playing a random station.

  /
    Show tag selection screen.

  #
    Clear selected tag.

  a-z and A-Z
    Toggle playing a station marked with a given letter.

  Enter and Space
    Toggle playing currently selected station.

  Left and Right, - and +
    Change the volume in increments of 5.

  Up and Down
    Cycle through the radio station list.

  PgUp and PgDown
    Jump to a beginning/end of a station list.

  Esc
    Close current window.

  ?
    Show help screen.