Exabyte.io Internal Documentation

Uploading/Updating Tutorial Videos

Follow the below instructions to upload/update a tutorial video:

Create a metadata file similar to the one in here.

Note: For each step, the time elapsed between startTime and endTime should approximately be the duration of the spoken sentence. I.e. this is almost impossible to get right on the first try and will need further refinement.
Make sure to remove youTubeId. This field is automatically added by the video manager script once the video is uploaded.
In metadata file, descriptionLinks is a list of links which are added to video description. See description template for more details.
Run the below command to add voice to the video:
```
python video-manager.py voiceover --file PATH_TO_ORIGINAL_VIDEO --metadata PATH_TO_METADATA --audio PATH_TO_SAVE_AUDIO --output PATH_TO_SAVE_NEW_VIDEO
```
whereby PATH_TO_SAVE_AUDIO and PATH_TO_SAVE_NEW_VIDEO should have the file extension .mp3 and .mp4, respectively.
Retry step 4 with adjusted youTubeCaptions data until the optimal outcome is achieved.
Before uploading, make sure that the timings of the youTubeCaptions sentences in the metadata file match exactly the duration of their pronunciations in the voiceover. This ensures that the subtitles will be synced correctly to the voice in the final online video version.

Run the below command to upload/update the video once metadata is ready:

python video-manager.py upload --file PATH_TO_VIDEO --metadata PATH_TO_METADATA

The video privacy status is set to unlisted by default. Pass privacy status as below to override it:

python video-manager.py update --file PATH_TO_VIDEO --metadata PATH_TO_METADATA --privacyStatus public

Use translate.py script to generate translated docs using Google API:

python translate.py -t 100

See script source for options. Use the below regex to fix image links in WebStorm once translation is done:

/ images / (\w+) /    <- contains a space as the final character
/images/$1/