File: bluraybackup.1

package info (click to toggle)
bluraybackup 2.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 104 kB
  • sloc: ansic: 458; makefile: 45
file content (105 lines) | stat: -rw-r--r-- 2,752 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.TH bluraybackup 1 bluraybackup\-VERSION
.SH NAME
bluraybackup \- Tool to backup Blu-ray Disc Movies (BDMV)
.SH SYNOPSIS
.B bluraybackup
[-d \fIdevice\fR] [-k \fIkeyfile\fR] [\fIFILE\fR] [\fIDEST\fR]

.B bluraybackup
[-d \fIdevice\fR] [-k \fIkeyfile\fR] -m [\fIDEST\fR]

.B bluraybackup
[\fIOPTION\fR]
.SH DESCRIPTION
\fBbluraybackup\fP backups Blu-ray Disc Movies (BDMV),
inspired by dvdbackup,
developed in ANSI C (C89) following the suckless philosophy.

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

This program may not work with all Blu-rays.
It both depends on your KEYDB.cfg file
and on the BD+ generation
(version).

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

Moreover,
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,
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.
.SH OPTIONS
.TP
\fB-d\fR, \fB--device\fR \fIdevice\fR
defines Blu-ray disc device
(default /dev/sr0)
.TP
\fB-h\fR, \fB--help\fR
print usage message
.TP
\fB-k\fR, \fB--keydb\fR \fIkeyfile\fR
defines keys database file path
(default $HOME/.config/aacs/KEYDB.cfg)
.TP
\fB-m\fR, \fB--main\fR
copy main Blu-ray disc title (see USAGE)
.TP
\fB-v\fR, \fB--version\fR
print version and license information
.SH USAGE
.B bluraybackup
[-d \fIdevice\fR] [-k \fIkeyfile\fR] [\fIFILE\fR] [\fIDEST\fR]
.P
Without \fIFILE\fR,
the whole disc will be copied to the current directory.
\fIFILE\fR must be a file path relative to the disc root.

Without \fIDEST\fR,
the decrypted \fIFILE\fR will be sent to standard output.
\fIDEST\fR path must include file name.

.B bluraybackup
[-d \fIdevice\fR] [-k \fIkeyfile\fR] -m [\fIDEST\fR]
.P
Without \fIDEST\fR,
the main disc title will be sent to standard output.
\fIDEST\fR path must include file name.
.SH EXIT VALUES
.TP
\fB0\fP \- Successful copy
.TP
\fB1\fP \- Everything else
.SH SEE ALSO
.P
\fBdvdbackup\fP(1)

.B http://www.videolan.org/developers/libbluray.html

.B http://www.videolan.org/developers/libaacs.html

.B http://www.videolan.org/developers/libbdplus.html

.B https://wiki.archlinux.org/title/Blu-ray

.B http://suckless.org/philosophy/
.SH AUTHOR
bluraybackup was written by Matteo Bini <matteobin@tiepi.it>.