Disc Dumping Guide (MPF CLI)

From Redump Wiki

(Difference between revisions)
Jump to: navigation, search
(Dumping)
(Additional Dumping Notes)
 
(2 intermediate revisions not shown)
Line 42: Line 42:
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.
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.
-
Users on Linux systems may have to use <code>/dev/sgX</code> instead of <code>/dev/srX</code> depending on the setup of your system. If your distro does not automatically include <code>/dev/sgX</code> when mounting a device, you may have to run as <code>root</code>. This will change the owner of all generated files to <code>root</code>, so changing that back to your current user is recommended if you need to run the tool this way. <code>/dev/sgX</code> does not always match numerically to <code>/dev/srX</code>, so use relevant online sources to see what your distro does.
+
Users on Linux systems may have to use <code>/dev/srX</code> instead of <code>/dev/sgX</code> depending on the setup of your system. If your distro does not automatically include <code>/dev/sgX</code> when mounting a device or does not have the <code>sg</code> module loaded by default, you may have to run as <code>root</code>. This will change the owner of all generated files to <code>root</code>, so changing that back to your current user is recommended if you need to run the tool this way. <code>/dev/sgX</code> does not always match numerically to <code>/dev/srX</code>, so use relevant online sources to see what your distro does.
==Collecting Information about your Disc==
==Collecting Information about your Disc==

Latest revision as of 00:19, 29 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 and likely should be changed.
    • 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, default value is fine.
    • 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

Additional Dumping Notes

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.

Users on Linux systems may have to use /dev/srX instead of /dev/sgX depending on the setup of your system. If your distro does not automatically include /dev/sgX when mounting a device or does not have the sg module loaded by default, you may have to run as root. This will change the owner of all generated files to root, so changing that back to your current user is recommended if you need to run the tool this way. /dev/sgX does not always match numerically to /dev/srX, so use relevant online sources to see what your distro does.

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