bluraybackup(1)

📦 version 2.0, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💿 bluraybackup — the manual page, bestie edition

okay so you found the bluraybackup(1) man page (it lives in the General Commands Manual section, iykyk) and you're like "what is this". bestie. sit down. we're backing up Blu-rays today and it's gonna be iconic. 🎀

✨ NAME ✨

bluraybackup — a tool to backup Blu-ray Disc Movies (BDMV). that's it, that's the vibe. 🦋

🫶 SYNOPSIS 🫶

bluraybackup [-d device] [-k keyfile] [FILE] [DEST]

bluraybackup [-d device] [-k keyfile] -m [DEST]

bluraybackup [OPTION]

🌸 DESCRIPTION 🌸

so bluraybackup backs up Blu-ray Disc Movies (BDMV) — it was inspired by dvdbackup, it's developed in ANSI C (C89), and it follows the suckless philosophy. periodt.

It makes a decrypted copy of the whole Blu-ray Disc Movie, or it extracts a decrypted version of a specific BDMV stream. pick your fighter. 💅

⚠️ real talk: this program may not work with all Blu-rays. it both depends on your KEYDB.cfg file and on the BD+ generation (version). no cap.

To successfully decrypt a Blu-ray Disc Movie you both need libaacs installed and a KEYDB.cfg file containing your disc keys. both. not one. both. 💖

Moreover — and this is the part where it gets dramatic — if your disc is plagued by BD+ as well, you need to install libbdplus. BD+ is a form of copy obstruction, which consists in writing video streams to disc with small errors. these errors get fixed during playback by a virtual machine embedded in official players — but only if the player keys are verified by the same virtual machine. libbdplus is an implementation of the BD+ virtual machine features. however 😭 it doesn't support all the BD+ generations. since libbdplus 0.2.0, it's possible to bypass BD+ emulation, using cached tables to fix the broken streams. slay.

💅 OPTIONS 💅

  • -d, --device device — defines Blu-ray disc device. default is /dev/sr0 🎀
  • -h, --help — print usage message. the classic. 🫶
  • -k, --keydb keyfile — defines keys database file path. default is $HOME/.config/aacs/KEYDB.cfg ✨
  • -m, --main — copy main Blu-ray disc title (see USAGE). main character energy fr fr 👑
  • -v, --version — print version and license information. 🌈

🦋 USAGE 🦋

bluraybackup [-d device] [-k keyfile] [FILE] [DEST]

Without FILE, the whole disc will be copied to the current directory. FILE must be a file path relative to the disc root. 🍓

Without DEST, the decrypted FILE will be sent to standard output. the DEST path must include the file name — don't forget it, bestie, it will not fill it in for you. 💀

bluraybackup [-d device] [-k keyfile] -m [DEST]

Without DEST, the main disc title will be sent to standard output. and yes, DEST path must include file name here too. 🙈

⭐ EXIT VALUES ⭐

  • 0 — successful copy. we love to see it. 💖
  • 1 — everything else. 😭

🔥 SEE ALSO 🔥

👑 AUTHOR 👑

bluraybackup was written by Matteo Bini <matteobin@tiepi.it>. thank you for your service king 🫡

and that's the whole page, bestie 💜 this was bluraybackup version bluraybackup-2.0, and yeah that footer date slot is just the version hanging out on its own. go forth and decrypt responsibly. ✨🎀🦋

📦 where this page comes from