DVDIMGDECSS(1)

💿 DVDIMGDECSS(1) — CDimg|tools commands 💿

okay bestie, this is the manual page for dvdimgdecss, coming at you from CDimg|tools and living under the manual name DVDIMGDECSS(1). let’s get into it 💅

---

✨ NAME ✨

dvdimgdecss — CSS descrambling of raw DVD Video images 🎀

---

🦋 SYNOPSIS 🦋

dvdimgdecss -V
dvdimgdecss [-v|-q] [-c] [--] dvd
dvdimgdecss [-v|-q] [-c|-C] [--] dvd file

---

🌸 DESCRIPTION 🌸

dvdimgdecss is a command line program to remove the CSS scrambling of DVD Video image files. literally its whole main character job 💖

dvdimgdecss uses libdvdread and libdvdcss, and passes them dvd as is. dvd can be a drive device file or a raw image file.

If file is not given, dvdimgdecss only computes (and prints) the sector ranges corresponding to each file pertaining to the DVD Video. no copying yet, just the receipts ✨

If file is given, it furthermore copies dvd to file, possibly decrypting the sector ranges corresponding to VOB files. The actual reading and decryption is done by libdvdcss.

---

💅 OPTIONS 💅

• -V — Print the version information and exit. short and iconic 👑
• -v, -q — Increase or decrease the level of verbosity of messages printed to stdout/stderr. The default level is 1, at which only error messages are printed. At level 0 nothing is printed. At level 2, each domain (title) is displayed as it is processed. At level 3, a percentage indicator is displayed. The messages printed by libdvdcss are controlled by the environment variable DVDCSS_VERBOSE; libdvdread’s messages cannot be silenced. 😭
• -c — Make libdvdread search for all the title keys and print the result; while copying and decrypting the dvd, enable some consistency checks made by using libdvdread. While decrypting, libdvdcss will nonetheless retrieve the title keys again; if the cache directory is in use, the keys will simply be read from it.
• -C — Use libdvdread instead of libdvdcss for reading (and decrypting) the VOB streams of the dvd. This implies -c, and avoids a new search of the title keys by libdvdcss. It is not known (yet) whether libdvdread performs additional checks (compared to libdvdcss alone). 🫶

---

🌈 ENVIRONMENT VARIABLES 🌈

• DVDCSS_* — libdvdcss' environment variables.
• DVDREAD_NOKEYS — libdvdread’s environment variable. Setting this variable prevents libdvdread from trying to retrieve all the title keys at once, even when the option -c is given.

---

🎀 FILES 🎀

• ~/.dvdcss — libdvdcss' default cache directory for the title keys. Setting DVDCSS_CACHE=off in the environment disables the use of the cache. 💾

---

🔥 EXIT STATUS 🔥

To be interpreted as a bitmask, where each bit 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).

• 0 — No errors. slay ✨
• 255 — Usage error (invalid option or wrong number of arguments).
• 64 — I/O error. If a file could not be opened, the exit status is 127.
• 32 — Inconsistencies found (probably because of a bug in dvdimgdecss or its libraries).
• 16 — Cancellation due to a memory allocation error.
• 8 — No VOBs were found in the DVD; the output file is the same as the dvd if there are no other errors.

---

🧚 EXAMPLES 🧚

If the disc can be read without errors, reading directly from the drive has the advantage of making the disc key available to libdvdcss:

dvdimgdecss /dev/sr0 dvd.img

It is possible to decrypt a file without a drive (without a disc key); furthermore, we bypass the key cache and make libdvdcss print the new keys found:

DVDCSS_VERBOSE=2 DVDCSS_CACHE=off dvdimgdecss dvd.img dvd.img.decss

You might then burn the image to an optical disc. 🔥💿

---

💀 BUGS 💀

It seems, after a look at its source code, that libdvdcss does not report all the error conditions that it encounters. ngl, not the vibe 🙈

See also the CDimg|tools distribution file BUGS.

---

👑 AUTHOR 👑

dvdimgdecss was written by G.raud Meyer. iconic behavior 🫶

---

⭐ SEE ALSO ⭐

cssdec(1), lsdvd(1), vobcopy(1), dvdbackup(1)

---

That’s the whole page, bestie! Source: CDimg|tools, version unknown_version, dated 01/01/1980, manual name DVDIMGDECSS(1). 💖🦋