Skip to content

Commit

Permalink
0.1.0
Browse files Browse the repository at this point in the history
- initial release
  • Loading branch information
radiantmediaplayer committed Jul 2, 2018
1 parent 0fa89f9 commit c87afe3
Showing 1 changed file with 10 additions and 8 deletions.
18 changes: 10 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# rmp-create-vtt-thumbnails

An helper script to easily create VTT files that works with [Radiant Media Player preview thumbnails feature](https://www.radiantmediaplayer.com/docs/latest/preview-thumbnails.html).
A helper script to easily create VTT files that works with [Radiant Media Player preview thumbnails feature](https://www.radiantmediaplayer.com/docs/latest/preview-thumbnails.html).

First you will need to create a mosaic of thumbnails with FFmpeg [as described here](https://www.radiantmediaplayer.com/docs/latest/preview-thumbnails.html#preview-thumbnails-ffmpeg).

Once this is done you can download this script to automatically create a VTT file that will work with this mosaic of thumbnails in [Radiant Media Player](https://www.radiantmediaplayer.com).

For more information on the VTT format used [see this documentation section](https://www.radiantmediaplayer.com/docs/latest/preview-thumbnails.html#preview-thumbnails-introduction).

This script (create.js) is in alpha stage and may need improvement. It has been tested for node.js 8.11+ on Windows 10.
This script (create.js) is in alpha stage and may need improvement. It has been tested for node.js 8.11+ on Windows 10 and Ubuntu 16 LTS.

## Usage from the command line
```
Expand All @@ -22,19 +22,21 @@ See assets/ folder for ready-to-use mosaic image examples. See output/ folder fo

`node create.js duration spriteFileLocation outputVTTFileName gapBetweenFrames thumbnailWidth thumbnailHeight tileSize`

All parameters are mandatory.

`duration`: content duration in seconds

`spriteFileLocation`: location for the mosaic image (a.k.a. sprite image)
`spriteFileLocation`: location for the mosaic image (a.k.a. sprite image) to reference in the resulting VTT file

`outputVTTFileName`: location to write the output VTT file related to the input `spriteFileLocation`
`outputVTTFileName`: location for the produced output VTT file

`gapBetweenFrames`: the gap in seconds between frame extraction
`gapBetweenFrames`: the gap in seconds between frame extraction (value used for generating the mosaic image with FFmpeg)

`thumbnailWidth`: the thumbnail width within the mosaic
`thumbnailWidth`: the width of each thumbnail within the mosaic

`thumbnailHeight`: the thumbnail height within the mosaic
`thumbnailHeight`: the height of each thumbnail within the mosaic

`tileSize`: the tile format used to generate the mosaic (example 11 for 11x11, 6 for 6x6 ...)
`tileSize`: the tile format used to generate the mosaic (value used for generating the mosaic image with FFmpeg: 11 for 11x11, 6 for 6x6 ...)

## Issues
Issues should be submitted in this GitHub page. We will do our best to review them.
Expand Down

0 comments on commit c87afe3

Please sign in to comment.