VLC Mozilla Wrapper Plugin Files

VLC Mozilla Wrapper Plugin 1.0

    Media Player support for Mozilla browsers
    
    Author: Cosmin Popescu [cosminadrianpopescu at gmail.com]

-----------------------------------------------------------------------

About:
--------------------------

This is a free program. You can use it, distribute it, modify it, 
do what ever you want with it. Any suggestions, reclamations, 
bug reports or any other ideas that you may have, please send them
at cosminadrianpopescu at gmail.com

This is a plugin for Mozilla browsers (Firefox, Netscape, 
Google Chrome, Chromium etc.). It adds media player support for these
browsers under Linux. Since for Windows there is the Media Player
for Firefox plugin, I haven't developed yet a version for Windows. 

The reason for developing this lays in the fact that I just couldn't 
find a good enough media player plugin for Mozilla browsers under
Linux. The ones that I found are vlcplugin, gecko-mediaplayer
(based on gnome-mediaplayer) and xine-plugin. All of them have 
different problems. 

Libvlc is not working under Google Chrome or Chromium because 
is using an embedding method that is not accepted by Google and
under Firefox is extremly slow. 

Xine-plugin is extremly slow and does not have any options (when it 
works). 

The only one which worked decently has been gecko-mediaplayer. 
But this also has some problems. For example, it does not have seeking
capabilities and other problems. 

So I decided to develop my own plugin, based on vlc, which is in my 
oppinion the best media player out there. The only dependency it
has is, of course, VLC. You have to have VLC installed on your system. 
And to compile it, you also need the Qt libraries and development
files. 

Features:
--------------------------

  - Javascript API compatible with Media Player Firefox plugin
  - Full screen capabilities
  - Playlist support (all the playlists that VLC supports)
  - Seeking capabilities
  - WMV compatible

Important:
--------------------------
Apparently (at least on my system), Firefox has a problem with the
plugin related with the /usr/share/vlc/lua/meta/reader/filename.luac 
file. So, if the plugin crashes in Firefox, just remove that file. 
Personally, I don't know what that file is used for. If anybody
knows what the problem is or what that file is used for, please 
let me know. 

Javascript:
--------------------------
The plugin exposes a javascript API compatible with the Media Player 
Firefox's javascript API. Please find bellow a list of properties, 
method and events supported:

	Properties:
		- src
		- autoStart (is not considered for playlists)
		- baseURL
		- mute
		- volume
		- SendPlayStateChangeEvents
		- uiMode (only "full", "invisible" and "none" modes)
		- currentPosition
		- ShowTracker
		- AllowScan
		- bgColor
		- AllowFullScreen
		- EnableContextMenu
	
	Methods:
		- play
		- stop
		- pause
		- previous
		- next
		- fastForward
		- fastReverse (just for compatibility, because VLC does not 
			support it, so this method will have no effect, but it will
			not return a javascript error)
		- isAvailable
		
	Events:
		- PlayStateChange
		- PositionChange
		
For a documentation on all these methods, properties and events, 
please see the Microsoft site: 
http://msdn.microsoft.com/en-us/library/dd563945(v=VS.85).aspx

I've tried to make it compatible with the Media Player control, made
by Microsoft. 

Of course, there are many javascript elements missing. However, I've 
tried to implement the most important ones. 

Enjoy.