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:


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 .