Automatically migrated from Gitolite
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

47 lines
2.0 KiB

8 years ago
  1. # image-disc
  2. A small utility for making archival copies of CDs and DVDs under Linux.
  3. There's a lot of duct tape in here, but it generally works. You've been warned.
  4. Pull requests welcome, but please keep in mind that the purpose of this script is *archival-quality* copies where possible.
  5. ## Supported disc types
  6. * Data CD-ROM
  7. * Mixed-content CD-ROM (eg. data + audio)
  8. * Audio-DVD
  9. * Video-DVD
  10. * Data DVD-ROM
  11. ## Unsupported disc types
  12. * Audio-CD (use a secure ripper such as [Rubyripper](http://wiki.hydrogenaudio.org/index.php?title=Rubyripper) for this!)
  13. * Bluray
  14. * HD-DVD
  15. * Other non-CD/DVD disc types
  16. ## Dependencies
  17. You must have the following installed:
  18. * cdrdao
  19. * `ddrescue` (*not* `dd_rescue`!)
  20. * UDisks (shipped by most distributions)
  21. * `eject` (shipped by most distributions)
  22. * udev (available in recent Linux kernels)
  23. ## Usage
  24. `python image.py DEVICE TARGET [--ddrescue]`
  25. * **DEVICE**: The source device to image from. This will be something like `/dev/sr0` or `/dev/cdrom`.
  26. * **TARGET**: The target directory to place images in. Each image will be named according to the name you enter for that disc.
  27. * **--ddrescue**: Optional flag to force the script to use ddrescue, even for (potential mixed-content) CD-ROMs. Useful for recovering damaged CD-ROMs. **This flag must always be *after* the device and target!**
  28. ## Remarks
  29. This is duct tape. It ties together a bunch of existing utilities to automate your imaging. There is no guarantee that it'll work, or even that it'll produce valid images (although it will certainly try). **Check the integrity of your images, if you care about your data!**
  30. The script is quite noisy; it doesn't try to understand output from utilities, and just passes it through wholesale. All messages originating from the script itself are prefixed with `##`.
  31. Don't be alarmed if you get mounting/unmounting/eject failures; to avoid race conditions, the script is quite aggressive in making sure everything is unmounted/ejected when necessary. If you get errors, that usually just means that the disc was *already* unmounted or ejected.