Shell.FM

Updates

Moved the project to github.com.
git clone git://github.com/jkramer/shell-fm.git shell-fm

Donations

If you like shell-fm, feel free to donate any amount, or just enjoy shell-fm for free. Donated money will most likely be spent for Last.FM subscriptions.

About

shell-fm is a lightweight, console-based player for Last.FM radio streams. It's pretty small (the binary is currently a little smaller than 60K, or 50K when stripped) and it has most features the "official" player has, if not even a few more. Additional features are, for example:

network interface (control shell-fm remotely)
autoban (automatically ban all tracks of an artist you don't like)
bookmark stations (quickly jump to bookmarked stations with a single key)
... probably more

Requirements

shell-fm doesn't need much. You definitely need libmad. shell-fm can also use libao for playback (optional).

Download

I recommend using the latest checkout from the GIT repository.

git clone git://github.com/jkramer/shell-fm.git shell-fm

GitHub also prepares release packages for you to download.

You might also want to check if there's a package available for your Linux distribution. However, those packages are maintained by other shell-fm users and I can not guarantee that they're up to date and/or working.

Installation

Please read the INSTALL file included in the checkout/tarball.

Authors

Check the AUTHORS file in the checkout.

Usage

There's an extensive manual in the shell-fm package that should explain everything.

License

shell-fm is published under the terms of the GNU General Public License (GPL). That means, it comes with absolutely no guarantee, but you may use/modify/redistribute it under the terms of the GPL, so if it doesn't work, fix it (and send me a patch).

Feedback

If you have questions, suggestions or something else, you can contact us in our IRC channel #shell-fm on irc.freenode.org. Please note that I'm living in Europe. If you don't get a reply to your question immediately, I'm probably sleeping or at work, so please stay while, I'll answer as soon as possible. You can also send me an email to jkramer at nex dot scrapping dot cc.