Media Player for Audio/Video Files

Media Player for Audio/Video Files

TDL-hosted DSpace repositories feature an HTML5 media player that renders audio and visual media in an embedded player within the browser page. The player will appear as a thumbnail image for relevant items (see Thumbnails and the Media Player below) and on the Full Item page next to relevant files.

On this page:

Captioned Video and Audio Files

The media player will render captions for videos accompanied by a WebVTT captioning file. Below are instructions for adding captioning files to DSpace items from the DSpace Program documentation:

Video captioning requires that a WebVTT Caption file (.vtt) be uploaded into the DSpace Item (DSpace is not able to create or generate these .vtt files).  Here's an example of how to setup captioning:

  • The Item must already have a Bitstream which is a video file (in a "video/*" format) in the ORIGINAL bundle.  In this example, we'll assume it is named "myVideo.mp4"

  • Upload a corresponding WebVTT Caption file named "[video-filename]-[languageCode].vtt" to the ORIGINAL bundle. 

    • For a video named "myVideo.mp4", an English caption file would be named "myVideo.mp4-en.vtt". 

    • If an additional Spanish language caption file was uploaded, it should be named "myVideo.mp4-es.vtt".

    • All WebVTT Caption files MUST use two-letter ISO 639-1 Language Codes.  A list of all supported Language Codes can be found in "src/app/item-page/media-viewer/media-viewer-video/language-helper.ts"

  • Once the Caption file is uploaded, reload the video viewer (on the Item page). You should now see the "Captions" (or CC) option is now available. (Depending on the browser you use, this option may appear in the lower menu of the video, or require you to open an options menu.)  Selecting it will enable captioning in your language of choice.