muine-shell
===========

A utility to control Muine from the command line.  The main advantage
of using a separate program is speed: it's written in C so it starts
(and finishes) much faster than a Mono version.

Run with --help to see all the commands.  All options take long and
short versions in the usual GNU way, e.g. --volume=50 or -v50.  Notes on
some of the commands:

* Options that require files look to the end of the command, e.g.

 % muine-shell --playlist --volume=50 myplaylist.m3u

simultaneously sets the volume and opens a playlist.  Only one
playlist can be opened at a time, and any playlists after the first
are ignored.

* The volume option uses either absolute values from 0-100, eg
  --volume=50; or relative values like +10 or -10, eg --volume=-10

* The --position option with no arguments prints the position as a
  percentage.  If a single 's' is given as an argument (e.g. -ks),
  then it prints the position in seconds.  

  When supplying an argument, you can give it an absolute percentage
  or time, e.g. --position=25.5% or --position=25s; or a relative
  percentage or time, e.g. --position=+5s or --position=-5%.  Some
  shells may have difficulties with '%', so if no 's' or '%' is given,
  it assumes '%'.

* If no argument is given to --cover-image then the image is saved to
  'cover.png' in the current directory.

* 0.5 has two new commands: --song-changed and --state-changed.  These
  cause muine-shell to sleep until either the song changes or muine is
  (un)paused.  Then muine-shell prints out either the name of the new
  song or a 0 or 1 showing whether Muine is playing or not.
  If you would find these commands useful only if they did something
  else (like start a new program) then please let me know!
  
Requirements
============

As of version 0.6.0, muine-shell uses DBUS version 0.60 and Muine 0.8.4.
It won't work (or compile!) on earlier versions.
