SubtitleSwitcher is a powerful plugin for the AVideo platform. It allows users to upload or manually create subtitles, supporting .srt and .vtt files. In addition to these features, SubtitleSwitcher integrates with the offline speech recognition toolkit Vosk, enabling automatic transcription of videos and audios.

⚠️ Note: The Vosk transcription functionality is deprecated.
✅ For improved transcription quality, it is recommended to use the AI Plugin:
AI Plugin – Automatic Transcription

This tutorial will guide you through the installation and configuration of the SubtitleSwitcher plugin and the Vosk transcriber.

Upon installation of the SubtitleSwitcher plugin, several options are available for customization:

• subtitleDivStyle: Defines the appearance of the subtitle section.
• disableSubtitleSettings: If enabled, the user won't be able to modify subtitle settings.
• disableUTF8Encode: Turns off UTF8 encoding for subtitles.
• addClosedCaptionIcons: Adds icons to the closed captions.
• defaultSubtitleIsOff: Defines if subtitles are turned off by default.
• defaultSubtitleLanguage: Sets the default subtitle language.
• defaultSubtitleLanguageUseUserLocation: If enabled, the default subtitle language is based on the user's location.
• automaticTranscript: If enabled, use Vosk transcriber for automatic transcriptions. (Deprecated)
• automaticTranscriptModelPath: Sets the file path for the Vosk language model.

Once the plugin is enabled, two new options will appear in the video manager:

• Create Subtitle: Opens an editor to manually create subtitles by setting the start/end times and the subtitle text.
• Upload Subtitle: Allows for uploading .srt or .vtt files.

Vosk is an offline speech recognition toolkit that supports multiple languages. The Vosk-transcriber is a Python package that utilizes the Vosk library to transcribe audio files. By installing Vosk-transcriber in Ubuntu, you can enable the SubtitleSwitcher plugin to automatically transcribe videos and audio.

⚠️ Important: The Vosk integration is deprecated.
For a modern and more accurate alternative, please refer to the AI Plugin – Automatic Transcription

Before installing new packages, it's a good practice to update your system. Open a terminal and run:

sudo apt update && sudo apt upgrade

The easiest way to install the Vosk API is with pip. You do not have to compile anything.

• Python version: 3.5–3.9
• pip version: 20.3 or newer

pip3 install vosk

More information: https://alphacephei.com/vosk/install

Download a pre-built model from:

• Vosk Models Page
• GitHub Models List

Example:

wget https://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip

unzip vosk-model-small-en-us-0.15.zip