28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
# imagorvideo
|
|
|
|
imagorvideo is a new initiative that brings video thumbnail capability through ffmpeg, built on the foundations of [imagor](https://github.com/cshum/imagor). imagor is a fast, Docker-ready image processing server written in Go with libvips.
|
|
|
|
Imagorvideo uses ffmpeg C bindings that extracts image thumbnail from video by attempting to select the best frame, then forwards to libvips to perform all existing image operations supported by imagor.
|
|
|
|
imagorvideo uses reader stream for mkv and webm video types. For other video types that requires seeking from a non seek-able source such as HTTP or S3, it simulates seek using memory buffer or temp file, by having the whole file to be fully loaded to perform seek.
|
|
|
|
**This project is a work in progress**. It also aims to be a reference project demonstrating imagor extensibility. Feel free to create a pull request or report an issue if you found bugs, suggestions or enhancements.
|
|
|
|
### Quick Start
|
|
|
|
```bash
|
|
docker run -p 8000:8000 shumc/imagorvideo -imagor-unsafe
|
|
```
|
|
|
|
Check out [imagor](https://github.com/cshum/imagor#image-endpoint) for all existing image operations supported.
|
|
|
|
### Configuration
|
|
|
|
Config options specific to imagorvideo. Check out [imagor](https://github.com/cshum/imagor#configuration) for all existing options supported.
|
|
|
|
```
|
|
-ffmpeg-fallback-image string
|
|
FFmpeg fallback image on processing error. Supports image path enabled by loaders or storages
|
|
```
|
|
|
|
|