Skip to content
Steve Dibb edited this page Jun 28, 2025 · 27 revisions

Table of Contents

bluray_info

The bluray_info project contains a collection of programs to access information about Blu-rays and extract content.

Programs include:

  • bluray_info - display information about a Blu-ray in human-readable, JSON, or MKV chapter formats.
  • bluray_copy - copy tracks, chapters, from a Blu-ray to a file or stdout
  • bluray_player - a small Blu-ray player using libmpv as backend
  • bluray_backup - do a complete backup of a disc minus the DRM
  • bluray_rip - an ffmpeg wrapper to rip or copy Blu-ray titles

Building

The two libraries that need to be installed for bluray_info to work is libbluray (at least version 1.2.0) and libaacs.

Configuration and installation uses common scripts:

./configure
make
sudo make install

If you want to build bluray_player you will need libmpv installed on your system. Then, pass the build option to configure.

./configure --with-libmpv

Device Name

Blu-ray path can be a device, a filename, or a directory. With no argument, the default device for your operating system will be used.

bluray_info
bluray_info /dev/sr0
bluray_info movie.iso
bluray_info ~/Videos/Blu-ray/

DRM and libaacs

You will need to download a KEYDB file from http://fvonline-db.bplaced.net/, unzip the file, and put it in ~/.config/aacs/

Compatibility

bluray_info has been tested on GNU/Linux, OpenBSD, FreeBSD, NetBSD, and MSYS2.

Man Pages

There are man pages for all the programs installed.

man bluray_info
man bluray_player
man bluray_copy
man bluray_backup
man bluray_rip

Other Software

libbluray ships with sample binaries that are also very helpful. See bd_info for generic information, and bd_splice to also copy a title.

ffmpeg can read Blu-rays directly. See their documentation here.

ffmpeg -playlist 1 bluray:/dev/sr0 -codec copy bluray.mkv

Help

If you run into problems, feel free to contact me or open a bug here on GitHub.

Operating Systems

Ubuntu

Install dependencies:

sudo apt install build-essential libmpv2 libmpv-dev libbluray2 libbluray-dev libbluray-bdj libbdplus0 libaacs0 java-common ffmpeg

FreeBSD

Install build packages and multimedia dependencies:

pkg install gcc libdvdread pkgconf mpv
cd /usr/ports/multimedia/libdvdcss && make

Your user must be in the operator group. You can edit /etc/group and add your user there:

operator:*:5:root,beandog

Default DVD device is /dev/cd0d, and dvd_info will automatically use that one, so you don't have to specify it.

GhostBSD

To build from source:

sudo pkg install -g 'GhostBSD*-dev'
sudo pkg install pkgconf cmake libbluray
Clone this wiki locally