Skip to content

Latest commit

 

History

History
113 lines (76 loc) · 7.19 KB

README.md

File metadata and controls

113 lines (76 loc) · 7.19 KB

💿 What is dvdisaster?

dvdisaster provides additional ECC protection for optical media. If a medium gets damaged, dvdisaster can recover it as long as the amount of damage is smaller than the amount of ECC data you added to protect it.

It can loosely be compared to .par2 files, but the protection works at the iso level instead of working at the file level. This way, even if metadata from the optical medium filesystem is damaged, dvdisaster can still work flawlessly.

Please refer to the PDF manual for more information.

🔧 Unofficial version

The last upstream version by Carsten Gnörlich is dated 2017, and could be found on the official website which is now down. The original source code repository doesn't have it, but Debian sources does, thanks to the maintainer there. The original README has been left untouched in this repository.

This version is built on top of the latest upstream version, with the following notable enhancements:

  • Added pre-defined sizes for BD-R Triple Layer (100GB), BD-R Quadruple Layer (128GB)
  • Added an option to use more space for ECC on BD-R
  • Windows build supported again (it was dropped upstream a few versions back)
  • A new CLI-only version, not depending on gtk (./configure --with-gui=no && make clean && make -j4)
  • Non-regression tests on each code change, for Linux64 and Windows32/64, CLI and GUI versions
  • Prebuilt binaries for Windows32, Windows64, Linux64 (static builds and AppImage builds), CLI and GUI versions
  • Fixed a bunch of (minor) quirks, a few (minor) bugs, added a couple (minor) features

Please refer to the CHANGELOG for all the details.

In 2021, upstream development briefly resumed on a new website. The new team successfully picked up some of the improvements of this unofficial version. If/when upstream resumes development again, their changes will be merged back here when possible. In any case, even if at some point we succeed in upstreaming all our patches, and both codebases are exactly the same, this repository will stay up as it provides automated tests and prebuilt binaries.

This version will never break compatibility with upstream versions, the goal is to ensure an optical media protected by upstream dvdisaster will still be able to be repaired with this version 10+ years from now. Regression tests are here to ensure this is the case.

🔀 3 available protection modes ("codecs")

For a more detailed explanation of the algorithms, please refer to the codecs specification PDF.

1️⃣ RS01 creates error correction files which are stored separately from the image they belong to. The artefact is an ecc file, which must be stored on another media than the one we're protecting.

2️⃣ RS02 creates error correction data which is added to the medium to protect, we call this augmenting the image we're protecting. Damaged sectors in the error correction information reduce the data recovering capacity, but do not make recovery impossible - a second medium for keeping or protecting the error correction information is not required.

3️⃣ RS03 is a further development of RS01 and RS02. It can create both error correction files and augmented images, with the following added features:

  • RS03 can use multiple CPU cores and is therefore much faster than RS01/RS02 on modern hardware.
  • RS03 error correction files are - contrary to RS01, and to a lesser extent RS02 - robust against damage.
  • RS03 is more robust, but also more restrictive: The augmented image must completely fill the medium now while the size of augmented images can be freely chosen in RS02. The changes for parallel computation and higher robustness make RS03 a bit less space efficient, e.g. RS03 error correction data has slighly less (around -3%) error correction capacity than its RS01/RS02 counterparts on images with equal size.

Rough comparison table:

Codecs RS01 RS02 RS03
Robustness* ⭐⭐⭐ ⭐⭐⭐⭐⭐
Speed ⭐⭐ ⭐⭐⭐⭐⭐
Space efficiency ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
Augmented images ✔️ ✔️
Separate files ✔️ ✔️

*Robustness against corruption of the dvdisaster-added ECC parts themselves

A rough decision chart follows:

dvdisaster codec decision chart

💡 Rationale

Even if the optical media era is sunsetting now, and has been for a few years, it's still of some value for off-site backups. In any case, we still have media in our hands that we want to be able to repair, should it be damaged, during the next years/decades. Repairing is actually pretty much the very reason of dvdisaster existence (as long as parity data has been added, of course). The idea of this unofficial version is to ensure dvdisaster doesn't get hard to find, use or compile, should upstream development never resume (we hope it does!) This is also why precompiled Windows binaries and a precompiled static CLI-only Linux version are available here.

🔨 Compiling

See the INSTALL file. The workflow file that is used to automatically build binaries for each release can also help.

📷 Screenshots

Reading a damaged CD under Windows:

dvdisaster_damaged_cd

Verifying the ECC correction data from the damaged image:

dvdisaster_cd_verify

Repairing the damaged image thanks to augmented data:

dvdisaster_cd_repair

Verification of the image after correction:

dvdisaster_cd_verify_ok

Reading a quad-layer multi-session BDXL with Linux GUI:

dvdisaster_bdxl_read

Note that the disc still has some room for more sessions (capacity is 128 GB).