Go to file
David Benjamin 151a9d9b5b Remove a finished entry in the TODO file
The file's from earlier, but let's remove what's definitely done.
2011-04-02 21:53:09 -04:00
lsb-build Stub __recv_chk 2011-03-30 20:27:27 -04:00
npapi Pull over a new set of NPAPI headers from npapi-sdk 2011-03-26 02:14:26 -04:00
src Make some output if we think the wrapper needn't be modified 2011-04-02 21:47:21 -04:00
tests Silence some unused variable warnings in test-rpc-common.c 2011-03-31 11:46:50 -04:00
utils Debian patch: remove bashisms 2011-03-25 00:13:06 -04:00
.gitignore Add a .gitignore file 2011-03-30 17:12:19 -04:00
COPYING nspluginwrapper-0.9.91.1 2011-03-05 22:41:13 -05:00
ChangeLog nspluginwrapper-1.3.0 2011-03-25 00:13:06 -04:00
Makefile Move biarch/LSB CFLAGS and LDFLAGS computing to the top 2011-03-31 11:28:21 -04:00
NEWS nspluginwrapper-1.3.0 2011-03-25 00:13:06 -04:00
README Update the README file somewhat to reflect the new world order 2011-03-29 23:55:06 -04:00
TODO Remove a finished entry in the TODO file 2011-04-02 21:53:09 -04:00
configure Move biarch/LSB CFLAGS and LDFLAGS computing to the top 2011-03-31 11:28:21 -04:00
nspluginwrapper.spec Set svndate in the spec file back to DATE 2011-03-26 02:13:47 -04:00

README

  nspluginwrapper
  A cross-platform NPAPI plugin viewer

  Copyright (C) 2005-2009 Gwenole Beauchesne
  Copyright (C) 2011 David Benjamin


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.

nspluginwrapper is a trademark of Gwenole Beauchesne.


Overview
--------

nspluginwrapper consists in a proxy plugin and a viewer for NPAPI
compatible plugins. It makes it possible to use 32-bit x86 plugins
like Adobe Flash Player on other platforms like Linux/x86_64, *BSD and
even Linux/ppc.

nspluginwrapper also provides a standalone plugins player. This
program makes it possible to execute plugins without an actual
browser.


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

To simplify the build of the 32-bit viewer, a minimal subset of LSB
Desktop 3.1 is included in this distribution. Hence, you only have
to proceed as follows:

$ ./configure
$ make
# make install

Or, if you prefer from a source package:
$ rpm --rebuild nspluginwrapper.src.rpm

NOTE: if you are building the Linux viewer for use on a non-Linux
system (e.g. NetBSD, FreeBSD), you will have to configure the Linux
build with the --enable-generic option. That way, named sockets will
be used and work under the Linux emulation layer on those operating
systems.


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

An NPAPI-supporting browser built with GTK 2 support is currently
required for proper operation. An alternative is Konqueror but it does
not yet support the npruntime scripting API.

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
   -v --verbose            flag: set verbose mode
   -a --auto               flag: set automatic mode for plugins discovery
   -n --native             flag: allow native plugin(s) to be wrapped
   -l --list               list plugins currently installed
   -u --update [FILE(S)]   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
- Acrobat Reader      8.1.2
- DejaVu Libre        3.5.14
- Flash Player        7.0
- Flash Player        9.0.124
- Flash Player        10.0.12.36
- Flash Player        10.2.153
- Linux J2K           0.0.2
- Mplayerplug-in      2.80
- Mplayerplug-in      3.25
- Real Player         8.0
- Real Player         10.0.5
- Tcl plugin          3.1
- Squeak VM plugin    3.7
- Citrix ICA Client   10.0
- 3DMLW               1.0.3

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


History
-------

This project's history is maintained in a git repository hosted by
Github:

https://github.com/davidben/nspluginwrapper

Please consult the file "NEWS" for the release history.
A "ChangeLog" file is also available in this distribution from before
git.


Author
------

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

David Benjamin,
<davidben@mit.edu>