
===============================================
==== Use case adding subtitle to a video ======
===============================================

What we have: A video file (*.mp4) with one or more persons speaking.
The video has no subtitle track; the language is German.

What we want: Create a subtitle track of max 6 words each that can be seen in the video.

Solution: Web Interface Pipeline

=================================================
=============== Procedure =======================
=================================================

* go to http://clarin.phonetik.uni-muenchen.de/BASWebServices

* go to service Pipeline

* upload Video_100sec_deu-DE.mp4 (in the directory where this README is)
  by dropping the file in the grey upload area and clicking 'Upload'.

* choose the following options (leaving all other options at defaults):
    Pipeline name = ASR_G2P_CHUNKER_MAUS_SUBTITLE
    Language = German (DE)
    Output format = srt
  SRT is a standardized subtitle format that is recognized by most players.

* open the 'Expert Options' (by clicking on them). Under
    'Maximum subtitle length' enter "6"
  This will restrict the length of each subtitle to max. 6 words.

* click 'Run Web Service'

What happens now: the BAS webservices pass your video through a chain of 4 services:
- the first service 'ASR' will use the next available German speech recognizer to 
produce a transcript of what was spoken in the video
- the service 'G2P' will produce a standard pronunciation from this transcript
- the service 'CHUNKER' will align this pronunciation to the video soundtrack and 
detect ways to automatically cut the video into smaller portions; this is especially 
important if you are using long videos with more than 3000 words
- the service 'MAUS' will make the exact alignment of spoken words to transcribed words
- and finally the service 'SUBTITLE' will create a subtitle file based on the MAUS results

* download the result file Video_100sec_deu-DE.srt and save it in 
  this directory (where this README is)

* open VLC video player (or any other video player) and open the video.
  VLC will recognize the subtitle track by its name and automatically enable it;
  other players might need you to open the subtitle file explicitly or to 
  select the subtitle track.

