Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/flavioribeiro/video-thumbnail-generator
:camera: Generate thumbnail sprites from videos.
https://github.com/flavioribeiro/video-thumbnail-generator
frames image multimedia photo sprites thumbnail-sprites thumbnails video video-thumbnail-generator
Last synced: 13 days ago
JSON representation
:camera: Generate thumbnail sprites from videos.
- Host: GitHub
- URL: https://github.com/flavioribeiro/video-thumbnail-generator
- Owner: flavioribeiro
- License: apache-2.0
- Created: 2015-11-16T23:29:07.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-19T18:25:47.000Z (8 months ago)
- Last Synced: 2024-08-06T21:40:34.744Z (3 months ago)
- Topics: frames, image, multimedia, photo, sprites, thumbnail-sprites, thumbnails, video, video-thumbnail-generator
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 304
- Watchers: 17
- Forks: 69
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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 [email protected]: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 []
./generator (-h | --help)
./generator --version
Options:
-h --help Show this screen.
--version Show version.
Video filepath.
Interval em seconds between frames.
Width of each thumbnail.
Height of each thumbnail.
Total number of thumbnails per line.
Output.
[] Number of files to process in parallel
```
## Example
**Single file**
```shell
$ ./generator samples/sample.mp4 60 300 200 2 output/sample.mp4.png
[sample.mp4] Extracting frame 1/3
[sample.mp4] Extracting frame 2/3
[sample.mp4] Extracting frame 3/3
[sample.mp4.png] Savedacted.
Saved!
```
**Directory**
```shell
$ ./generator samples/ 60 300 200 2 output/
[sample copy.mp4] Extracting frame 1/3
[sample.mp4] Extracting frame 1/3
[sample copy.mp4] Extracting frame 2/3
[sample.mp4] Extracting frame 2/3
[sample copy.mp4] Extracting frame 3/3
[sample.mp4] Extracting frame 3/3
[sample copy.mp4.png] Saved
[sample.mp4.png] 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).