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>

Arch Linux: You can use AUR packages goradion and goradion-bin maintained by Amolith.

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

For your own stations you can create a public gist file and pass a link with a raw version of it with -s flag, e.g.:

goradion -s https://gist.githubusercontent.com/agejevasv/58afa748a7bc14dcccab1ca237d14a0b/raw/stations.csv

You can also create this file locally if you prefer. You can start with downloading and then editing default stations:

goradion -s /path/to/stations.csv

Keyboard Control

Keyboard Control

  *
    Toggle playing a random station.

  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.

  ?
    Toggle help.