Skip to content

Extract Restore

Matt Nadareski edited this page Sep 19, 2025 · 4 revisions

Extract and Restore Headers

These two features are paired up because Restore does not work properly unless Extract has been run first. If you're not aware of what copier headers are, please take a look at No-Intro or something similar that uses these extensively. The basic premise is that there's additional data somewhere in the file that is not part of the original game data and these headers can be added or removed without harming that data.

Please see Copier Headers for more information about supported formats.

Extract

Flags: -ex, --extract

This will detect, store, and remove copier headers from a file or folder of files. The headers are backed up and collated by the hash of the unheadered file. Files are then output without the detected copier header alongside the originals with the suffix .new. No input files are altered in the process. Only uncompressed files will be processed.

Options

Flags Short Description Long Description
-out=, --output-dir= Set output directory This sets an output folder to be used when the files are created. If a path is not defined, the runtime directory is used instead.
-nsh, --no-store-header Don't store extracted headers By default, all headers that are removed from files are backed up in the database. This flag allows users to skip that step entirely, avoiding caching the headers at all.

Examples

Remove all headers from a headered set and store them in an "unheadered" folder

--extract --output-dir=path\to\unheadered path\to\headered

Restore

Flags: -re, --restore

This will make use of stored copier headers and reapply them to files if they match the included hash. More than one header can be applied to a file, so they will be output to new files, suffixed with .newX, where X is a number. No input files are altered in the process. Only uncompressed files will be processed.

Options

Flags Short Description Long Description
-out=, --output-dir= Set output directory This sets an output folder to be used when the files are created. If a path is not defined, the runtime directory is used instead.

Examples

Restore extracted headers from a headered set and store the result in the headered folder

--restore --output-dir=path\to\headered path\to\unheadered

Clone this wiki locally