Extension:OggHandler

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
OggHandler

Release status: beta

Implementation Media
Description Integrated support for Ogg Theora, Vorbis, Speex
Author(s) Tim Starling
MediaWiki 1.11+
License LGPL
Download Download snapshot
Subversion [Help]

Browse source code
View code changes

README

Check usage (experimental)

OggHandler is an extension which allows you to display Ogg audio and video files in wiki pages, using the same syntax as for image files. It also has limited support for metadata display on file description pages.

Contents

[edit] Syntax synopsis

Where Video.ogg is an Ogg Theora file and Audio.ogg is an Ogg Vorbis file:

[[File:Video.ogg]] 
Display a video at its nominal size. Displays a still image from the midpoint with a play button to start an embedded player.
[[File:Audio.ogg]]
Show a placeholder for a sound file, with a play button to start an embedded player.
[[File:Video.ogg|thumb]] 
Show a video in a floating thumbnail box
<gallery>File:Video.ogg</gallery>
Show a video embedded in an image gallery
[[File:Video.ogg|noicon]], [[File:Audio.ogg|noicon]]
Hide the help icon.
[[File:Video.ogg|noplayer]], [[File:Audio.ogg|noplayer]]
Show still image or placeholder icon only, do not embed player.
[[File:Video.ogg|thumbtime=1:25]]
Use a frame from 1 minute 25 seconds into the video as the placeholder image. A single number is taken as an offset in seconds.

[edit] Client support

We have explicit support for the following video players:

We have generic support for clients which claim to support application/ogg in navigator.mimeTypes, and for clients which recognise the <video> tag.

See /Test matrix for more information. Clients with no player available are directed to /Client download.

[edit] Installation

To install this extension, add the following to the end of your LocalSettings.php:

require( "$IP/extensions/OggHandler/OggHandler.php" );

[edit] Configuration

After the require line, add this to your LocalSettings.php:

$wgFFmpegLocation = '/usr/bin/ffmpeg';

you may need to change the path to your ffmpeg. You can find yours by typing: which ffmpeg

You can get better results from oggThumb if you have version 0.9 (unreleased?) of oggvideotools installed, which you will probably have to do from source. (oggvideotools 0.8 does not work as it is missing required output options.)

$wgOggThumbLocation = '/usr/local/bin/oggThumb';

[edit] Installing ffmpeg on debian

On debian etch 4.0 type: aptitude update; aptitude install ffmpeg ffmpeg2theora

you may also like to have a look at aptitude search ffmpeg

[edit] Requirements

Requires FFmpeg and PEAR. Requires web access to $wgScriptPath/extensions/OggHandler. See the README file for more information.

[edit] See also



Language: English  • 日本語 • Tiếng Việt
Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox