RADISH

radio player in sh

I just want a simple script to play radio sometimes, or shuffle music on my computer, or play noise. I don’t need tagging, playlist building, blah blah blah. So, I wrote RADISH.

Usage

Copied from radish -h:

RADISH: radio, music, static
USAGE:  radish [-h|-k|-r|-s|-S]
  radish -l [NAME]
  radish [STATION]

FLAGS:
 -h    Show this help and exit.
 -s    Show radish's status and exit.
 -S    Show radish's status indefinitely.
 -k    Kill the currently-playing radish invocation.
 -r    Replay most recently-played station.

OPTIONS:
 -l [NAME]  List available stations.
    If NAME is given, narrow the list to those matching it.

PARAMETERS:
 STATION  Which configured station to play.
          Stations are defined in the $RADISH_STATION_FILE
          (default: /home/case/etc/radish/stations).
          If STATION is not present, or if it matches
          more than one station, radish will present a menu.

Configuration

A default radish.stations is provided in this repo; save it to $XDG_CONFIG_HOME/radish/stations and edit as you see fit.

Radish’s station file is a tab-separated file with the following schema:

URL DESCRIPTION TAGS

Lines starting with # are ignored as comments.

A URL can be the URL of an internet radio or other stream, or one of file://<FOLDER>, shuf://<FOLDER>, or noise://<NOISE-SPEC>. The file: protocol simply finds all music files underneath FOLDER and plays them in order. shuf: does the same, but shuffles the files. noise: uses SoX’s play binary to generate noise.

NOTE: Currently the noise: URL parsing doesn’t work. Patches welcome!

NOTE: I’m looking at using a previously-existing playlist format, like pls or m3u, instead of this ad-hoc tab-separated deal. Expect change in this area.

Installation

# make install

Uninstallation

# make uninstall

Contributing

Patches, comments, complaints are welcome. You can email me at the address listed on the bottom of this page.

RADISH and its associated files are licensed under the Fair License. See COPYING for more details.