PyXMMS and PyXMMS-remote

[Florent Rougon]

Hello,


WHAT?
-----

PyXMMS is a set of Python bindings for all the xmms_remote* functions of
the libxmms library, plus some higher-level functions. It can be used to
control XMMS (a free multimedia player for X-Window) from a Python
program.

PyXMMS-remote is an command-line interface to PyXMMS (written in
Python). It can be used to do quite a lot of things with an XMMS session
from the command-line.


EXAMPLES
--------

1) With PyXMMS, you can tell the XMMS session 2 to start playing with

     import xmms                        # This is PyXMMS
     xmms.play(2)

   With PyXMMS-remote, the same thing is accomplished (from your shell)
   with the command:

     pyxmms-remote -s 2 play

2) With PyXMMS, you can write the following call:

     xmms.enqueue_and_play_launch_if_session_not_started(
                         ("file1.mp3", "file2.ogg", "http://u.r.l.ogg"),
                         "xmms", 0)
   to:

     - look if the XMMS session 0 is running and launch XMMS in
       the background if not (by the way, the two last arguments are
       optional and could be ommitted here);
     - add the three audio streams specified to the playlist;
     - tell the XMMS session 0 to start playing from file1.mp3

  With PyXMMS-remote, you can achieve the same thing with:

     pyxmms-remote E file1.mp3 file2.ogg http://u.r.l.ogg

  (yes, if you are masochistic, you can also use the not-so-short
   command name enqueue_and_play_launch_if_session_not_started; you can
   also specify the session to act on and the XMMS executable name)

  This command is handy to use with file managers and MIME-aware
  applications.

There are currently 58 commands defined in PyXMMS-remote (as there are
about the same number of functions in PyXMMS).


DOCUMENTATION
--------------

PyXMMS and PyXMMS-remote are well documented. You can browse these
documentations on their home page (see below) or (for PyXMMS) using
pydoc.


LICENSE
-------

PyXMMS and PyXMMS-remote are licensed under the GNU GPL.


REQUIREMENTS
------------

PyXMMS and PyXMMS-remote have been tested with Python 2.1 and 2.2 and
should work on earlier versions with no or very few modifications.


HOME PAGE
---------

You will find everything about these programs on:

  <http://www.via.ecp.fr/~flo/index.en.html#PyXMMS_and_PyXMMS-remote>

Have fun.

-- 
Florent