mkvbot

command module
v0.5.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 18, 2025 License: MIT Imports: 24 Imported by: 0

README

mkvbot

Overview

mkvbot streamlines ripping the "best" title from a Blu-ray or DVD using MakeMKV. It runs a simple processing loop:

  1. Wait for a disc
  2. Search IMDb for movie metadata needed for Plex-friendly file names
  3. Identify and rip the best title
  4. Eject the disc

mkvbot has limited functionality and is not fully automated. That might work for you. It works for me. If you are looking for something more complex, maybe check out a project like automatic-ripping-machine.

mkvbot is designed to be lightweight and portable. It is a single executable that can run on an old Raspberry Pi.

Installation

mkvbot requires makemkv.

Release

Find an appropriate package for your operating system and architecture on the Releases page.

Homebrew
brew tap curt-hash/homebrew-mkvbot
brew install mkvbot
Go Install
go install github.com/curt-hash/mkvbot@latest # or a tag like @v0.3.0

Usage

mkvbot is a terminal program with a text-based user interface (TUI). Open a terminal and run the executable (mkvbot or mkvbot.exe depending on platform):

mkvbot.exe --output-dir Z:\\path\\to\\Movies

Run mkvbot.exe -h to see all of the command-line options.

Since it does not always pick the correct title or movie metadata, it currently prompts for confirmation. It will also prompt you to choose the best title if there is a tie. That may change as it gets smarter.

Audio track and subtitles selection is based on the value of app_DefaultSelectionString in profile.xml. For whatever reason, makemkvcon (the CLI application) does not seem to honor the selection string set in the GUI application preferences.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg
eject
Package eject provides a cross-platform Eject function that attempts to eject a disc given the volume name.
Package eject provides a cross-platform Eject function that attempts to eject a disc given the volume name.
makemkv/defs
Package defs defines a subset of attributes and codes used by makemkv to describe discs, titles, and streams.
Package defs defines a subset of attributes and codes used by makemkv to describe discs, titles, and streams.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL