A command-line utility for extracting attachments (subtitles, fonts and chapters) of MKV files.
- 🐋 Docker
MKVexport requires 1 volume to be mounted: /app/input.
docker run -it --rm \
-u $(id -u):$(id -g) \
-v ${PWD}/input:/app/input \
ghcr.io/toshy/mkvexport:latest -hCreate a compose.yaml file.
services:
mkvexport:
image: ghcr.io/toshy/mkvexport:latest
volumes:
- ./input:/inputThen run it.
docker compose run -u $(id -u):$(id -g) --rm mkvexport -hExtracted file attachments will always be put into a newly created directory based on the filename of the input file.
|-- never-gonna-give-you-up.mkv
|-- never-gonna-give-you-up
|-- attachments
|-- Arial.ttf
|-- ...
|-- COMIC.TTF
|-- chapters.xml
|-- tags.xml
|-- track4_eng.ass
|-- ...
|-- track8_jpn.ass
In the above example, our file never-gonna-give-you-up.mkv, will yield a directory named never-gonna-give-you-up.
This directory will contain a chapters file chapters.xml, a tags file tags.xml, subtitles (which are named in the
format track{id}_{iso639-3}.{extension}) and a subdirectory attachments containing the fonts.
When no arguments are provided, MKVexport will automatically export attachments for all files mounted to the /app/input directory.
Let's say you have some files in a subdirectory called latest-hits (./rick-astley/latest-hits) and you want to extract attachments
for just those files.
docker run -it --rm \
-u $(id -u):$(id -g) \
-v ${PWD}/rick-astley:/app/input \
ghcr.io/toshy/mkvexport:latest \
-i "latest-hits"Let's say you have a file called never-gonna-give-you-up.mkv (./rick-astley/never-gonna-give-you-up.mkv) and you want to extract attachments
for just that file
docker run -it --rm \
-u $(id -u):$(id -g) \
-v ${PWD}/rick-astley:/app/input \
ghcr.io/toshy/mkvexport:latest \
-i "never-gonna-give-you-up.mkv"- ☑️ Pre-commit.
- 🐋 Docker Compose V2
- 📋 Task 3.37+
Setting up pre-commit code style & quality checks for local development.
pre-commit installThis repository comes with a MIT license.