Skip to content

Configuration JSON

Matt Nadareski edited this page May 6, 2025 · 2 revisions

Configuration JSON Reference

Below are tables representing the various keys that are used in the config.json file. This file is used by both MPF UI and MPF CLI.

NOTE: Please note that MPF CLI does override some of the default values above to make them more obvious to users to fill in.

Common

Key Type Default Description
FirstRun bool true Indicate if the program is being run with a clean configuration

Internal Program

Key Type Default Description
AaruPath string? "Programs\Aaru\Aaru.exe" Path to Aaru
DiscImageCreatorPath string? "Programs\Creator\DiscImageCreator.exe" Path to DiscImageCreator
InternalProgram string? "Redumper" Currently selected dumping program

InternalProgram Values

Value Note
Aaru Dumping and verification
DiscImageCreator Dumping and verification
Redumper Dumping and verification
CleanRip Verification only
PS3CFW Verification only
UmdImageCreator Verification only
XboxBackupCreator Verification only

UI Defaults

Key Type Default Description
EnableDarkMode bool false Enable dark mode for UI elements
EnablePurpMode bool false Enable purple mode for UI elements
CustomBackgroundColor string? null Custom color setting
CustomTextColor string? null Custom color setting
CheckForUpdatesOnStartup bool true Check for updates on startup
FastUpdateLabel bool false Fast update label - Skips disc checks and updates path only
DefaultOutputPath string? "ISO" Default output path for dumps
DefaultSystem string? "pc" Default system if none can be detected
ShowDebugViewMenuItem bool false Default output path for dumps

NOTE: In the future, DefaultOutputPath may apply to MPF CLI as well.

DefaultSystem Values

See System Types for more details.

Dumping Speeds

Key Type Default Description
PreferredDumpSpeedCD int 24 Default CD dumping speed
PreferredDumpSpeedDVD int 16 Default DVD dumping speed
PreferredDumpSpeedHDDVD int 8 Default HD-DVD dumping speed
PreferredDumpSpeedBD int 8 Default BD dumping speed

Aaru

Key Type Default Description
AaruEnableDebug bool false Enable debug output while dumping by default
AaruEnableVerbose bool true Enable verbose output while dumping by default
AaruForceDumping bool true Enable force dumping of media by default
AaruRereadCount int 5 Default number of sector/subchannel rereads
AaruStripPersonalData bool false Strip personal data information from Aaru metadata by default

DiscImageCreator

Key Type Default Description
DICMultiSectorRead bool false Enable multi-sector read flag by default
DICMultiSectorReadValue int 0 Include a default multi-sector read value
DICParanoidMode bool false Enable overly-secure dumping flags by default
DICQuietMode bool false Enable the Quiet flag by default
DICRereadCount int 20 Default number of C2 rereads
DICDVDRereadCount int 10 Default number of DVD/HD-DVD/BD rereads
DICUseCMIFlag bool false Use the CMI flag for supported disc types

Redumper

Key Type Default Description
RedumperEnableDebug bool false Enable debug output while dumping by default
RedumperEnableLeadinRetry bool false Enable Redumper custom lead-in retries for Plextor drives
RedumperEnableSkeleton bool true Enable skeleton output while dumping by default
RedumperEnableVerbose bool true Enable verbose output while dumping by default
RedumperLeadinRetryCount int 4 Default number of redumper Plextor leadin retries
RedumperNonRedumpMode bool false Enable options incompatible with redump submissions
RedumperUseGenericDriveType bool false Enable generic drive type by default with Redumper
RedumperReadMethod string? "NONE" Currently selected default redumper read method
RedumperSectorOrder string? "NONE" Currently selected default redumper sector order
RedumperRereadCount int 20 Default number of rereads

RedumperReadMethod Values

Value Note
NONE Default, not used
BE
D8
BE_CDDA Currently an alias for BE

RedumperSectorOrder Values

Value Note
NONE Default, not used
DATA_C2_SUB
DATA_SUB_C2
DATA_SUB
DATA_C2

Extra Dumping Options

Key Type Default Description
ScanForProtection bool true Scan the disc for protection after dumping
AddPlaceholders bool true Add placeholder values in the submission info
PromptForDiscInformation bool true UI ONLY Show the disc information window after dumping
PullAllInformation bool false Pull all information from Redump if signed in
EnableTabsInInputFields bool true UI ONLY Enable tabs in all input fields
EnableRedumpCompatibility bool true Limit outputs to Redump-supported values only
ShowDiscEjectReminder bool true UI ONLY Show disc eject reminder before the disc information window is shown
IgnoreFixedDrives bool true UI ONLY Ignore fixed drives when populating the list
AddFilenameSuffix bool false Add the dump filename as a suffix to the auto-generated files
OutputSubmissionJSON bool false Output the compressed JSON version of the submission info
IncludeArtifacts bool false Include log files in serialized JSON data
CompressLogFiles bool true Compress output log files to reduce space
DeleteUnnecessaryFiles bool false Delete unnecessary files to reduce space
CreateIRDAfterDumping bool false PS3 ONLY Create a PS3 IRD file after dumping PS3 BD-ROM discs

Skip Options

Key Type Default Description
SkipMediaTypeDetection bool false UI ONLY Skip detecting media type on disc scan
SkipSystemDetection bool false UI ONLY Skip detecting known system on disc scan

Protection Scanning Options

Key Type Default Description
ScanArchivesForProtection bool true Scan archive contents during protection scanning
IncludeDebugProtectionInformation bool false Include debug information with scan results
HideDriveLetters bool false Remove drive letters from protection scan output

Logging Options

Key Type Default Description
VerboseLogging bool true Enable verbose and debug logs to be written
OpenLogWindowAtStartup bool true UI ONLY Have the log panel expanded by default on startup

Redump Login Information

Key Type Default Description
RedumpUsername string? "" Redump username
RedumpPassword string? "" Redump password

Clone this wiki locally