README.textile

   1 h2. About
   2
   3 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:
   4
   5 * network interface (control shell-fm remotely)
   6 * autoban (automatically ban all tracks of an artist you don't like)
   7 * bookmark stations (quickly jump to bookmarked stations with a single key)
   8 * ... probably more
   9
  10 h2. Requirements
  11
  12 shell-fm doesn't need much. You definitely need libmad. shell-fm can also use libao for playback (optional).
  13
  14 h2. Installation
  15
  16 It's always recommended to use the latest version from GitHub.
  17
  18 First clone the repository:
  19
  20 bc. $ git clone http://github.com/jkramer/shell-fm/tree/master
  21
  22 Make sure you have the needed libraries to compile (libmad0-dev and libao-dev.) This should do the trick for Ubuntu:
  23
  24 bc. $ sudo apt-get install libmad0-dev libao-dev
  25
  26 Change into the repository directory and compile Shell.FM:
  27
  28 bc. $ cd shell-fm
  29 $ make
  30
  31 Finally, install the binary and the manual as root:
  32
  33 bc. $ su -c "make install"
  34 OR:
  35 $ sudo make install
  36