Skip to content

VideoHLS Plugin

Daniel Neto edited this page Nov 9, 2024 · 24 revisions

The VideoHLS Plugin is designed specifically for VOD (Video-On-Demand) videos, offering a range of benefits to enhance your video streaming experience. With this plugin enabled, your VOD content will be delivered in HLS format, providing various advantages to both content creators and viewers.

HLS Encoding and Adaptive Bitrate

  • The plugin unlocks the HLS (HTTP Live Streaming) option on the encoder, enabling adaptive bitrate streaming for your videos. HLS automatically adjusts the resolution based on the viewer's internet connection, ensuring smooth playback without buffering or lag.

  • Your VOD files will be encrypted, making it more challenging for external downloaders to access your videos. This enhances content security and protects your encryption key from unauthorized use.

  • Enabling HLS format means that the conventional download button will no longer be available for viewers, adding an extra layer of protection.

  • As a content creator, you can whitelist the encoder's IP address in the plugin's parameters to allow the encoder to download videos for thumbnail extraction, even with download protection enabled.

Uploading Audio Tracks

The Audio Track feature allows you to upload additional audio tracks (in MP3 format) for your videos, enabling multilingual support or alternative voiceovers.

Compatibility Requirements

  1. Encoder Version
    The Audio Track feature requires videos to be encoded with Encoder version 6.0 or higher.

  2. Storage Compatibility
    The Audio Track feature is compatible with:

Important Note: The Audio Track feature will not work with YPT Storage. Please ensure your storage method is either CDN Storage or Local Storage to use this feature.

How to Upload an Audio Track

  1. Go to the Videos Manager and click on the "Upload Audio Tracks" button.

chrome-capture-2024-8-9 (1)

  1. In the upload form:
    • Select the MP3 file to upload.
    • Enter the language name (e.g., "English", "Spanish").
    • Optionally, set the uploaded track as the default audio track.
  2. Submit the form to upload and add the audio track to the video.

The audio tracks will be available for viewers to choose from while playing the video.

Changing Audio Track

chrome-capture-2024-8-9

AI Dubbing Integration

In addition to manually uploading audio tracks, the AI Dubbing feature allows you to automatically generate and upload dubbed audio tracks in different languages using artificial intelligence.

AI Dubbing Feature Overview

  • The AI Dubbing feature will translate and dub the video's original audio into other languages using AI.
  • Once the AI-generated audio is ready, it can be uploaded and added as an audio track in the same way as manually uploaded tracks.
  • This feature allows you to expand your content’s accessibility by providing dubbed versions in multiple languages without manual voiceover work.

Note: The AI dubbing feature translates the audio from one language to another and dubs the video automatically. To ensure this works properly, the video must be in HLS format and encoded using Encoder version 6.0 or later. You can update the encoder by running git pull to get the latest version.

Sample Videos with AI Dubbing

Here are some examples of how the AI dubbing feature works:

You can also refer to the AI Plugin Documentation for more information.

Download Protection

The Download Protection feature ensures that your video content remains secure and accessible only through the designated player. This feature aims to protect the HLS .key file, which contains the decryption key necessary to access your videos.

How Download Protection Works

  1. Exclusive Player Access: Only the designated player can play the HLS videos, preventing unauthorized access even if someone gains access to the .m3u8 and .ts files.

  2. Tokenized Key Access: A token is added to the .key file within the .m3u8 playlist, ensuring that only your AVideo platform can access it.

  3. Performance Considerations: While each request for the .key file adds some CPU overhead, it is minimal due to efficient request handling.

If you wish to disable download protection, you can do so by unchecking the 'downloadProtection' option in the VideoHLS plugin settings.

Adaptive Bitrate

The adaptive bitrate feature ensures that each viewer receives the best video quality based on their internet speed, dynamically adjusting to provide a seamless viewing experience.

Automatic HLS Resolutions

Your videos will automatically be converted to various resolutions, such as:

  • 2160p (4K)
  • 1440p (2K)
  • 1080p (Full HD)
  • 720p (HD)
  • 480p (SD)
  • 360p
  • 240p

This ensures an optimal viewing experience for all users, regardless of their internet speed.

Storage Options

While the HLS format does not support AWS_S3, BlackBlaze_B2, or FTP_Storage plugins, you can use other options such as the YPTStorage plugin or the CDN Storage plugin to expand your storage capabilities.


By using the VideoHLS Plugin, you can deliver an optimized and secure viewing experience, provide multilingual audio options, and ensure smooth, adaptive streaming for VOD content.

Clone this wiki locally