Dumping Guide (redumper CLI)

From Redump Wiki

Latest revision as of 14:20, 9 August 2024

Note: This guide is for the Command Line Interface version of redumper, if you have no idea what that means, please use the GUI version (as it's much simpler): Disc Dumping Guide (MPF).

This guide is aimed at those who would like to dump supported systems using redumper.

IMPORTANT: Compatible Disc Drive Requirement

Please note that submitting discs to Redump, whether these are new dumps or verifications, requires that a drive from the Compatible disc drive list is used. If you are uncertain about whether your drive is compatible or not, please check first - either post in the forums or, if you are a Discord user, join the Video Game Preservation Collective server and ask there.

Submissions made using drives not on the list are likely to be discarded as ineligible.

First Time Setup / Tools

• redumper
• BinaryObjectScanner - to scan for copy protections.
• MPF.Check - not required but can make filling submission info easier.

Dumping

Using a Windows Computer

Dumping discs with redumper can be extremely straightforward.

• Put your disc in a drive.
• Open the "Command Prompt" app.
• CD to the folder containing your redumper binary and execute redumper. The program will detect and dump the disc, running through all of the appropriate steps, and output all of the files to an autogenerated name.
• Next submit your dump to redump, see the "Submitting your Dump" section below.

Using a macOS Computer

• Every time you download redumper, you'll need to reestablish permissions to allow the app to run: Right-click on redumper -> Open -> Open. The app will open in Terminal and you've successfully established permissions, now quit Terminal.
• macOS will only allow CLI apps to run from certain directories, put the redumper file into the following directory: /Users/[username]/bin/
• Insert a disc into your disc drive.
• Open Terminal and identify the drive number your disc is in with this command: diskutil list
• Unmount the disc with diskutil unmountDisk /dev/disk[#]
• CD to the redumper app /Users/[username]/bin/
• Dump the disc with ./redumper --drive=disk[#]. The program will detect and dump the disc, running through all of the appropriate steps, and output all of the files to an autogenerated name.
• Next submit your dump to redump, see the "Submitting your Dump" section below.

Additional Parameters

redumper has a number of additional parameters which can be of assistance to advanced users. A full list of these can be viewed by executing redumper --help. Here's a list of the more commonly-used parameters and their functionalities as follows:

• --verbose - enables verbose output, useful for checking for any errors or warnings during the dumping process
• --drive=VALUE - select which drive should be used for dumping
• --speed=VALUE - specify a drive read speed. Can be useful for dumping damaged discs
• --retries=VALUE - specify how many times redumper should try to reread a sector with an SCSI/C2 error. Please note that even successful retries are not a guarantee of a good dump - any disc with errors should be dumped twice and matching hashes obtained prior to submission
• --image-path=VALUE - specify a directory into which dump/log files should be output
• --image-name=VALUE - specify a name for the dump/log files
• --correct-offset-shift - For an offset shift in the disc, somewhat rarely occurs with Philips CD-i and Video CD discs. Discs dumped with this flag should be added as "Fixed" dumps.

Irregular Disc Types

Specific instructions for dumping irregular disc types.

PS2 Unlicensed Discs Requiring Trim: Often needed when part of a disc label covers the data[1], or when a Mini-CD has a full-sized TOC.

1. Determine the end-of-readability area on the disc by attempting a normal dump. For this disc linked above (and likely similar discs), the area of readability ended around sector 89900.
2. Delete your error dump.
3. Determine a nearby number that won't touch the sectors affected by readability. For example, if the readability ends around 89900, then use 89000.
4. redump with the following command utilizing the number you determined, example: redumper --lba-end=89000
5. Trim the output .scram with the following command: redumper protection split --image-name=[scram file name WITHOUT the ".scram" extension] --iso9660-trim
6. Run redumper hash info --image-name=[name of files without extension]
7. The output bin should be correct, presuming no unintentional c2 errors exist. You should only have the intentional c2 errors near the start of the disc.

Collecting Information about your Disc

Much of the required technical information such as Primary Volume Descriptor, write offset, etc. will be available in the .log file output by redumper during the dumping process. Some additional elements which are required are outlined below. It is recommended to use [MPF.Check to assist with generating submission info. Otherwise, create a separate file based on Submission Template to fill in the following information:

Title: The main title of the game. If there are multiple variants of the game title given, the in-game title should take precedence. Additional titles (e.g. on the box, spine, etc.) can be added in comments using the [T:ALT] tag.

If titles in multiple languages are present, the English title should take precedence. Titles in other languages can be added to comments using the [T:ALTF] tag.

Titles in non-Latin alphabets should be romanised. For Cyrillic, this should be done using the GOST 7.79-2000 system. For Japanese titles, a modified Hepburn romanization system is used, but there are some additional complexities.

Foreign Title (Non-latin): Titles in non-Latin alphabets can be provided as-is for this field

Disc Number / Letter: If the disc is explicitly numbered or lettered (1, 2, A, B, etc.) then provide this information here. If a disc is labelled e.g. "Disc 1 of 2", it is only necessary to provide the number 1.

Disc Title: If the disc is explicitly given a title such as "Install Disc" or "Bonus DVD" then include this information here.

System: Please select the appropriate system from the list of System Names

Category: Select as appropriate from the following list:

• Add-Ons
• Applications
• Audio
• Bonus Discs
• Coverdiscs
• Demos
• Educational
• Games
• Multimedia
• Preproduction
• Video

Region: The region in which the disc was primarily available for sale. This could be an individual country (Japan) or a broader regional designation (Europe). Use of the "World" region should be avoided - this is only added in exceptional circumstances where multiple matching dumps from all major regions are known.

Languages: These should be languages which are explicitly available in game. For PC, if multiple languages are offered during installation, it should be verified that the game is playable in each of these. If you are not sure, leave this field blank.

Disc Serial: Any serial number which is printed on the disc itself. Note that serial numbers printed on cases, sleeves, inlays etc. should not be included here.

Ringcode Information: Follow the Ring Code Guide

Barcode: Submit the numbers from under the barcode: EAN / UPC code, usually printed on the back cover of the packaging or disc case. If there are multiple barcodes present (e.g. on outer sleeve/inner jewel case) then add all of these and comma separate them. Please submit exactly as printed on the item. Examples

Error Count: This information can be found in the .img_EccEdc.txt file generated during the dumping process. If it reads "[NO ERROR] User data vs. ecc/edc match all" then enter 0 here, otherwise enter the number given after "Total errors:"

Comments: Any other relevant information that doesn't belong in a specified field goes here. Please see the list of Special Site Codes for some of the types of information that can be added here.

Contents: Completely optional, but if the disc contains any interesting contents other than the main game (demos, trailers, manuals, etc.) then this can be noted here.

Version: Any obvious version information should be included here. For the following systems there are standard methods to find the version:

• Sony PlayStation 2 - use the VER tag in SYSTEM.CNF
• Sony PlayStation 3 - use the VERSION tag from PARAM.SFO
• Sony PlayStation 4 - use the VERSION tag from PARAM.SFO

For IBM PC, version information can be found in many places. For preference, any version information displayed in-game should be used - this can often be found on title screens, menus, or credit sequences. If this is not available, other sources such as readme files, .ini files or installers can be searched.

Edition/Release: If a game is part of a particular named edition or special release (e.g. Limited Edition, Platinum Hits, etc.) then this information should be included here. For bonus discs bundled with a particular game (e.g. bonus DVDs or soundtrack CDs), the edition is always "[SYSTEM] Game Bundle"

Copy Protection: BurnOutSharp, although built as a Windows application, should be usable under compatibility layers such as WINE on other operating systems. Any copy protection information it detects should be included here.

Track 0/A hashes

On certain occasions, redumper will detect and dump additional data in the disc lead-in / lead-out and create Track 0/00 and/or Track A/AA files. Hashes for these should be included as part of your submission for pure Audio CDs - for other disc types, including Enhanced CDs, these can be excluded at present.

When submitting file hashes for your dump, please note that the redump database does not yet support these track numbers. You should manually extract these from the "dat:" section of the log and include them in the comments section instead.

Universal Hash

Universal Hash information will be generated for all discs. This should be included in your submission only for discs which consist entirely of audio tracks (primarily Audio CDs but there are some other examples such as GameShark updates which are mastered as audio).

Submitting Info to Redump.org database

See Disc_Dumping_Guide_(MPF)#Submitting_Info_to_Redump.org_database