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 disabled).
• 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 MPlayer or mpv on your system. Please make sure you have at least one of them installed and the mplayer or 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

Don't show desktop notifications.

Keyboard shortcuts

While playing, the following keyboard shortcuts are available:

* MPlayer only