It's better when it's simple

User Tools

Site Tools



You can include external and internal videos with curly brackets. The basic syntax is

{{video.mp4|A funny video}}

See images for the full syntax, alignment and resizing. DokuWiki should at least support ogv, webm and mp4 format, but see supported media formats for a more up to date list.

Fallback Formats

Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.

For example consider this embedded mp4 video:

{{video.mp4|A funny video}}

When you upload a video.webm and video.ogv next to the referenced video.mp4, DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.

Poster image

Additionally DokuWiki supports a “poster” image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a video.jpg file would work.


Starting with version that are newer than 2017-02-19e “Frusterick Manners”, DokuWiki supports video subtitles. As for the poster image, or the alternate video format, nothing special is needed. Just upload your subtitles files in Web Video Text Tracks Format (vtt) alongside the video file and you're done. This means you can easily add subtitles to existing videos. vtt-files have to be named after the video file but with extensions that indicate both the kind of track and the language. Most of the time, the kind will be sub which means “standard subtitle”. See the table below for the full list.

For example, to add French and German subtitles to video foo.mp4 simply upload vtt files and DokuWiki and your browser will take care of the details.

DokuWiki supports all kinds defined by the W3C, but user experience may vary, depending on browser and installed software.

Kind code Meaning Description
sub subtitles Usual subtitles
cap captions Subtitles for the hard of hearing
des descriptions Audio description for the visually impaired
cha chapters Chapter titles used when the user is navigating the media resource
met metadata Technical info about the media

Hint: If you need to convert existing subtitles to web vtt format, you can use an online subtitle converter. For example, to convert your SubRip Text (SRT) subtitles, you can use srt2vtt. But ask your favorite search engine, there exists many such free sites that can handle almost any subtitle format.

video.txt · Last modified: 2018-04-25 16:29 by andi

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki