Home

This is the documentation of the plugin piwigo-videojs. Feel free to edit it, any contributions are appreciated.

The piwigo-videojs main goal was to provide an easy way to play videos. Today, it is essentially used to create thumbnails and extract metadata of videos so that they can be displayed properly in an album of a Piwigo.

With piwigo-videojs, you can:

• extract metadata and create a poster for a smooth integration into albums from the Sync plugin page, the Piwigo batch manager or the Edit Photo Properties page,
• playback video with the native player of your browser (recommended) or the open source HTML5 video player VideoJS,
• display video metadata in the EXIF section,
• customise the VideoJS video player

Installation & Configuration

After installation, you must configure your Piwigo with the LocalFiles Editor plugin and install ExifTool, FFmpeg or MediaInfo on your server to extract metadata and generate posters of a video. If ExifTool, FFmpeg or MediaInfo cannot be installed, we explain here how to upload posters manually.

Plugin Interface

• The Configuration tab provides options for choosing a player (Native Browser, Video.js v7, Video.js v6,…) and configuring it (auto-play, loop, volume, etc.).
• The Sync tab allows to extract metadata when ExifTool, FFmpeg or MediaInfoare available. If FFmpeg is installed, you can also create posters and thumbnails automatically. If not, an option allows to adopt posters uploaded manually.

Piwigo Integration

• The plugin adds VideoJS and Rotate tabs to the Photo Properties page:
  • VideoJS allows to extract metadata and create a poster according to the plugin settings. It also provides a command for deleting the VideoJS thumbnails and additional video sources.
  • Rotate allows to set the rotate metadata so that Piwigo knows how to orient the video. This is useful for videos that do not include an orientation metadata and which are displayed with a VideoJS player in conjonction with the videojs-zoomrotate plugin. The video and its poster remain untouched. Only the orientation parameter stored in the database is updated.
• The plugin also adds a Video metadata and posters action to the Batch Manager which permits to extract metadata when ExifTool, FFmpeg or MediaInfoare available and generate posters if FFmpeg is available or if posters have been uploaded manually.

VideoJS Documentation

Please check VideoJS Documentation for additional information.

Translation

You can help by translating the plugin in your language from the translate tool from Piwigo. Many thanks to the contributors.

Support

• Please look at the forums if you encounter any issues.
• To report bugs and suggest new features, please create a new issue.