SomaFM

Play & record SomaFM radio channels

Features

• Play all SomaFM channels directly in your terminal.
• Play random channel.
• Nice & clean output of playing song including timestamp and song history.
• Desktop notifications on track change can be enabled.
• Specify channel directly or use interactive mode.
• Show channel list and search by name and genre.
• Hit + to instantly add playing song to favourites list.
• Copy current song title to clipboard by pressing c.
• Record channels and save tracks to your working directory.

Install

With yarn:

$ yarn global add somafm

or with npm:

$ npm install --global somafm

Playing a channel requires mpv on your system. Please make sure you have it installed and the mpv command can be run within your shell.

To record a channel, you need Streamripper and its executable streamripper.

On Linux, the xclip package is needed to enable copying the current song title to the clipboard.

Usage

Commands

$ somafm

Interactive mode. Choose a channel to play from the list.

$ somafm list [<keywords>]

Show a list of all SomaFM channels. You can filter by one or more keywords.

$ somafm play <channel> | random

Play a channel. To specify a channel, use the ID from the channel list (lower-case, no spaces), e.g. beatblender. Use random to play any channel.

$ somafm info <channel>

Get channel information.

$ somafm record <channel>

Record a channel. Tracks are saved into a directory containing channel name, date and time, e.g. SomaFM Groove Salad/20171011_213324. It is automatically created in the current working directory.

$ somafm list-favourites [<keywords>]

List your favourite songs. You can filter by one or more keywords in song title and channel name.

$ somafm edit-favourites

Edit your favourites songs file.

Command aliases

All commands have short aliases for faster typing.

Options

-n

Show desktop notifications.

Keyboard shortcuts

While playing, the following keyboard shortcuts are available: