Skip to content

MPF Check

Matt Nadareski edited this page Jul 19, 2024 · 9 revisions

MPF Check

MPF Check is an optional commandline component in the MPF project. This came about as a response to a lack of UI support on the Linux side. The goal of this program is to provide the same powerful library parsing and generation but without having to deal with the actual dumping part.

Usage

MPF.Check.exe [standalone] <mediatype> <system> [options] </path/to/output.cue|.iso> ...

Standalone Options

Flags Short Description Long Description
-h, -? Show help Displays a help text to show possible options and parameters.
-lm, --listmedia List media types Shows a list of all possible media types, including ones that are currently unsupported
-lp, --listprograms List programs Shows a list of currently supported dumping and verification programs
-ls, --listsystems List systems Shows a list of all possible systems, including the ones that are currently unsupported

Media Types

Below is a list of currently dumpable or verifiable media types along with a brief description:

Value Description
bd, bdrom Blu-Ray and variants
cd, cdrom Compact Disc and variants
dvd, dvdrom Digital Versatile Disc and variants
fd, floppy Floppy disk and diskette
gd, gdrom Gigabyte Disc
hddvd High Definition Digital Versatile Disc
hdd Hard disk drive and variants
gc, gamecube GameCube Game Disc (Mini-DVD based)
umd Universal Media Disc
wii Wii Optical Disc (DVD based)
wiiu WiiU Optical Disc (BD based)

System Types

There are a lot of systems that are technically supported for dumping and verification if only because a lot of media is similarly accessible. For convenience, the list of currently accepted systems below has been separated into categories. Each entry has the short name used for MPF Check along with a brief description.

Arcade

Value Description
cubo Amiga CUBO CD32
alg3do American Laser Games 3DO
atari3do Atari 3DO
atronic Atronic
auscom AUSCOM System 1
gamemagic Bally Game Magic
cps3 Capcom CP System III
fpp funworld PHOTO PLAY
photoplay funworld PHOTO PLAY PC-Based Systems
globalvr Global VR PC-Based Systems
vortek Global VR Vortek
vortekv3 Global VR Vortek V3
ice ICE PC-Based Systems
iteagle Incredible Technologies Eagle
itpc Incredible Technologies PC-Based Systems
eamusement Konami e-Amusement
firebeat Konami FireBeat
gvsystem Konami GV System
konamim2 Konami M2
python Konami / Bemani Python
python2 Konami / Bemani Python 2
system573 Konami System 573
twinkle Konami Twinkle
konamipc Konami PC-Based Systems
boardwalk Merit Industries Boardwalk
megatouchforce Merit Industries MegaTouch Force
megatouchion Merit Industries MegaTouch ION
megatouchmaxx Merit Industries MegaTouch Maxx
megatouchxl Merit Industries MegaTouch XL
system12 Namco System 12
system246 Namco System 246 and variants
system256 Namco System 256 and variants
system357 Namco System 357
newjatrecdi New Jatre CD-i
hrs Nichibutsu High Rate System
supercd Nichibutsu Super CD
xrs Nichibutsu X-Rate System
triforce Sega/Namco/Nintendo Triforce
panasonicm2 Panasonic M2
rawthrills Raw Thrills PC-Based Systems
chihiro Sega Chihiro
europar Sega Europa-R
lindbergh Sega Lindbergh and variants
naomi Sega Naomi
naomi2 Sega Naomi 2
nu Sega Nu
ringedge Sega RingEdge
ringedge2 Sega RingEdge 2
ringwide Sega RingWide
stv Sega Titan Video
system32 Sega System 32
cats Seibu CATS System
quizard TAB-Austria Quizard
tsumo Tsunami TsuMo Multi Game Motion System

Computers

Value Description
acorn Acorn Archimedes CD
apple, mac Apple Macintosh
amiga Commodore Amiga
fmt, fmtowns Fujitsu FM Towns
ibm, ibmpc, pc IBM PC-Compatibles
pc88 NEC PC-88 series
pc98 NEC PC-98 series
x68k Sharp X68000

Consoles

