A quick .mka thumbnailer for FreeDesktop (e.g. Nautilus)

Go to file

Elias Schriefer 65fb9f5432 Fix PNG thumbnail streams not being found		2024-04-17 15:50:13 +02:00
ffmpeg-mka-thumbnailer	Fix PNG thumbnail streams not being found	2024-04-17 15:50:13 +02:00
ffmpeg-mka.thumbnailer	Add script and config	2024-04-12 18:04:43 +02:00
LICENSE	Initial commit	2024-04-12 12:23:38 +00:00
README.md	Update README.md	2024-04-12 13:00:18 +00:00

README.md

ffmpeg-mka-thumbnailer

A quick .mka thumbnailer for FreeDesktop (e.g. Nautilus)

Dependencies

ffmpeg-mka-thumbnailer uses FFmpeg for accessing the cover attachments. This could also be replaced with MKVToolNix. For parsing ffprobe output, jq is used.

To convert the album cover to other formats (mainly PNG) ImageMagick (convert tool) is used. This could probably be dropped in favour of FFmpeg.

The script itself is written in ZSH, although this could also be easily translated to Bash as well.

Installation

Assuming all the dependencies are installed, you'll need to do the following:

Clone this repo or download the code
Copy ffmpeg-mka-thumbnailer into a folder that is in your desktop environment's $PATH, e.g. /usr/local/bin/
Copy ffmpeg-mka.thumbnailer into ~/.local/share/thumbnailers/

For the thumbnailer to work, you'll need to restart your file manager and (optionally) clear your thumbnail cache:

e.g. nautilus -q for exiting all Nautilus instances
rm -r ~/.cache/thumbnails/ or rm ~/.cache/thumbnails/fail/* for only the failed attempts

License

This project is licensed under Apache 1.0. Issues and PRs are welcome!