📦 STX Editor v1.0.0
Game Texture Modding Tool – Unpack, Enhance, and Repack STX Archives

🎯 Overview
STX Editor is a professional‑grade desktop application designed for game texture modding. It allows you to:

Unpack .stx archives to extract all embedded images.

Enhance textures using ImageMagick (sharpening, resizing, color correction) and AI Super‑Resolution (4× upscaling with ONNX models).

Preview original vs. processed images side‑by‑side.

Repack modified images back into .stx files – ready for use in your favourite games.

Built with customtkinter and powered by ONNX Runtime, it offers a modern, user‑friendly interface and supports batch processing for entire folders.

✨ Key Features
Feature Description
🔧 Flexible Settings Configure ImageMagick path, AI model, resize, sharpen, quality, and extra arguments – all saved globally.
📦 Unpack Extract all images from a single .stx file or recursively from a folder of .stx files.
📦 Pack (Simple) Quickly pack a folder of JPEGs into a new .stx archive without any processing.
⚡ Process + Pack Apply ImageMagick + AI enhancements to every image inside an .stx archive, preview the results, and repack automatically.
🎮 Playground Interactive environment to load an .stx file, test different settings in real‑time, and see original vs. processed images side‑by‑side.
⏸️ Pause / Resume Pause and resume long‑running batch jobs at any time.
📂 Copy Tree Duplicate entire folder structures (useful for backup or batch preparation).
🖼️ Preview Gallery Compare original and processed images before final packing – choose which ones to keep.
⚙️ AI Super‑Resolution Use any ONNX‑compatible super‑resolution model (e.g. realesr-general-x4v3, 4x_foolhardy_Remacri) to upscale textures by 4×.
🔄 Tile‑based Processing Large images are automatically split into tiles, processed, and stitched back together – saving VRAM and preventing crashes.

🖥️ System Requirements
Operating System – Windows 10 / 11 (64‑bit)

Architecture – x86_64

RAM – 8 GB recommended (4 GB minimum)

GPU – Optional (NVIDIA CUDA supported), but CPU works as well

Disk Space – ~2 GB for temporary extraction and processing

💾 Required External Software
ImageMagick 7 (64‑bit) – Download
(Ensure magick.exe is installed; default path is C:\Program Files\ImageMagick-7.1.2-Q16-HDRI\magick.exe)

Microsoft Visual C++ Redistributable 2015-2022
(Required for onnxruntime and opencv)

📥 Installation & Setup
Download and run STX Editor v1.0.0.exe from this page.

Place it in any folder (e.g. C:\STXEditor).

Download your preferred ONNX model (e.g. 4x_foolhardy_Remacri.onnx) and place it anywhere you like.

Ensure ImageMagick is installed on your system.

Double‑click the .exe to launch the application.

On Settings
Set the path to your magick.exe.

(Optional) Select your ONNX model file and enable AI.

Adjust ImageMagick parameters (Resize, Sharpen, Quality, Extra args) and AI settings (Max Size, Extra args).

Click Save.

2. Unpack an STX File
Go to File Operations → Unpack.

Choose an .stx file or a folder containing .stx files.

Select an output folder.

The tool will extract all embedded images as JPEG/PNG files.

3. Process + Pack (End‑to‑End Enhancement)
Go to Processing → Process + Pack.

Choose a single .stx file or a folder containing .stx files.

Select an output folder.

The tool will:

Extract images.

Apply ImageMagick + AI enhancements.

Show a preview gallery where you can accept/reject each processed image.

Repack selected images into a new .stx archive.

4. Playground – Test & Preview
Go to Processing → Playground.

Load an .stx file.

Browse through the extracted images on the left.

Tweak settings in the panel.

Click 💾 Save & Process to apply changes and see the original vs. processed images side‑by‑side.

5. Pack (Simple Mode)
If you already have pre‑processed JPEGs, go to File Operations → Pack.

Select a folder containing your JPEGs.

Choose an output folder – a new .stx file will be created.

🛠️ Understanding the Settings
Setting Description
Resize Resize factor (e.g. 200%) or exact geometry (800x600). When AI is enabled, this is automatically set to the AI Max Size.
Sharpen Sharpening strength (radius x sigma). Higher sigma = more sharpening.
Quality JPEG output quality (1–100). Recommended: 92–95 for game textures.
Extra Args Additional ImageMagick options, e.g. -colorspace sRGB to fix colour issues.
AI Max Size Maximum input size (longest edge) for AI model. The image is resized to this value before AI upscaling.
AI Extra Args Additional ONNX Runtime arguments, e.g. --tile_size 256 --overlap 16 for large images.
Magick Enable/disable ImageMagick processing.
AI Enable/disable AI super‑resolution.
❓ Troubleshooting & FAQ
❗ “Failed to extract images” error when loading STX
The file may be using a different STX format. The tool attempts to parse common variants; if it fails, check if the file is corrupted or try another file.

❗ AI processing is slow or crashes
Reduce AI Max Size (e.g., from 512 to 256).

Use AI Extra Args --tile_size 256 --overlap 16 to process the image in chunks.

Ensure your GPU drivers are up‑to‑date.

❗ Settings window freezes
The model info loading runs in a background thread. If it still hangs, click “Load Model Info” manually instead of waiting for auto‑load.

❗ ImageMagick not working
Verify the path to magick.exe in Settings.

Check that ImageMagick is correctly installed (run magick --version in Command Prompt).

❗ Exe crashes on startup
Run the application from a command prompt to see error logs:

cmd
"STX Editor v1.0.0.exe"
Check for a generated error.log file in the same folder.

📝 Release Notes (v1.0.0)
New – Fully revamped UI with accordion sidebar and persistent settings display.

New – Playground window for interactive preview and testing.

New – Tile‑based AI processing for large textures.

Improved – STX parser now handles multiple magic headers (e.g., STX\x01).

Improved – Settings window no longer freezes (background thread for model loading).

Fixed – Numerous stability and performance issues.

Optimised – Exe size reduced with UPX compression and module exclusions.

📜 License
Copyright (c) [2026] [Devrim Ata Türkeş]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 Credits & Acknowledgements
ImageMagick – Powerful image processing library.

ONNX Runtime – Cross‑platform inference engine.

CustomTkinter – Modern, responsive GUI framework.

Real‑ESRGAN / foolhardy‑Remacri – Community‑trained super‑resolution models.

📬 Contact & Support
Developer: Devrim

Email: devrim72@proton.me
Web : www.the2005season.com

For bug reports, feature requests, or contributions, please open an new Topic on the forums.

“STX Editor – Empowering modders to breathe new life into their favourite games.” 🎮

Built with ❤️ and Python.