Value Description
3do 3DO Interactive Multiplayer
jaguar Atari Jaguar CD
pippin Apple-Bandai Pippin ATMARK and @WORLD
playdia Bandai Playdia Quick Interactive System
cd32 Commodore Amiga CD32
cdtv Commodore CDTV
evosc Envizions EVO Smart Console
fmtm Fujitsu FM Towns Marty
videonow Hasbro VideoNow
videonowcolor Hasbro VideoNow Color
videonowjr Hasbro VideoNow Jr.
videonowxp Hasbro VideoNow XP
ixl Mattel / Fisher Price iXL Learning System
hyperscan Mattel HyperScan
xbox Microsoft Xbox
x360 Microsoft Xbox 360
xb1 Microsoft Xbox One
xbseries Microsoft Xbox Series X and Series S
pcecd NEC PC-Engine CD / TurboGrafx CD
pcfx NEC PC-FX and PC-FXGA
gc, ngc Ninendo GameCube
wii Nintendo Wii
wiiu Nintendo WiiU
snescd Nintendo-Sony Super Nintendo Entertainment System CD
cdi Philips Compact Disc-Interactive
dc Sega Dreamcast
mcd, scd Sega Mega-CD / Sega CD / Sega 32X CD
saturn Sega Saturn
ngcd SNK Neo Geo CD
ps1, psx Sony PlayStation and PSX
ps2 Sony PlayStation 2
ps3 Sony PlayStation 3
ps4 Sony PlayStation 4
ps5 Sony PlayStation 5
psp Sony PlayStation Portable
vis Tandy-Memorex Visual Information System
nuon VM Labs Nuon
vflash, vsmile VTech V.Flash and V.Smile Pro
gamewave ZAPiT Games GameWave Family Entertainment System

Other

Value Description
audio, audiocd Audio CD
bdvideo Blu-Ray Video
dvda, dvdaudio DVD-Audio
dvd, dvdv, dvdvideo DVD-Video
enhancedcd Enhanced CD
hddvd, hddvdv, hddvdvideo HD-DVD-Video
naviken Navisoft Naviken 21
palm, palmos Palm Software on CD
cdidv Philips CD-i Digital Video
photo, photocd Photo-CD
gameshark PlayStation GameShark Update discs
rainbow Rainbow Disc
pl21, prologue21 Sega Prologue 21
sacd Super Audio CD
iktv Tao iKTV
kisssite Tomy Kiss-Site
vcd Video CD

Options

Flags Short Description Long Description
-u <program>
--use <program>
Set dumping program By default, MPF Check will assume that you are verifying a DiscImageCreator output. If this is not the case, you can set the program using this flag. See Overview for more details about supported programs.
-c <username> <password>
--credentials <username> <password>
Redump Credentials Optionally, include Redump credentials for pulling extra information from the site when generating the submission information
-a
--pull-all
Pull all info Requires --credentials. Optionally, pull all disc information from redump, even information that varies between discs with the same data.
-p <path>
--path <path>
Set drive path Optionally, include the path that contains the original media related to the output. This can allow for extra information to be included that would otherwise be skipped without original media.
-s
--scan
Scan for protection Requires -p, --path. Optionally, scan the original media for copy protection using the built-in BinaryObjectScanner library.
-g
--hide-drive-letters
Hide drive letters Requires -f, --protect-file. Optionally, hide drive letters in the protection information file (Windows-only).
-l
--load-seed <path>
Load seed JSON Optionally, loads a seed submission JSON file for user information.
-x
--suffix
Add filename suffix Optionally, adds a suffix to the produced filenames.
-j
--json
Output JSON Optionally, outputs a JSON formatted submission information file.
-z
--zip
Zip logfiles Optionally, compress the log files into a named zip archive.
-d
--delete
Delete unecessary files Optionally, deletes all unnecessary files (auxiliary files produced by the dumping program that are not required for submission).

Examples

Verify an IBM PC-Compatible CD dumped by DiscImageCreator and pull information from Redump without the original disc.

cd ibm -c username password path\to\track.cue

Verify a Sony PlayStation CD dumped with DiscImageCreator, pull information from Redump, and pull information from the disc.

cd psx -c username password -p D: path\to\track.cue

Verify a Wii disc dumped by CleanRip and pull information from Redump.

wii wii -c username password -u cleanrip path\to\track.iso

Verify a DVD-Video dumped by Aaru.

dvd dvdv -u aaru path\to\track.iso

Verify an IBM PC-Compatible DVD dumped by DiscImageCreator, scan for copy protection, and get information from the original disc.

dvd ibm -p D: -s path\to\track.iso

Verify a Sony PlayStation Portable UMD dumped with UmdImageCreator.

umd psp -u uic path\to\track.iso