84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
# Video thumbnail generator
|
|
Generate thumbnail sprites from videos.
|
|
|
|
## Why
|
|
|
|
|
|
|
|
Almost all video players enhances user's seekbar navigation by providing a thumbnail preview of the moments where the user want to seek, so generate this sprites shouldn't be hard. This is a python script that, given a video, generates a thumbnail sprite image from it.
|
|
|
|
## Build
|
|
|
|
1. Clone it:
|
|
|
|
```sh
|
|
$ git clone git@github.com:flavioribeiro/video-thumbnail-generator.git
|
|
```
|
|
|
|
2. Then go to the project's folder:
|
|
|
|
```sh
|
|
$ cd video-thumbnail-generator
|
|
```
|
|
|
|
3. And finally run:
|
|
```shell
|
|
$ chmod a+x build && ./build
|
|
```
|
|
|
|
## Run
|
|
```shell
|
|
$ ./generator --help
|
|
Video Thumbnail Generator
|
|
|
|
Usage:
|
|
./generator <video> <interval> <width> <height> <columns> <output>
|
|
./generator (-h | --help)
|
|
./generator --version
|
|
|
|
Options:
|
|
-h --help Show this screen.
|
|
--version Show version.
|
|
<video> Video filepath.
|
|
<interval> Interval em seconds between frames.
|
|
<width> Width of each thumbnail.
|
|
<height> Height of each thumbnail.
|
|
<columns> Total number of thumbnails per line.
|
|
<output> Output.
|
|
<parallelism> Number of files to process in parallel
|
|
```
|
|
|
|
## Example
|
|
**Single file**
|
|
```shell
|
|
$ ./generator videos/27467_1_milkbots_wg_720p.mp4 2 126 73 10 thumbnails.jpg
|
|
Extracting 5 frames
|
|
[####################################] 100%
|
|
Frames extracted.
|
|
Saved!
|
|
```
|
|
|
|
**Directory**
|
|
```shell
|
|
$ ./generator videos/ 2 126 73 10 thumbnails/
|
|
Extracting 5 frames
|
|
[####################################] 100%
|
|
Frames extracted.
|
|
Saved!
|
|
```
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
1. Fork it!
|
|
2. Create your feature branch: `git checkout -b my-awesome-new-feature`
|
|
3. Commit your changes: `git commit -m 'Add some awesome feature'`
|
|
4. Push to the branch: `git push origin my-awesome-new-feature`
|
|
5. Submit a pull request :]
|
|
|
|
## License
|
|
|
|
This code is under [Apache License](https://github.com/flavioribeiro/video-thumbnail-generator/blob/master/LICENSE).
|