agejevasv / goradion

Terminal based online radio player

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.

goradion's Issues

Google Chrome virus has been detected

When downloading from releases on Windows, Google Chrome gives an error with a message that a virus has been detected in the file. What is it? What could it be cussing at in this context?

[REQ] Roadmap

Could you jot down the sorts of things you're interested in doing? IME, I've too often submitted patches for features that upstream is not interested in, which results in me having to maintain forks for just the stuff I want indefinitely. It's good to have an idea about whether upstream is willing to accept new features. I could ask about each one before working on it, but even better is knowing where you see the project going.

In particular, I'd like:

• Tags/categories. I see this as another column in the CSV, a space or semicolon separated list of categories. There would also be UI changes for grouping stations by categories, or filtering by category. I'm often in the mood for a kind of music, and being able to filter on tags and show only stations playing those kinds of music is really helpful. Like Genres, but less constrained.
• mpris support. This greatly facilitates integrating a music player in dozens of control/display tools: status bar controllers; dunst messaging, and controling with physical devices like knobs.

I think that's all I'm missing from goradion for now, but it's an example. Some require a fair bit of effort, so it'd be nice to know whether you're amenable to accepting large-ish patches to add support (tags are probably minor; mpris tends to be heavier)

AUR packages

I created two AUR packages for goradion so Arch Linux users can install it with their preferred AUR helper. You're welcome to link to them in the README if you'd like :)

• goradion
• goradion-bin

Can't play station

I add this station to my stations.csv, but when I launch goradion, it never shows. I tried tweaking the name several times, but that didn't help. I'm forced to conclude that it won't load the URL for some reason.

Zoom 1980s,https://samcloud.spacial.com/api/listen?sid=111415&rid=194939&f=mp3,any&br=128000,any&m=sc

Maybe also the bitrate information?

Would be great to have some bitrate info alongside the volume, what do you think? But mpv doesn't seem to handle the icy-bitrate tag, so that's probably not exactly easy?

The other way could be adding something like --term-status-msg='Bitrate: ${audio-bitrate}' to the mpv call, and parsing it, but, again, probably too much fuss?

Thanks for goradion anyway! Really nice and handy little gem :)