Required python libraries

pip install kaitaistruct
pip install numpy
pip install tqdm

run.py

ffxiv-tex-converter, FFXIV TEX FILE CONVERTER

options:
  -h, --help            show this help message and exit
  --directory -D, -d -D
                        Initial directory to be processed.
  --command -C, -c -C   dds-to-tex, tex-to-dds
  --parallel, --no-parallel, -p
                        multicore processing
  --multiplier -M, -m -M
                        if using multicore processing, job multiplier per core. default = 5

Accepts nested directory structures.
Supports BGRA, BGRX, BC1 (DXT1), BC2 (DXT3), BC3 (DXT5), and BC7, A8, L8, BGRA4.

Usage examples:

given directory "dog" has dds files I want to convert to FFXIV tex files.

Run this command: python run.py -d dog -c dds-to-tex

I want to run it faster: python run.py -d dog -c dds-to-tex -p -m 10

It will output to "dog_tex" directory.

given directory "cat" has FFXIV tex files I want to convert to DDS files.

Run this command: python run.py -d cat -c tex-to-dds

I want to run it faster: python run.py -d cat -c tex-to-dds -p -m 10

It will output to "cat_dds" directory.

Why should I use this over TexTools?

TexTools breaks mipmaps. Either by falsely calculating the offset, or just erasing the end of the file.
TexTools doesn't support writing many files at once.
Textools can't interact with most game textures. TexTools only interacts with character and housing textures.

When should I use TexTools Texture Importer?

If mipmaps don't bother you, go ahead.
If you want to write directly to the game files. Please don't.
If you are working on a file, and you want to immediately see results USE PENUMBRA IMPORT.

Penumbra Import

Penumbra also has a BC7/BC3/BGRA8 import
Use this if you don't need to batch convert or use an esoteric file type.

I personally still use TexTools for a lot of stuff. Please don't perpetuate cultish behavior around mod tools. It's weird.

parsers

dds.ksy

kaitai struct to read dds header, body. body reading is only rudimentary to reach EOF.
Read Microsoft DDS_Header Docs for more info.

dds.py

kaitai generated parser of dds for python. I did have to modify some Enum to be IntFlag instead, as the compiler did not do that for me. Just an FYI if you re-compile the dds.ksy for python you might have to redo that.
Read Microsoft DDS_Header Docs for more info.

tex.ksy

kaitai struct to read tex header, body. body reading is only rudimentary to reach EOF.
See Penumbra/TexTools/Lumina source code for more info.

tex.py

*same as the dds.py info really.

emarron/ffxiv-tex-converter