TheGraveyard.org
TheGraveyard.org :: XMMPlayer -- MPlayer plugin for XMMS
 
About XMMPlayer
XMMPlayer is an input plugin for XMMS that allows you to play video files from within XMMS using MPlayer as a back-end. Easy, plain and simple. Just add the files you wish to play to the XMMS playlist and hit "play". It currently detects AVI/MPEG, QuickTime, RealMedia, .BIN and ASF(WMV, WMA) files by identifying them using file-signatures ("magic"). OGG movies are detected by their extension (".OGM"). Please remember that is product is still in beta-stage and may not work on all systems and with all video files MPlayer supports. See the README section below for more info.


Download XMMPlayer
 
Latest pre-release (bzip2): xmmplayer-0.3.3.tar.bz2 (223338 bytes)
Latest pre-release (gzip): xmmplayer-0.3.3.tar.gz (315346 bytes)
 


README
 
XMMPlayer - MPlayer plugin for XMMS
===================================


XMMPlayer is an input plugin for XMMS (http://www.xmms.org) that uses
MPlayer (http://www.mplayerhq.hu) to play video files.


FEATURES
--------

   * local file playback of AVI, MPEG, QuickTime and OGG movies using
     MPlayer
   * playback of HTTP and MMS media streams (see below)
   * Playback of (individual) VCD tracks or DVD titles (see below)
   * Shows info (length, audio-(nit)rate / channels) in XMMS
   * uses magic to detect AVI, MPEG, RealMedia and QuickTime movies
     (checks for .ogm extension to detect OGG movies, this to avoid MPlayer
     playing OGG sound files, which have the same magic identifier)
   * pause and seek in files from within xmms
   * Constant, skinned and dockable video window (can be turned off in
     options)


VIDEO WINDOW
------------

XMMPlayer now features a fully skinned, dockable video window (if you don't
like it, you can turn it off in the options). The window uses the same skin
as the playlist window. You can only close the window when mplayer is not
running, you can minimize at all times. The window will not appear until it
is needed for the first time (the first time XMMPlayer decides to play
something). Switching to full screen is not possible at the moment.


VCD / DVD
---------

If you want to play a VCD or DVD (or add it to the playlist) you can do so
by adding an URL, vcd:// for VCD's and dvd:// for DVD's. XMMPlayer will then
add an entry to the playlist called "VCD (all tracks)" or "DVD (all
titles)". Once you play one of those, XMMPlayer will scan the media to see
how many tracks / titles are available and add those tracks/titles to the
playlist (they will appear as "VCD track " or "DVD title ").
If you wish to add a specific track or title to the playlist, you can do so
by adding an url "vcd://tracknumber" ("vcd://1" for example) or
"dvd://titlenumber" ("dvd://1" for example).


STREAMING MEDIA
---------------

XMMPlayer allows you to play networked media streams. To play a HTTP stream,
add location, replace "http://" with "mplayer://" in the url (this is
required as the mp3 plugin for xmms seems to eat everything). To play an MMS
stream, just add the location of the mms url.


KNOWN ISSUES
------------

   * XMMPlayer can cause an infinite loop if mplayer was compiled with XMMS
     input plugin support (mplayer tries to open XMMPlayer, which tries to
     open mplayer which tries to open XMMPlayer, etc)

   * XMMPlayer refuses to play OGM files that don't have a .ogm extension


Project Links
-------------

The project homepage is:
  http://thegraveyard.org/xmmplayer.php

The homepage of MPlayer is:
  http://www.mplayerhq.hu/

The homepage of XMMS is:
  http://www.xmms.org/


Copyright (C) 2003 Hyriand - See COPYING
 


ChangeLog
 
Version 0.3.3 - 01 Feb 2003
   * No more crashes when playing WMA with skinned window enabled (hopefully)
   * Improved DVD / VCD support
   * Improved audio-only support (although seeking seems to be broken for
     WMA)
   * Audio output device is now saved to the config file
     (thanks to "damn I forgot your name and didn't keep a log")
   * Added tv mode (tv:// tv://channel)
     (thanks to Albrecht Lohoefener)
   * Updated autotools

Version 0.3.2 - 10 Oct 2003
   * Fixed seeking / length checking

Version 0.3.1 - 10 Oct 2003
   * Fixed buffer overflow (segfault) with newer MPlayers

Version 0.3.0 (not officially released)
   * _should_ work with FreeBSD now
   * Added auto-close video window (thanks Olle Hällnäs)
   * Added configurable VO and AO overrides

Version 0.2.1 - 30 May 2003
   * Fixed buffer overflow error (thanks Olle Hällnäs)
   * Added .bin magic (thanks again Olle Hällnäs)
   * Added RPM spec and make target (by Shlomi Fish)

Version 0.2.0 - 26 May 2003
   * WARNING: Users of a CVS XMMS need to configure --enable-xmms-cvs!!
   * Added a constant window skinned according to the XMMS skin
   * Even more QuickTime magic (thanks to Gary Hunt)
   * Added RealMedia magic (thanks to Gary Hunt)

Version 0.1.0 - 20 May 2003
   * Added file-info box
   * Added support for streaming media (http and mms)
   * Added a (new?) QuickTime magic (thanks to Gary Hunt)
   * Added playlist.h which was missing in pre4

Version 0.0.5pre4 - 7 May 2003
   * Added some more config options (non interleave avi parser, rebuilding
     AVI indexes, disable the use of the Linux RTC)

Version 0.0.5pre3 - 5 May 2003
   * Flexibilisation and further clean-up of the code
   * Preliminary VCD and DVD support

Version 0.0.5pre2 - 4 May 2003
   * First go at a config window (let's you specify path to mplayer, wether
     to use pre-reading of file info and mplayer fullscreen)

Version 0.0.5pre1 - 4 May 2003
   * Implemented info (length and audio-(bit)rate/channels)
   * Implemented seeking
   * Fixed memleak in xmmsmplayer_play_file

Version 0.0.4.1 - 4 May 2003
   * Fixed a silly "bug" that would prevent XMMPlayer to build on
     some systems.
   * Updated ChangeLog

Version 0.0.4 - 3 May 2003
   * Really fixed piping behaviour. Fixes hanging XMMS when you press stop.

Version 0.0.3 - 3 May 2003
   * Fixed defunct and other remaining mplayer processes

Version 0.0.2 - 2 May 2003
   * Changed name to XMMPlayer (xmms-mplayer already exists)
   * Configure script now determines where mplayer resides (override with
    --with-mplayer=PATH)
   * Fixed piping behaviour (pause now works)

Version 0.0.1 - 2 May 2003
   * Initial release
 


TODO
 
   * add per-file config options to file-info box
   * more mplayer options in config screen
   * DVD / VCD support improvement?
   * lots and lots of stuff
 

All contents (c) 2002-2004, Hyriand