Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
bluray_info - a set of utilities for accessing Blu-ray discs


* bluray_info - display information about a Blu-ray in multiple formats
* bluray_copy - copy a title or playlist to a file or stdout


* libbluray >= 1.0.0 (libaacs needed for decryption)

Disc access:

Decrypting Blu-ray discs is done through libaacs, which libbluray is built with
or without support for. Even with libaacs, you will need a KEYDB.cfg file to
bypass the encryption, and can be found various places online. I keep a copy of
the one I'm using at

libaacs by default will look for KEYDB.cfg in ~/.config/aacs/ but with these
utilities, you can specify the path directly if you'd like.

Disc drives:

The drive I use is a LITE-ON iHOS104 (firmware version WL0D) that I bought many
years ago. It has the added bonus of being region-free for DVDs as well. :)


The source can be either a device name, a single file, or a directory. The
program will the default blu-ray drive if no path is given.

  $ bluray_info
  $ bluray_info /dev/sr0
  $ bluray_info ~/Media/BD.ADVENTURE.iso
  $ bluray_info ~/Media/BD.ADVENTURE/
  $ bluray_info /mnt/bluray

If you're going to do a lot of reads on a disc drive, I'd recommend mounting it
so the access can be cached -- this is especially helpful when using / testing
bluray_copy a lot to get chapters, titles, playlists, etc.

  # mount /dev/sr0 -o ro -t udf /mnt/bluray

Depending on your luck / region / disc drive / disc / local alien invasion, you
may or may not be able to make an ISO directly from a disc.

If you want to give it a whirl, I recommend ddrescue:

  $ ddrescue -b 2048 -n /dev/sr0 bluray.iso ddrescue.log

Playlists and titles:

Blu-rays have "tracks" as well as "playlists," and they are not the same thing,
and do not share an identical numbered index.

For the most part, you will probably be fine ripping either one. I've heard
stories of some movie studios "stitching" playlists together to form a feature,
but I haven't encountered one (if you do, please let me know, I'm curious how
they are set up).


Usage: bluray_info [options] [bluray device]

See bluray_info --help for all options.

bluray_info syntax and output was designed to closely resemble the awesome
program "lsdvd" (and later my own clone and other programs, from dvd_info).

It will display as much relevant information I can get from the disc that is
provided by libbluray. Sadly, there's no way to display the number of channels
for each audio stream right now, and so it will simply display the codec as
Dolby Digital (ac3), DTS, etc. Maybe someday. It'll probably require me to
examine the content of the stream, which would mean using multimedia libraries.


Usage: bluray_copy [options] [bluray device]

See buray_copy --help for all options.

Blu-rays can store many codecs, and its container is an MPEG-2 transport stream.
If you so desire, you can easily remux it into another container -- and get the
file much smaller by dropping audio tracks you don't want or need. I recommend
using mkvmerge (from mkvtoolnix) or ffmpeg or avconv (libav).

Two examples of remuxing the copied stream with only the first audio track:

  $ mkvmerge -o bluray.mkv -a 1 bluray.m2ts
  $ ffmpeg -i bluray.m2ts -map 0:0 -map 0:1 -codec copy bluray.mkv

Or you can use bluray_copy to output to stdout and remux on the fly:

  $ bluray_copy -o - | ffmpeg -i - -map 0:0 -map 0:1 -codec copy bluray.mkv
  $ bluray_copy -o - | ffmpeg -i - -map 0:0 -map 0:1 -codec copy -f mpegts bluray.m2ts

Blu-rays can hold a lot of stuff ... a lot. bluray_copy won't do anything
fancy like check to see if you have enough space to copy the track you want to,
so be careful. It will simply quit if it can't write to the hard drive anymore.

If no argument is given, bluray_copy will simply select the longest track.


I love hunting down anomalies, so if you run into something odd on a disc, let
me know and I'd love to look into it. Bug reports are good, too.

If you want to say thanks, buy me a Blu-ray disc :D There's nothing I'd love
more than a new disc to play with (and something to watch as well).
Here's my Amazon wishlist: if you're feeling generous!

About Me:

I love working with multimedia on Linux! It's a lot of fun. I have done and do
push a lot of my support and development into Gentoo Linux and that is where I
could best provide support if you're hitting problems.

I have an old blog where I would write about my adventures in multimedia as
well, so there may be some content there if you're willing to dig for it at While the posts are old, the content is still relevant.

I'm a big fan of DVDs as well, and have a super big library of cartoons and
other stuff (asking me what my favorite one is changes from week to week).

This project has been super fun to work on, my DVD utilities in the dvd_info
github repo was the first time I'd ever gotten to learn and write code in C,
and I love the programming language. It's a tough learning curve, but fun.
I try really hard to do clean code and best practices, and my target is to have
the binaries build with as little warnings as possible. I use clang -Weverything
on my local development.

DVDs and Blu-rays are a lot of fun to work with. Optical media is not going
away anytime soon, and there are always good reasons to prefer or rely on it:
hobby collectors, no online requirements, save bandwidth, fun collections,
guaranteed compatability, access to content, ability to archive, cool shelves
to pack a display with, etc., etc.

I do a lot of work with encoding and multimedia in other areas, too, not just
DVDs and Blu-rays. One of my favorite things is to find new devices that
support video playback and then get things working on them! Good times. I'm
a total multimedia geek.

In case someone is curious on my take about an HTPC setup, I use (and
have used) and would recommend: Kodi, minidlna, and Plex. For hardware,
I use an nVidia Shield. I also would recommend both the PS3 and the PS4 for
excellent clients as well.

If you have questions, feel free to contact me at

Also, check out more information at


Licensed under GPL-2. See


Linux/BSD Blu-ray utilities - bluray_info, bluray_copy, bluray_player







No packages published