Skip to content
@freemkv

freeMKV

Latest release crates.io AGPL-3.0 Linux | macOS | Windows

freemkv

Open source 4K UHD / Blu-ray / DVD backup. One binary, no dependencies. Plug in your drive, rip to MKV.

Stream labels extracted automatically — audio purpose, codec detail, forced subtitles, language variants — metadata other tools miss. Bundled drive profiles. 17+ MB/s sustained.


Quick Start

1. Install

Linux:

curl -sL https://github.com/freemkv/freemkv/releases/latest/download/freemkv-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv freemkv /usr/local/bin/

macOS (Apple Silicon):

curl -sL https://github.com/freemkv/freemkv/releases/latest/download/freemkv-aarch64-apple-darwin.tar.gz | tar xz
sudo mv freemkv /usr/local/bin/

macOS (Intel):

curl -sL https://github.com/freemkv/freemkv/releases/latest/download/freemkv-x86_64-apple-darwin.tar.gz | tar xz
sudo mv freemkv /usr/local/bin/

Windows: Download freemkv-x86_64-pc-windows-msvc.zip, extract, run from Command Prompt.

From source: cargo install freemkv

All downloads

2. Set up decryption keys (one time)

DVD: No setup needed. CSS decryption works out of the box.

Blu-ray / 4K UHD: You need a KEYDB.cfg — a community-maintained AACS key database. freemkv cannot ship keys due to legal restrictions (same as every other BD ripping tool).

freemkv update-keys --url <your-keydb-url>

Saved to ~/.config/freemkv/keydb.cfg and used automatically from then on.

3. Rip

freemkv disc:// mkv://Movie.mkv

That's it. Scans the disc, decrypts, muxes to MKV with all streams and labels.


Docker Autorip

Insert a disc, walk away. Unattended ripping with a web dashboard.

docker pull ghcr.io/freemkv/autorip:latest
services:
  autorip:
    image: ghcr.io/freemkv/autorip:latest
    devices:
      - /dev/sr0:/dev/sr0
    ports:
      - 8080:8080
    volumes:
      - ./config:/config
      - /mnt/media:/output
    environment:
      - TMDB_API_KEY=your_key
    privileged: true

Open localhost:8080. Configure KEYDB URL and TMDB key in Settings. Insert disc — it rips, looks up the title, organizes into Movies/Title (Year)/Title.mkv, ejects, waits for the next one.


Why freemkv

  • Open source — pure Rust, AGPL-3.0, library on crates.io
  • It sees more — BD-J parsers extract stream labels other tools miss
  • It's fast — firmware upload removes riplock, adaptive batch sizing, 17+ MB/s
  • It decrypts — AACS 1.0 + 2.0, CSS — all transparent and automatic
  • It streams — disc, file, ISO, network, stdin/stdout — any source to any destination
  • It automates — Docker container with web UI, TMDB, webhooks

Streams

Stream Input Output URL
Disc Yes -- disc:// or disc:///dev/sg4
ISO Yes Yes iso://image.iso
MKV Yes Yes mkv://path
M2TS Yes Yes m2ts://path
Network Yes (listen) Yes (connect) network://host:port
Stdio Yes (stdin) Yes (stdout) stdio://
Null -- Yes null://

Examples

freemkv disc:// mkv://Dune.mkv                     # Rip to MKV
freemkv disc:// m2ts://Dune.m2ts                    # Rip to transport stream
freemkv iso://Dune.iso mkv://Dune.mkv               # ISO to MKV
freemkv m2ts://Dune.m2ts mkv://Dune.mkv             # Remux
freemkv disc:// network://10.1.7.11:9000            # Stream over network
freemkv network://0.0.0.0:9000 mkv://Dune.mkv      # Receive from network
freemkv disc:// stdio:// | ffmpeg -i pipe:0 ...     # Pipe to ffmpeg
freemkv info disc://                                 # Show disc info

Repos

freemkv CLI tool — all commands, flags, streaming examples
libfreemkv Rust library — API, 7 stream types, architecture, error codes. crates.io
autorip Automatic ripper — Docker, web UI, TMDB, webhooks. ghcr.io
bdemu Drive emulator — develop and test without real hardware

Supports LG, ASUS, HP, and other MediaTek-based BD-RE drives. Linux, macOS, and Windows. Pioneer planned.

Help expand drive support

freemkv info disc:// --share

Captures your drive's hardware profile and submits it as a GitHub issue. No disc data, no personal info, no keys. Use --mask to anonymize serial numbers.


CLI · Library · Autorip · Emulator · AGPL-3.0

Popular repositories Loading

  1. freemkv freemkv Public

    Open source 4K UHD / Blu-ray / DVD backup tool

    Rust 3

  2. bdemu bdemu Public

    4K UHD / Blu-ray / DVD drive emulator with hardware profiles

    Rust 1

  3. .github .github Public

    freemkv organization profile

  4. libfreemkv libfreemkv Public

    4K UHD / Blu-ray / DVD drive library — open source raw disc access

    Rust

  5. autorip autorip Public

    Automatic disc ripper — insert a disc, get an MKV

    Rust

  6. freemkv.github.io freemkv.github.io Public

    freemkv.org website

    HTML

Repositories

Showing 7 of 7 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…