ampt

= ampt

Command-fu for amp.

== DESCRIPTION:

A command line client for the Acoustics Media Player (amp). Amp is available here: http://www.github.com/avuserow/amp

This is a work in progress.

== FEATURES:

• Control amp from the command line!
• Completely scriptable and reconfigurable.

== SYNOPSIS:

=== Usage:

$ ampt --help
Usage ampt [command] [options] [args]

Commands include:
 new              Get [num] newest songs. Defaults to 50.
 list             List all songs with the specified parameter. This
                  is less fuzzy than search. One of the flags must
                  be specified.
 add              Vote for a song. Provide a song id, or one of the
                  flags.
 history          Get [num] last-played songs. Defaults to 25.
 stop             Stop Acoustics.
 volume           Set the current volume level. If run without an
                  arg, returns the current volume.
 start            Start Acoustics.
 remove           Remove your votes from songs in the playlist.
                  Provide a song id or one of the
                  flags.
 random           Get [num] random songs. Defaults to 20.
 show             Show more info about a song. Takes a song id as
                  the single parameter.
 reset            Clear all of your votes.
 skip             Skip the currently playing song.
 status           Prints the currently playing song and playlist.
 search           Search the database for songs. Defaults to
                  searching by any parameter.

   --version, -v:   Print version and exit
   --help, -h:   Show this message
$ ampt status
Now Playing:
  [  14871] Let There Be Light by Justice 
  Voted up by rotap2

Playlist:
  [  14881] Newjack by Justice 
  Voted up by rotap2
...
  25 songs queued for a total time of 2:13:51
  You have 20 songs queued for a total time of 1:49:20

=== Scripting:

See lib/ampt_cfg/default.rb to see how configurations work -- all of ampt's commands are written the same way you would write your own custom command or configuration.

== REQUIREMENTS:

• libopenssl bindings for ruby
• libcurl-dev

== INSTALL:

$ sudo gem install ampt

== TODO:

• Fix error handling when getting invalid data from the server.
• Write up a bit of documentation on writing configurations.
• Support for piping arguments to certain commands.

== LICENSE:

See LICENSE.