annodex.net/browser_plugin: a Mozilla Firefox 2 plugin for playing Ogg multimedia

  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  !!    NB: This plugin is not compatible with Firefox 3    !!
  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Overview
--------

The current version of the plugin is still under development therefore
the setup requires manual installation of the plugin. For more information,
see also:

  http://wiki.xiph.org/index.php/OggPlay

Dependencies
------------

To build the Firefox plugin on GNU/Linux or similar platforms, you need:

  * The core liboggplay dependencies from svn 
    Check the README files associated with liboggplay for installation instructions.
     svn co http://svn.annodex.net/liboggplay/trunk liboggplay
  * Imlib2 -- from your distribution or from
              http://sourceforge.net/project/showfiles.php?group_id=2&package_id=11130
  * Firefox (development environment) -- http://developer.mozilla.org/
  * GTK2.0 -- from http://www.gtk.org/

On Debian, the required packages for all additional libraries, 
except for liboggplay and its dependencies, are:
  g++ libimlib2-dev firefox-dev libgtk2.0-dev

Plugin Installation
-------------------

[Linux]

1. It is assumed that you managed to check out current sources
of the plugin from http://svn.annodex.net/liboggplay/trunk tree 
(e.g. svn co http://svn.annodex.net/liboggplay/trunk ./liboggplay).
The rest of the installation steps assume that you checked out
the code to the ./liboggplay directory. 

2. To compile liboggplay, in the main 'liboggplay' directory do:

./autogen.sh
./configure
make; make install

3. As a result of the checkout you should have a 'plugin' directory under
the 'liboggplay' tree. After a sucessful build you should have the following
files:

plugin/.libs/libnpoggplugin.so
plugin/npliboggplugin.xpt

Copy those file to .mozilla/plugins in your local directory by executing 
copy-plugin.sh or directly copying them e.g.

cd plugin
cp .libs/libnpoggplugin.so $HOME/.mozilla/plugins
cp npliboggplugin.xpt $HOME/.mozilla/plugins

4. The 'plugin' directory also has a test html page you can use to test 
the plugin (see ./plugin/test/test.html). Alternatively, you can go to:
http://media.annodex.net/cmmlwiki/SFD2005-Trailer to test the plugin.

If you can see the video playing using either method the plugin is successfully 
installed. Enjoy!

[Win32]

For developers interested in developing Win32 version of the OggPlay Mozilla plugin please refer to 
development environment setup description on: http://wiki.xiph.org/index.php/OggPlay/Win32.

The same link outlines where to find plugin binaries and how to install them for Mozilla Firefox.

[MacOS]

Put the file:

plugin/mac/mac-annodex-dev-install.sh

in a working directory somewhere, run the script, and follow the directions.