Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ghedamat/ruby-ampache

Ampache ruby client - maybe one day
https://github.com/ghedamat/ruby-ampache

Last synced: 2 months ago
JSON representation

Ampache ruby client - maybe one day

Host: GitHub
URL: https://github.com/ghedamat/ruby-ampache
Owner: ghedamat
License: other
Created: 2010-09-18T14:41:10.000Z (over 14 years ago)
Default Branch: master
Last Pushed: 2012-09-05T17:41:17.000Z (over 12 years ago)
Last Synced: 2024-10-10T03:54:55.390Z (3 months ago)
Language: Ruby
Homepage: http://github.com/ghedamat/ruby-ampache
Size: 138 KB
Stars: 4
Watchers: 2
Forks: 3
Open Issues: 5
Metadata Files:
- Readme: README.rdoc
- License: LICENSE

Awesome Lists containing this project

README

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