search

MS3FGX / SomaFM

A simple Python 3.x terminal interface for streaming SomaFM
GNU General Public License v3.0
52 stars 10 forks source link
chromecast desktop-notifications linux player python-3 somafm streaming-audio terminal terminal-colors

readme

feat_img

Python SomaFM Player

This simple player for SomaFM keeps the distractions, and system resource utilization, to an absolute minimum. The look of this player was inspired equally by the excellent SomaFM terminal interfaces which were already available, and the 90's hacker aesthetic that I seem to find myself nostalgic for when listening to a Shoutcast stream at 2AM.

As of the current version, the player supports completely unnecessary features like desktop notifications and Chromecast support at no extra charge. Known to work on Linux (including Raspberry Pi and Chrome OS's Crostini), Mac OS, and even Windows.

For an up-to-date list of what's new, check the Changelog

Installation

Starting with version 1.5, the stable version of this program is available on PyPi and can be installed with the following command:

pip3 install somafm

If you'd like to keep up with the latest version, just clone this repository to your system and run the script.

Dependencies

At minimum, this program requires Python 3 versions of the following libraries:

Channel Selection

Simply running somafm with no options will start streaming "Groove Salad." In the somewhat unlikely event you wanted to listen to something else, simply give it the channel name like so:

somafm "DEF CON Radio"

Channel entry is not case sensitive and uses a certain amount of "fuzzy" matching. So rather than typing out the entire name, the following will also work:

somafm def

Finally, if you're not sure what you want to listen to, you can pass the -r option to let the script randomly select from one of the currently active channels:

somafm -r

Optional Arguments

While not required for basic usage, the following arguments are also available:

--list

Download the latest master list of SomaFM channels and display their descriptions.

channel_img

--stats

This option shows the number of listeners for each currently online SomaFM channel, along with a total listener count.

--cast

If you have the pychromecast library installed, this option will start playback of the given SomaFM channel on the given Chromecast device. If no device name is given, the default specified by the chromecast_name variable will be used.

Supported Players

This program is simply a front-end, playback requires one of these media players to be installed:

HTTPS Support

By default streams are played via HTTP, but you can enable experimental HTTPS support by using the -S or --ssl argument.

When this argument is given, the script will clear the cached channel info and re-download it via HTTPS. From that point on, all streaming operations will attempt to use HTTPS, whether or not you add the -S argument.

At the time of this writing, HTTPS doesn't seem to be very well supported with the players used by this script. At least on Linux, the only one that appears to work is mpv. If you tried to enable HTTPS and now find that none of the channels will play, just use the -d option to delete the cache and things should return to normal.

Desktop Notifications

There is currently experimental support for desktop notifications on Linux using libnotify. They can be enabled by changing the value of the boolean variable desktop_notifications or turned on temporarily with the -n option.

notifications

Future Development

While the script is already at a point where I would consider it feature complete, there are a few things I think might be interesting to look into:

If you have an idea for a feature you'd like to see, let me know.

About SomaFM

somabanner

SomaFM is a listener-supported Internet-only radio station. That means no advertising or annoying commercial interruptions. SomaFM's mission is to search for and expose great new music which people may otherwise never encounter.

If you like what you hear on SomaFM and want to help, please consider visiting their site and making a donation.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

For details, see the file "COPYING" in the source directory.