mirror of
https://github.com/mon/ifstools.git
synced 2025-02-25 21:58:21 +01:00
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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
|
|
`pip install git+https://github.com/mon/kbinxml/ git+https://github.com/mon/ifstools/`
|
|
|
|
## Usage
|
|
```
|
|
usage: ifstools [-h] [-y] [-o OUT_DIR] [--tex-only] [--nocache] [-s] [-r]
|
|
file.ifs|folder_ifs [file.ifs|folder_ifs ...]
|
|
|
|
Unpack/pack IFS files and textures
|
|
|
|
positional arguments:
|
|
file.ifs|folder_ifs files/folders to process. Files will be unpacked,
|
|
folders will be repacked
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
-y don't prompt for file/folder overwrite
|
|
-o OUT_DIR output directory
|
|
--tex-only only extract textures
|
|
--nocache ignore texture cache, recompress all
|
|
-s, --silent don't display files as they are processed
|
|
-r, --norecurse if file contains another IFS, don't extract its
|
|
contents
|
|
```
|
|
|
|
Notes:
|
|
- dxt5 texture repacking is not fully supported - they will silently be converted to argb8888rev
|
|
|
|
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.
|