bdemu

Blu-ray drive emulator for development and testing. Intercepts Linux SG_IO ioctls via LD_PRELOAD to emulate a complete optical drive from captured SCSI response data. No real drive needed.

Part of the freemkv project. Linux only.

Download

Download latest release

Or build from source: cargo build --release

Quick Start

# Capture a disc (auto-names; pass --eject to eject the tray afterwards)
bdemu capture-disc /dev/sr0 ./testbed/disc

# Emulate a drive and scan the captured disc
bdemu run --profile profiles/hl-dt-st-bd-re-bu40n-1.03-nm00000 --disc my_movie -- freemkv info disc://

Commands

bdemu 1.6.14

Commands:
  run --profile <dir> [--disc <name>] -- <cmd>   Emulate drive, run command
  capture-disc <device> <output_dir> [--eject]   Smart capture from hardware
  validate <profile_dir>                         Check profile completeness

Control (while emulator is running):
  status                                         Show emulator state
  eject                                          Eject the disc
  load <disc_name>                               Load a disc
  list-discs                                     List available discs

Examples:
  bdemu capture-disc /dev/sr0 ./testbed/disc     Capture, auto-names (add --eject to eject)
  bdemu run -p profiles/hl-dt-st-bd-re-bu40n-1.03-nm00000 -d sample -- freemkv info disc://
  bdemu validate profiles/hl-dt-st-bd-re-bu40n-1.03-nm00000/

Smart Capture

capture-disc uses libfreemkv to parse the disc's UDF filesystem and capture only the sectors needed for emulation. A typical capture is 15-80 MB instead of 25-90 GB.

After capture, the output directory is automatically renamed to the disc's volume ID (e.g. disc becomes sample_film). If the name already exists, a number is appended (sample_film_2).

The tray is not ejected by default — pass --eject to capture-disc if you want the disc ejected once the capture finishes. Eject is irreversible on slot-loading drives (you have to physically reload the disc), so it is opt-in.

Creating Profiles

From real hardware

# Capture drive identity (one-time per drive)
freemkv info disc:// --share

# Capture discs (repeat for each disc)
bdemu capture-disc /dev/sr0 profiles/my-drive/discs/disc

Profile Structure

profiles/my-drive/
+-- drive.toml           # Drive metadata
+-- inquiry.bin          # INQUIRY response (96 bytes)
+-- gc_*.bin             # GET_CONFIG features
+-- rpc_state.bin        # REPORT KEY RPC state
+-- mode_2a.bin          # MODE SENSE page 2A
+-- discs/
    +-- my-disc/
        +-- toc.bin      # READ TOC response
        +-- capacity.bin # READ CAPACITY response
        +-- disc_info.bin
        +-- ds_00.bin    # READ DISC STRUCTURE
        +-- sectors.bin  # BDSM sparse sector map

Environment Variables

Variable	Description
BDEMU_PROFILE	Path to drive profile directory
BDEMU_DISC	Disc subdirectory name
BDEMU_QUIET	Suppress SCSI command logging
BDEMU_INSTANCE	Instance id for the control socket ($XDG_RUNTIME_DIR/bdemu-<id>.sock). Unset uses bdemu.sock. Set it — on both the bdemu run side and the status/load/eject side — when running two emulators at once, otherwise the second refuses to start rather than stealing the first's socket. Ids may contain ASCII letters, digits, - and _.

License

MIT