/usr/share/xul-ext/video-without-flash/README.md is in xul-ext-video-without-flash 3.1.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | video-without-flash
===================
Firefox extension for watching videos without the flash plugin
Fetch video source of flash based media and play the video directly with
Firefox, without the use of the flash plug-in.
**Supported sites/embed video player**
* Youtube (partial support)
* Blip
* ScreenWaveMedia
* HTML5
* Dailymotion
* FC2
* niconico
Due to some minor variations of providing the video by a same media provider
(different version of there player, use of the embed tag) a few videos may
not be detected.
** Usage **
By default the video are detected when a page load, you can disable this
behavior in the preference pane and manually try to detect video by pressing
ALT-w.
**Why you may want to use this extension**
* You experienced some lag or bad CPU performance using flash
* You only use flash to watch videos, and do not want to install a non-free
packages on your linux station (this extension is released under the GPL)
**Pro tips**
*To read MP4 videos you must install a media plugin
like vlc-web-plugin or gecko-mplayer.
Under Windows the vlc web plugin can be install when running the vlc
install exe.
* The video can be save with a "right click / save as" on the
"open in a new tab" link.
* Numerous options in the preference pane : select preferred
format / quality when available, disable modules.
**Known bugs**
* YouTube : The video area is not reloading when clicking on a suggested video
link. After clicking on such a link, and no ALT-w command.
**How does it works**
VWOF Fetchs the direct link to videos using regular expression, XPath, and DOM.
A picture and a select control are displayed (the "video selector).
Clicking the video selector will open the video link into a video tag.
Each media provider is handled by a "parser". Javascript modules (.jsm) that
are loaded at startup.
The extension can fairly easy be extended due to it modular approache, as new
media provider can be added by implementing a new jsm file.
**Why a HTML5 parser ?**
For licensing reasons firefox did not support the H264 codec.
By using the HTML5 parser, you can read the video if a media player plugin is
installed as stated previously.
= Technical documentation for developers =
== How to write a new parser ==
Do not esitate to fork and add your own parser
* Step 1 : Add the name of your parser without the .jsm ext in vwof.parser_name
* Step 2 : Create a jsm file in the modules directory
The parser must respect the following API :
```javascript
var parser = {
BASE_URI: 'example.com',
//called when the current page url domain name is this.BASE_URI
parse_site: function(cw) {
var video_info = [];
...
return video_info;
},
//called if other parser did not return video link with parse_site
//as it does not make sens to search embed video in a video site
parse_embed: function(cw) {
var video_info = [];
...
return video_info;
}
};
```
=== video_info variable ===
video player is an array of hash
each video is an entry in the array and the hash contains video information
If the videos array contains more than one element a combo box (select tag)
will be added in the player displaying the format and quality
```javascript
video_info =
[
{
//DOM where the video selector / video tag will be embed
'player':,
//string link to the preview picture (or black background)
'video_img':,
videos =
[
{
//quality of the video (low, medium, hd720, hd1080)
'quality':,
//format of the video (webm, mp4, flv, ...)
'format':,
//direct link to the video
'url':
}
];
}
];
```
|