innoextract --list [options] [--] installers ...
innoextract --test [options] [--] installers ...
innoextract will extract files from installers specified on the command line.
To extract a multi-part installer with external data files, only the executable (.exe) file needs to be given as an argument to innoextract.
Here is a short summary of the options available in innoextract. Please refer to the detailed documentation below for a complete description.
-h --help Show supported options
-v --version Print version information
--license Show license information
-t --test Only verify checksums, don't write anything
-e --extract Extract files (default action)
-l --list Only list files, don't write anything
--list-sizes List file sizes
--list-checksums List file checksums
-i --info Print information about the installer
--list-languages List languages supported by the installer
--gog-game-id Determine the GOG.com game ID for this installer
--show-password Show password check information
--check-password Abort if the password is incorrect
-V --data-version Only print the data version
--codepage CODEPAGE Encoding for ANSI strings
--collisions ACTION How to handle duplicate files
--default-language Default language for renaming
--dump Dump contents without converting filenames
-L --lowercase Convert extracted filenames to lower-case
-T --timestamps TZ Timezone for file times or "local" or "none"
-d --output-dir DIR Extract files into the given directory
-P --password PASSWORD Password for encrypted files
--password-file FILE File to load password from
-g --gog Process additional archives from GOG.com installers
--no-gog-galaxy Don't re-assemble GOG Galaxy file parts
-n --no-extract-unknown Don't extract unknown Inno Setup versions
-m --exclude-temp Don't extract temporary files
--language LANG Extract only files for this language
--language-only Only extract language-specific files
-I --include EXPR Extract only files that match this path
-q --quiet Output less information
-s --silent Output only error/warning information
--no-warn-unused Don't warn on unused .bin files
-c --color[=ENABLE] Enable/disable color output
-p --progress[=ENABLE] Enable/disable the progress bar
The password checksum used for this check can be retrieved using the --show-password option.
On non-Windows platforms, innoextract will ignore the system locale and always use UTF-8 as the filesystem and standard output encoding - the --codepage option only changes the input encoding. However, using codepage number "65001" instructs innoextract to assume all strings are already encoded as UTF-8 and to output them without conversion.
This option has no effect with Unicode-enabled installers, which always use UTF-16LE. Invalid UTF-16 data is represented using the WTF-8 encoding which is a straightforward extension of UTF-8 to represent unpaired UTF-16 surrogate code units.
1. If the component is not the same for all files in the collision set (all files with the same filename), "#" (without quotes) followed by the component id is appended to all files that are specific to a single component.
2. If the language is not the same for all files in the collision set, "@" (without quotes) followed by the language id is appended to all files that are specific to a single language unless that language matches the default language specified by the --default-language. While the suffix is omitted for the default language, no numbered suffix is added in it's place unless needed to make the filename unique.
3. If the architecture is not the same for all files in the collision set, "@32bit" or "@64bit" (without quotes) is appended to all files that are specific to a single architecture.
4. If no suffix was added by the previous steps, or if the filename is not yet unique, "$" (without quotes) followed by the lowest integer (starting at 0) to make the filename unique is appended.
With the "rename" action, steps 1 and 3 are only applied to files that would have been overwritten by the "overwrite" action while "rename-all" applies them to all files in the collision set.
The version printed using this option is the one stored in the setup file and can differ from the version printed with other actions as the stored data version is not always correct.
This option can be used to determine if a file is an Inno Setup installer without loading any compressed headers.
This option cannot be combined with any other action.
With --collisions=overwrite (the default) this will change the choice of which file to keep to always prefer the given language. In effect, --default-language behaves almost like --language, except that files are extracted for all languages if they have different names.
When using the --collisions=rename option, --default-language chooses a language for which the files should keep the original name if possible.
When combining --dump with --extract innoextract will not ensure that the paths don't point outside the destination directory. Use this option with caution when handling untrusted files.
This option takes precedence over --include and --language: temporary files are never extracted when using the --exclude-temp, even if they match the selected language or include expressions.
By default innoextract will continue after encountering file checksum errors. The --extract option can be combined with --test to abort on checksum errors.
Extracting these RAR archives requires rar, unrar or lsar/unar command-line utilities to be in the PATH.
The --list, --test, --extract and --output-dir options are passed along to unrar/unar, but other options may be ignored for the RAR files. For multi-part RAR archives, the --test requires a writable output directory for temporary files which can be specified using the --output-dir option. If the output directory does not exist it will be created and then removed after testing is done. Parent directories are not created. Temporary files created inside the directory are always removed.
Note that is option is geared towards GOG.com installers. Other installers may come be bundled with different extraneous .bin which this option might not be able to handle.
This option also forces re-assembly of GOG Galaxy file parts. See the --no-gog-galaxy option for details.
GOG.com installers are detected using the publisher and URL fields in the setup headers. Use the --gog option to force reassembly for all installers.
This option can be combined with --silent to print only the game ID without additional syntax that would make consumption by other scripts harder.
The --gog-game-id action can be combined with --list, --test, --extract and/or --list-languages. If --silent and --gog-game-id are combined with --list and/or --list-languages, the game ID (or an empty line) will be printed on it's own line before the file list but after the language list.
For newer multi-part GOG.com installers the .bin files are not part of the Inno Setup installer but instead are RAR archives. Some of these RAR files are encrypted, with the password being the MD5 checksum of the game ID:
innoextract --gog-game-id --silent setup_....exe | md5sum | cut -d ' ' -f 1
The expression is always matched against one or more full path components. Filtering by parts of filenames is currently not supported. Matching is done case-insensitively.
EXPR may contain one leading path separator, in which case the rest of the expression is matched against the start of the path. Otherwise, the expression is matched against any part of the path.
The --include option may be repeated in order allow files matching against one of multiple patterns. If --include is not used, all files are processed.
Scrips should not rely on the output format with this option and should instead enable the individual actions instead.
Currently this option enables --list-languages, --gog-game-id and --show-password.
To also skip language-independent files, combine this option with --language-only.
This option can be combined with --language to only extract the files of a specific language.
This action also enables the --list-sizes action unless either --quiet or --silent is specified.
This option can be combined with --silent to print only the names of the contained files (one per line) without additional syntax that would make consumption by other scripts harder.
The --list action can be combined with --test, --extract, --list-languages and/or --gog-game-id to display the names of the files as they are extracted even with --silent.
This option implies the --list action and can be combined with the --list-sizes option to print both the size and checksum for each file.
With --silent the file checksum will be printed at the start of the line (but after the file size if enabled with the --list-sizes option) followed by a space. Otherwise the checksum is printed after the file name.
The checksum type can be one of Adler32, CRC32, MD5 or SHA-1 and is printed in fron of the checksum hash followed by a space. Adler32 and CRC32 checksums are printed as "0x" followed by the 32-bit hexadecimal value.
Different files in the same installer can have different checksum types if GOG Galaxy file part reassembly is not disabled using the --no-gog-galaxy option.
This option can be combined with --silent to print only the identifiers of the languages (one per line) followed by a space and then the language name, without additional syntax that would make consumption by other scripts harder.
The --list-languages action can be combined with --list, --test, --extract and/or --gog-game-id to display the available languages before doing anything else. If --silent and --list-languages are combined with --list and/or --gog-game-id, the languages list will be terminated with an empty line and will precede both the game ID and files list.
This option implies the --list action and can be combined with the --list-checksums option to print both the size and checksum for each file.
With --silent the file size in bytes will be printed at the start of the line followed by a space. Otherwise the size is printed after the file name in a human-friendly format.
If the specified directory does not exist, it will be created. However, the parent directory must exist or extracting will fail.
Use the --password-file option to load the password from a file or standard input instead. This option cannot be combined with --password-file.
If this password does not match the checksum stored in the installer, encrypted files will be skipped but unencrypted files will still be extracted. Use the --check-password option to abort processing entirely if the password is incorrect.
If the special file name "-" is used, the password will be read from standard input.
Use the --password option to specify the password on the command-line instead. This option cannot be combined with --password.
If this password does not match the checksum stored in the installer, encrypted files will be skipped but unencrypted files will still be extracted. Use the --check-password option to abort processing entirely if the password is incorrect.
$c = hash($s . $p)
With the --silent option, the checksum name and hash is printed on one line seperated by a space followed by the salt encoded as hex bytes and password encoding on separate lines.
Checksum types can be CRC32, MD5 or SHA-1 although CRC32 is not used in installers with encryption.
Use the --password or --password-file option together with --check-password to check if a password matches this checksum.
This option can be combined with --list to print only the names of the contained files (one per line) without additional syntax that would make consumption by other scripts harder.
This option can be combined with --extract to abort on file checksum errors.
The --timestamps option specifies what timezone should be used to adjust these 'local' file times.
Valid values are those accepted by tzset in the TZ environment variable, except with the direction of the time offset reversed: both -T CET and -T GMT+1 will (when DST is in effect) give the same result.
Besides timezones, two special values are accepted:
The default value for this option is UTC, causing innoextract to not adjust 'local' file times. File times marked as UTC in the Inno Setup file will never be adjusted no matter what --timestamps is set to.
If combined with the --silent option, only the version number is printed. Otherwise, the output will contain the name (innoextract) followed by the version number on the first line, and, unless the --quiet options is specified, the range of suuported Inno Setup installer versions on the second line.
There is currently no way to configure this expansion except for disabling it with the --dump option.
Included scripts and checks are not executed.
The mapping from Inno Setup constants like the application directory to subdirectories is hard-coded.
Names for data slice/disk files in multi-file installers must follow the standard naming scheme.
Please report bugs to https://innoextract.constexpr.org/issues.
innoextract is distributed under the zlib/libpng license. See the LICENSE file for details.
A website is available at https://constexpr.org/innoextract/.
This program uses the excellent lzma/xz decompression library written by Lasse Collin.