Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mutschler/mt
yet another media thumber. Generate Video Contat Sheets easily. http://mutschler.github.io/mt
https://github.com/mutschler/mt
contactsheet ffmpeg golang multimedia thumbnails video
Last synced: 4 days ago
JSON representation
yet another media thumber. Generate Video Contat Sheets easily. http://mutschler.github.io/mt
- Host: GitHub
- URL: https://github.com/mutschler/mt
- Owner: mutschler
- License: gpl-3.0
- Created: 2016-04-14T14:31:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-18T18:45:39.000Z (4 days ago)
- Last Synced: 2024-12-18T19:37:54.235Z (4 days ago)
- Topics: contactsheet, ffmpeg, golang, multimedia, thumbnails, video
- Language: Go
- Homepage:
- Size: 7.49 MB
- Stars: 157
- Watchers: 9
- Forks: 23
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://gitter.im/media-thumber/Lobby)
[](https://travis-ci.org/mutschler/mt) [](https://github.com/mutschler/mt/releases/latest) [](https://github.com/mutschler/mt/releases/latest)
# mt
mt is a lightweight media thumbnailer. it aims to be a simple and fast alternative to outlayers awesome [Video Contact Sheet](http://p.outlyer.net/vcs/)
## Download
you can download the latest version [](https://github.com/mutschler/mt/releases/latest) from [githubs release page](https://github.com/mutschler/mt/releases/latest) alternatively you can install `mt` from source as descibed down below
## Installation from Source
`mt` uses depends on ffmpeg's libraries, so you'll need those installed (for windows you might want to have a look [here](https://github.com/mutschler/mt/issues/44#issuecomment-1773288147))and then run:
```
go get github.com/mutschler/mt
go install github.com/mutschler/mt
```
if you'll have ffmpeg installed in a non standart directory you'll may have to use PKG_CONFIG_PATH variable like this:
```
LD_LIBRARY_PATH=/path/to/ffmpeg/lib/ PKG_CONFIG_PATH=/path/to//ffmpeg/lib/pkgconfig/ go build
```
## Settings
Default Settings can be alternated via config files in JSON format, there are 3 directories in which the config can be saved:
`/etc/mt/`, `$HOME/.mt/` and the current working directory
just create a file called `mt.json` in any of this locations to change the settings
to change settings on runtime you can either use the provided pflags (use `mt --help` for more info) or set environment Variables with the `MT_` prefix:
`mt --numcaps=20 myvideo.mkv` will change the numcaps settings to 20 for this run only, so will `MT_NUMCAPS=20 mt myvideo.mkv`
since v 1.0.3-dev there is an option to save the current settings to a specified config file:
`mt --save-config=/path/to/config.json`
and load a custom config on runtime:
`mt --config-file=/path/to/config.json`
## Available Config Options:
| name | default value | description |
| ---- | ----- | ----------- |
| numcaps | 4 | number of screenshots to take |
| columns | 2 | how many columns should be used |
| padding | 5 | add a padding around the images |
| width | 400 | width of a single screenshot |
| height | 0 | height of a single screenshot |
| font_all | "Ubuntu.ttf" | Font to use for timestamps and header |
| font_size | 12 | font size |
| disable_timestamps | false | option to disable timestamp generation |
| timestamp_opacity | 1.0 | opacity of the timestamps must be from 0.0 to 1.0 |
| filename | {{.Path}}{{.Name}}.jpg | filename for the generated file |
| verbose | false | verbose logging |
| bg_content | "0,0,0" | RGB values for background color |
| from | "00:00:00" | starting timestamp |
| to | "00:00:00" | end timestamp |
| single_images | false | will create a single image for each screenshot |
| header | true | append a header with file informations |
| header_meta | false | append codec, bitrate and FPS to header |
| bg_header | "0,0,0" | header background color |
| fg_header | "255,255,255" | header font color |
| header_image | "" | absolute path to an image that should be added to the header |
| watermark | "" | absolute path to an watermark image that will be added to the middle image of the contact sheet |
| comment | "" | comment that will be added to the bottom-left of the header |
| watermark_all | "" | absolute path to an image that will be added to the bottom left corner of each image |
| filter | "none" | choose a filter to add to the thumbnails: "greyscale", "invert", "fancy", "cross" |
| skip_blank | false | try up to 3 times to skip a blank image (can slow down mt) |
| skip_blurry | false | try up to 3 times to skip a blurry image (can slow down mt) |
| sfw | false | EXPERIMENTAL nude detection |
| skip_existing | false | skip movie if there is already a jpg with the same name |
| overwrite | false | by default mt will increment the filename by adding -01 if there is already a jpg use --overwrite to overwrite the image instead |
| fast | false | makes mt faster a lot, but seeking will be more inacurate and may produce duplicate screens |
| webvtt | false | create a webvtt file for use with html5 video players |
| interval | 0 | creates a screencap every interval seconds, this overwrites numcaps |
| skip_credits | false | try to skip movie credits by cutting of 4 minutes or 10% of the length |
| webvtt | false | generate a webvtt file |
| blur_threshold | 62 | threshold for blur detection |
| blank_threshold | 85 | threshold for blank image detection |
| upload | false | upload the generated image |
| upload_url | "" | url to send the image to |
## Upload Info
`upload` needs `upload_url` to be set as well. You'll need a simple script on the Server that saves the content of `$_FILES["image"]`
Uplad URL Example script:
```
```
please note that all those values are also available as runtime pflags just replace the `_` with an `-` ex: `single_images` will get `single-images`
## Usage
just run `mt` and provide any video file as args:
`mt video.avi`
Some of the settings can be changed through runtime flags provided directly to `mt` for more information just run `mt --help`
### example:
more examples can be found in the example older
