
  nspluginwrapper
  A compatibility layer for Netscape 4 plugins

  Copyright (C) 2005-2006 Gwenole Beauchesne


License
-------

nspluginwrapper is available under the terms of the GNU General Public License.
See the file "COPYING" that is included in the distribution for details.


Overview
--------

nspluginwrapper consists in a proxy plugin and a viewer for Netscape 4
compatible plugins. It makes it possible to use 32-bit x86 plugins
like Macromedia Flash with x86_64 compiled Mozilla browsers.


Quick build notes
-----------------

On x86-64 Mandriva Linux systems, the following steps are enough:

# urpmi gtk+2-devel "devel(libgtk-x11-2.0)"
$ mkdir objs64 objs32
$ cd objs64 && ../configure && make && cd ..
# make -C objs64 install
$ linux32 bash -c "cd objs32 && ./configure && make npviewer.bin"
# make -C objs32 install.viewer

On other distributions, you may have to access a 32-bit system (or
chroot) to build the viewer.

Likewise, building from an SRPM is made easy:
$ rpm --rebuild nspluginwrapper.src.rpm
$ linux32 rpm --rebuild nspluginwrapper.src.rpm
$ ./utils/repackage.sh <PATH-TO>/nspluginwrapper.i586.rpm


Requirements and Installation
-----------------------------

A Mozilla based browser built with GTK 2 support is currently required
for proper operation.

On package installation, 32-bit plugins are automatically recognized
provided they are available in the /usr/lib/mozilla/plugins directory.

You can manually install/remove/update plugins with "nspluginwrapper".

   usage: nspluginwrapper [flags] [command [plugin(s)]]

   -h --help               print this message
   -a --auto               set automatic mode for plugins discovery
   -l --list               list plugins currently installed
   -u --update             update plugin(s) currently installed
   -i --install [FILE(S)]  install plugin(s)
   -r --remove [FILE(S)]   remove plugin(s)

[plugin(s)] are full paths to actual plugin binaries (e.g. nppdf.so
for Acrobat Reader, libflashplayer.so for Flash).


Compatibility List
------------------

Please bear in mind this is *BETA* software.

The following plugins work reasonnably well:
- Acrobat Reader      5.0.9
- Acrobat Reader      7.0.1
- DejaVu Libre	      3.5.14
- Flash Player	      7.0
- Linux J2K           0.0.2
- Mplayerplug-in      2.80
- Real Player         8.0
- Real Player         10.0.5

Broken or partially working:
- Real Player         8.0
- Adobe SVG           3.01x88


History
-------

Please consult the file "NEWS" for the release history.


Author
------

Gwenole Beauchesne,
<gb.public@free.fr>