As of March 26th 2014, last.fm stopped their radio streaming! No streaming whatsover, for no one (no, not even for subscribers). So this project is kind of pointless now. I’ll leave this page here for no apparent reason and the source will stay on github.com as well, but you won’t be able to use it like you used to. Thanks to all the loyal users and contributors I got to know of the years, especially those who chilled out with me in #shell-fm! And my very special thanks to the few of you who actually donated money! I think it was about 20 EUR over the years, and I spent all of it on beer!

Moved the project to GitHub.

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


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.


shell-fm is a lightweight, console-based player for Last.FM radio streams. It’s pretty small (the binary is currently about 70K, or about 60K 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


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


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.


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


Check the AUTHORS file in the checkout.


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


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).


If you have questions, suggestions or anything else, you can contact me 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. There are also many other guys hanging around who might be able to help. You can also send me an email to jkramer@nex.scrapping.cc.