CSSDEC(1)

💅 CSSDEC(1) — the cssdec manual, bestie 💅

okay so this is the CSSDEC(1) page from CDimg|tools commands, and it's literally all about cssdec, the simple CSS descrambler using libdvdcss. slay. 💖

---

✨ NAME ✨

cssdec — simple CSS descrambler using libdvdcss

---

🦋 SYNOPSIS 🦋

cssdec -V
cssdec [options] [--]  target [start_sector [end_sector]]
cssdec -k [options] [--]  target [start_sector]

---

🌸 DESCRIPTION 🌸

cssdec is a command line program that decrypts sectors of CSS scrambled VOB files. The processed data is output on stdout. iconic behavior, honestly. ✨

cssdec uses libdvdcss directly, and passes it target as is. target can be a drive device file or a normal file.

The chosen block to be decrypted should be a VOB stream encrypted with a single key. It can be:

• a whole video file copied as is from a mounted DVD disc, or
• a range of sectors of a DVD disc (or of an image thereof) containing a single title (or menu).

The sector numbers are computed from the command line arguments by the function strtol(3).

The title key used to decrypt the VOB stream is obtained by libdvdcss.

---

💅 OPTIONS 💅

• -V — print the version information and exit. short, sweet, done.
• -v, -q — increase or decrease the level of verbosity of messages printed to stderr. The default level is 1, at which only error messages are printed. At level 0 nothing is printed. At level 2, a summary as well as some additional messages for noticeable events are printed. At level 3, information about every processed sector is printed. choose your own adventure, bestie.
• -e — modify the exit status as if a read error occurred when EOF is reached before the end of the given sector range.
• -o output_file — write to the given output_file instead of the standard output.
• -a — open the output file in append mode.
• -k — key only mode: exit right after libdvdcss has tried to obtain the title key. no extra processing, just key business.

---

🎀 ENVIRONMENT VARIABLES 🎀

• DVDCSS_* — libdvdcss' environment variables. Setting DVDCSS_VERBOSE=2 in the environment will make libdvdcss print the title key found. iykyk 👀

---

🍓 FILES 🍓

• ~/.dvdcss — libdvdcss' default cache directory for the title keys. The cache is used only if the input target is a DVD Video disc (or image file). Setting DVDCSS_CACHE=off in the environment disables the use of the cache. cache girlie has boundaries.

---

🔥 EXIT STATUS 🔥

Bestie, read this as a bitmask: each bit that's set indicates a failure. Because a usage error always sets all the other bits, the values between 128 and 254 remain unused; they constitute a range often used by shells (e.g. bash or older versions of ksh) to indicate an abnormal process termination (killed by a signal). important lore, ngl.

• 0 — no errors.
• 255 — usage error (invalid option or wrong number of arguments).
• 127 — failure while opening the target or the output_file.
• 64 — I/O error, while reading or writing.
• 32 — the title key could not be obtained.
• 1 — some sectors could be read but not decrypted. The data corresponding to these sectors is output, but its content is unknown.

---

🌈 EXAMPLES 🌈

Decrypt a scrambled video file:

cp /media/dvd/VIDEO_TS/VTS_01_1.VOB scrambled.VOB
sectors=$( echo $(ls -l scrambled.VOB |cut -d' ' -f5) / 2048 | bc )
cssdec -ev scrambled.VOB 0 $sectors >descrambled.VOB

Decrypt a DVD Video title:

for file in /media/cdrom/VIDEO_TS/VTS_01_[1-9].VOB; do
    cssdec $file >> title1.vob
done

Only print the title key:

DVDCSS_VERBOSE=2 cssdec -kv scrambled.VOB

---

💀 BUGS 💀

If the file size is not a multiple of the sector size (2048 bytes), the last partial sector is silently ignored. sneaky little gremlin behavior. 🙈

See also the CDimg|tools distribution file BUGS.

---

👑 AUTHOR 👑

cssdec was written by G.raud Meyer. author icon tbh.

---

🧚 SEE ALSO 🧚

efdtt(1), vobcopy(1), dvdbackup(1), dvdimgdecss(1), strtol(3)

---

💖 that's the whole CSSDEC(1) page, bestie! source/version: CDimg|tools unknown_version; date: 01/01/1980. periodt. 🫶