FriiDumpOptical disc dumping tools

Documentation

FriiDump 0.5.3.16-pf1 user manual

This manual documents complete-package installation, optical-drive identification, media-specific commands, Redump DAT verification, native reports, and troubleshooting.

Overview

FriiDump is a command-line disc-dumping application for supported Nintendo GameCube, Nintendo Wii, standard readable DVD-ROM, and selected Original Xbox/XGD workflows. Hardware compatibility is specific to the optical-drive model and firmware revision.

Installation

The complete platform packages include the executable, documentation, package manifest, checksums, and the Redump DAT runtime directory.

Windows

PowerShell package setup

Package
The Windows complete-package ZIP contains friidump.exe and its supporting files.
Extraction
The archive is extracted in full to a normal writable directory.
Directory layout
friidump.exe, redump_dat, docs, SHA256SUMS, and package-manifest.json remain together.
Verification and launch
The executable is verified before FriiDump is launched from a PowerShell or Command Prompt window opened with Run as administrator.
Get-FileHash .\friidump.exe -Algorithm SHA256
.\friidump.exe --help

Linux

Shell package setup

Package
The Linux complete-package ZIP contains friidump and its supporting files.
Extraction
The archive is extracted in full to a normal writable directory.
Directory layout
friidump, redump_dat, docs, SHA256SUMS, and package-manifest.json remain together.
Verification and launch
Package checksums are verified before raw-I/O capability is assigned to the exact executable.
chmod 755 ./friidump
sha256sum -c SHA256SUMS
sudo setcap cap_sys_rawio=ep ./friidump
getcap ./friidump
./friidump --help
Windows authorization: FriiDump must be launched from PowerShell, Windows Terminal, or Command Prompt opened with Run as administrator. A non-elevated process may be unable to issue the raw optical-drive commands required for dumping.
Linux authorization: FriiDump operates under the normal user account. Replacing or rebuilding the executable clears its file capability, so the replacement must be validated before cap_sys_rawio=ep is assigned again.

Drive identification

The operating-system device path and the live drive model and firmware must match the intended hardware before a dumping workflow begins.

Windows

Optical-drive inventory

Get-CimInstance Win32_CDROMDrive |
    Select-Object Drive, Manufacturer, Name, MediaLoaded

The device argument is normally a drive letter such as E:.

Linux

Optical-device inventory

lsblk -S -o NAME,VENDOR,MODEL,REV,TRAN

USB optical devices are assigned dynamically and may appear as /dev/sr1 or another device path after reconnection.

Dumping commands

Windows PowerShell invokes .\friidump.exe; a Linux shell invokes ./friidump. The media options and output behavior are otherwise equivalent.

GameCube or Wii

Windows PowerShell

.\friidump.exe -d <drive> -8 -s -i game.iso

Linux shell

./friidump -d <drive> -8 -s -i game.iso

Standard readable DVD

Windows PowerShell

.\friidump.exe -d <drive> -D -i dvd.iso

Linux shell

./friidump -d <drive> -D -i dvd.iso

Original Xbox/XGD redump-style image

Windows PowerShell

.\friidump.exe -d <drive> -T 4 -i xbox.iso

Linux shell

./friidump -d <drive> -T 4 -i xbox.iso

Original Xbox/XGD game-partition XISO

Windows PowerShell

.\friidump.exe -d <drive> -T 4 -X xbox.xiso

Linux shell

./friidump -d <drive> -T 4 -X xbox.xiso

-s enables resume for a partial dump. Ctrl+C requests controlled cancellation. Game-partition XISO output is not compared with the full-disc Xbox DAT.

Redump DAT files

The bundled Logiqx XML exports from redump.org are runtime inputs. They are not compiled into the FriiDump executable.

MediaStable filename
GameCubeNintendo - GameCube.dat
Wii / Wii DLNintendo - Wii.dat
Xbox/XGD redump-style ISOMicrosoft - Xbox.dat

Discovery order

  1. --redump-dat-dir <directory> - authoritative command-line directory.
  2. FRIIDUMP_REDUMP_DAT_DIR - authoritative environment directory.
  3. redump_dat beside the executable.
  4. Installed Unix path ../share/friidump/redump_dat.
  5. ./redump_dat under the working directory.

An exact MATCH requires the output size, CRC32, MD5, and SHA-1 to match one DAT entry. SHA-256 is still calculated but is not a Logiqx DAT field. A missing DAT file or NO MATCH result does not modify the image.

Bundled DAT snapshot

Nintendo - GameCube.dat
Version
2026-06-13 18-14-01
Date
2026-06-13 18-14-01
SHA-256
38eb4a26c778a505561816a41374c89b97c0c6317980fd4f7216a6a3a4b8d908
Nintendo - Wii.dat
Version
2026-06-15 03-13-28
Date
2026-06-15 03-13-28
SHA-256
e72922f919e0625075626cbc9dbd9fbd9530580b572f945002a844787e2b8419
Microsoft - Xbox.dat
Version
2026-06-14 23-43-27
Date
2026-06-14 23-43-27
SHA-256
175a91029994d5259068c5c932c42676b0385345c8eaeaaf0583d8b4897793c6

Native reports

Normal dump invocations create one UTF-8 friidump-test-result.v1 report beside the final log. The conventional filename ends in .friidump.json. One report represents one run, one disc, and one drive.

Windows

PowerShell examples

.\friidump.exe -d <drive> -8 -s -i game.iso --report-dir reports
.\friidump.exe -d <drive> -8 -s -i game.iso --report-json custom-evidence.json
.\friidump.exe -d <drive> -8 -s -i game.iso --firmware-modified "patched firmware explanation"

Linux

Shell examples

./friidump -d <drive> -8 -s -i game.iso --report-dir reports
./friidump -d <drive> -8 -s -i game.iso --report-json custom-evidence.json
./friidump -d <drive> -8 -s -i game.iso --firmware-modified "patched firmware explanation"

Troubleshooting

DAT NOT FOUND

The runtime DAT directory is missing, or an authoritative override points to an invalid location. The packaged redump_dat directory must remain beside the executable unless an explicit directory is configured.

Windows access denied or vendor-command failure

Close the non-elevated terminal, open PowerShell, Windows Terminal, or Command Prompt with Run as administrator, and retry with the verified executable and intended drive.

Linux vendor-command failure

The executable must retain cap_sys_rawio=ep. Execution as root is not supported.

Wrong optical device

Device paths can change after optical hardware is reconnected. Device discovery and the live INQUIRY model and firmware must identify the intended drive.

NO MATCH

The image does not match an entry in the selected DAT. The image, hashes, log, and report should be retained for review.

Partial dump

A partial image can be resumed with -s and the original output path.

Drive remains spinning

Spin-down is available after the active command returns: friidump -d <drive> --stop.