FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Original HTTPS Page]

freeMKV · GitHub

freeMKV

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

macOS — Homebrew:

brew install freemkv/tap/freemkv             # command line
brew install --cask freemkv/tap/freemkv-app  # desktop app

Linux:

curl -sLo freemkv https://github.com/freemkv/freemkv/releases/latest/download/freemkv-x86_64-linux
chmod +x freemkv && sudo mv freemkv /usr/local/bin/

Use freemkv-aarch64-linux on arm64.

macOS — direct download:

curl -sLo freemkv https://github.com/freemkv/freemkv/releases/latest/download/freemkv-aarch64-macos
chmod +x freemkv && sudo mv freemkv /usr/local/bin/

Use freemkv-x86_64-macos on Intel. Fetching with curl avoids the macOS security prompt a browser download gets; Homebrew does too.

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

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.

freemkv rips the main title by default. Add -t all to rip every title on the disc as separate files, or -t N to pick a specific one. Run freemkv info disc:// to see all titles with durations.


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, MIT licensed
  • 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, main title (the default)
freemkv disc:// m2ts://Dune.m2ts                   # Rip to transport stream, main title
freemkv disc:// mkv://out/ -t all                  # Rip every title, one file each
freemkv iso://Dune.iso mkv://Dune.mkv               # ISO to MKV
freemkv m2ts://Dune.m2ts mkv://Dune.mkv             # Remux
freemkv disc:// network://192.0.2.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
autorip Automatic ripper — Docker, web UI, TMDB, webhooks. ghcr.io
freemkv-engine Shared rip-orchestration layer between libfreemkv and the front ends (recovery strategy, multi-title rip loop)
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 · MIT

Popular repositories Loading

  1. freemkv freemkv Public

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

    Rust 79 3

  2. libfreemkv libfreemkv Public

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

    Rust 10 3

  3. bdemu bdemu Public

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

    Rust 2

  4. freemkv-unlock freemkv-unlock Public

    Pluggable drive unlockers for libfreemkv.

    Rust 2

  5. autorip autorip Public

    Automatic disc ripper — insert a disc, get an MKV

    Rust 1

  6. .github .github Public

    freemkv organization profile

Repositories

Loading
Type
Select type
All Public Sources Forks Archived Mirrors Templates
Language
Select language
All Astro Ruby Rust
Sort
Select order
Last updated Name Stars
Showing 10 of 11 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…


Back | FazBrowse Home | New Git URL