Contents

= ruby-ampache

Ruby-ampache is a really simple command line player for the ampache music server.

== Installation

You need to have mplayer installed to use ruby-ampache. Mplayer is used for playing music streams.

I've recently changed the way mplayer is invoked as mplayer slave mode is great, 
but not good to manage playlists..
I'm still testing it right now but it should work far better.

A few options have been added to the menu and most of all it is full of colors now!

Gem can be installed as usual

    gem install ruby-ampache

== Usage
First you have to write a .ruby-ampache file and save it in your $HOME

example file:
    AMPACHE_HOST="http://path_to_your_ampache_host"
    AMPACHE_USER="username"
    AMPACHE_USER_PSW="userpsw"
    #optional (default is /usr/bin/mplayer)
    MPLAYER_PATH="/usr/bin/mplayer"
	
Simply execute ruby-ampache that should be found in you $PATH after installation

== TODO
This is an alpha version and still has some issues.
If you kill the application mplayer will continue to run in background.
Also sometimes if mplayer get stucked playing a song the app does the same.

If you found more issues please let me know and I'll try to fix them as soon as possible

* fix encoding issues with file metadata retrieved from mplayer



== Notes
Special thanks goes to the developer of mplayer-ruby gem.
I've borrowed a couple of methods from his useful library

== Note on Patches/Pull Requests
 
* Fork the project.
* Make your feature addition or bug fix.
* Commit, do not mess with rakefile, version, or history.
  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2010 ghedmat. See LICENSE for details.
Please drop me a line if you find this useful

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
ruby-ampache-0.1.2	README.rdoc
ruby-ampache-0.1.1	README.rdoc