ifstools

Extractor for Konmai IFS files.

Features

• Converts all textures to png without requiring a second program
• Repacks without ingame display issues
• Multithreaded recompression
• Only changed textures are recompressed, the rest are cached
• Works on eacloud music ifs files
• Correctly names files under afp, bsi and geo folders
• Converts internal binary xmls to plaintext, to facilitate further experimentation.
• Dumps the ifs manifest so you can explore the format

Install

Just want an exe? Download the latest.

Have Python installed? Do this: pip install ifstools
Then run ifstools from anywhere in a command prompt.

Have uv installed? You can just uvx ifstools.

Usage

usage: ifstools [-h] [-e] [-y] [-o OUT_DIR] [--tex-only] [-c]
                       [--bounds] [--uv] [--no-cache] [--flags FLAG[,FLAG...]]
                       [-m] [-s] [-r]
                       file_to_unpack.ifs|folder_to_repack_ifs
                       [file_to_unpack.ifs|folder_to_repack_ifs ...]

Unpack/pack IFS files and textures

positional arguments:
  file_to_unpack.ifs|folder_to_repack_ifs
                        files/folders to process. Files will be unpacked,
                        folders will be repacked

optional arguments:
  -h, --help            show this help message and exit
  -e, --extract-folders
                        do not repack folders, instead unpack any IFS files
                        inside them
  -y                    don't prompt for file/folder overwrite
  -o OUT_DIR            output directory
  --tex-only            only extract textures
  -c, --canvas          dump the image canvas as defined by the
                        texturelist.xml in _canvas.png
  --bounds              draw image bounds on the exported canvas in red
  --uv                  crop images to uvrect (usually 1px smaller than
                        imgrect). Forces --tex-only
  --no-cache            ignore texture cache, recompress all
  --rename-dupes        if two files have the same name but differing case
                        (A.png vs a.png) rename the second as "a (1).png" to
                        allow both to be extracted on Windows
  --flags FLAG[,FLAG...]
                        flags to use when repacking. Almost never need to set
                        this, but some old games don't support HasMD5.
                        One or more of:
                        ManifestHasTimestamps,HasMD5,UncompressedManifest
                        Default:
                        ManifestHasTimestamps,HasMD5
  -m, --extract-manifest
                        extract the IFS manifest for inspection
  --super-disable       only extract files unique to this IFS, do not follow
                        "super" parent references at all
  --super-skip-bad      if a "super" IFS reference has a checksum mismatch, do
                        not extract it
  --super-abort-if-bad  if a "super" IFS reference has a checksum mismatch,
                        cancel and display an error
  -s, --silent          don't display files as they are processed
  -r, --norecurse       if file contains another IFS, don't extract its
                        contents

Build an exe

uv venv --clear
uv pip install . pyinstaller==6.19.0
uv run pyinstaller --onefile --name ifstools ifstools_bin.py

Todo:

• Recursive repacking for ifs inside ifs

I hope the rest is self explanatory. Confused? Create a new issue and tell me what docs to add.