Disc Dumping Guide (MPF CLI)

From Redump Wiki

(Difference between revisions)
Jump to: navigation, search
(Created page with "'''This dumping guide is for:''' * Any CD format, including (but not limited to): console games, PC games, audio CDs and video CDs. Some CD-Rs with errors need extra steps (see: ...")
(Dumping)
Line 37: Line 37:
***'''PLEASE NOTE''' that all parameters are required if this is used, not just "new" parameters.
***'''PLEASE NOTE''' that all parameters are required if this is used, not just "new" parameters.
* Use the <code>listX</code> options for more details about accepted values, especially for system, media type, and dumping programs
* Use the <code>listX</code> options for more details about accepted values, especially for system, media type, and dumping programs
 +
 +
It is highly recommended to use the interactive mode (<code>MPF.CLI i</code>) if you are not comfortable with commandline applications. For power users, there is no technical advantage or disadvantage of using commandline parameters over the interactive mode. All functionality is present in both modes of operation.
==Collecting Information about your Disc==
==Collecting Information about your Disc==

Revision as of 23:18, 28 December 2025

This dumping guide is for:

For all other formats see Dumping Guides.

If you have any questions about the process or need assistance, please reach out in the forum or in the VGPC Discord.


Contents

Tools

  • Windows, MacOS, or Linux computer
  • Compatible disc drive (Required).
  • Software:
    • Microsoft Visual C++ 2015 Redistributable Update 3 RC - Needed for DiscImageCreator on Windows only
    • MPF (download the "MPF.CLI..." zip file for your system)
      • If you don't see the MPF.CLI download, press the link that says "Show all XX assets" under the release, where XX will be a number like 22
      • If you have a Redump account, you can configure RedumpUsername and RedumpPassword in config.json

Dumping

Please note it is highly recommended to dump any new discs twice and verify that they have matching hashes.

  • Insert your disc into the drive.
  • In the MPF.CLI app folder, run MPF.CLI from a command prompt or terminal window.
    • The first run will generate a config.json file that you should fill out before continuing
    • Running MPF.CLI without any arguments will display the help text
  • If using the interactive mode (applies to non-interactive parameters as well):
    • System: Will be set to the default value from config.json
    • Dumping Program: Default value is fine.
    • Media Type: Not required unless using DiscImageCreator as the dumping program
    • Device Path: Drive letter or path where the disc is mounted (e.g. D:\ or /dev/sg0)
    • Mounted Path: Only required on non-Windows platforms. Points to the mounted filesystem path (e.g. /run/media/cdrom) to allow for things like copy protection scans and gathering additional data.
    • File Path: This lists the path and filename for your dump. You can click Browse to change this, or rename the file directly in the text box.
    • Override Speed: Only needed if you want to provide a specific speed without changing config.json
    • Custom Parameters: Only needed if you need to pass in a custom set of inputs to the dumping program.
      • PLEASE NOTE that all parameters are required if this is used, not just "new" parameters.
  • Use the listX options for more details about accepted values, especially for system, media type, and dumping programs

It is highly recommended to use the interactive mode (MPF.CLI i) if you are not comfortable with commandline applications. For power users, there is no technical advantage or disadvantage of using commandline parameters over the interactive mode. All functionality is present in both modes of operation.

Collecting Information about your Disc

See the UI guide for details.

Submitting Info to Redump.org database

See the UI guide for details.

Personal tools