Releases: CompuMaxx/gba-background-studio
Release list
v2.0.1 - Bug Fixes & Compatibility Update
v2.0.1 - Bug Fixes & Compatibility Update
Release Date: May 2nd, 2026
This is a critical maintenance update focused on fixing the automatic update infrastructure and significantly boosting image processing performance.
🔄 Fixed & Enhanced Update System
We have completely overhauled the update delivery mechanism to ensure seamless transitions between versions:
- Detached Execution: Fixed a bug where the update process would fail to launch after closing the app. The updater now runs as a
DETACHED_PROCESS, allowing it to install the new version independently after the main application exits. - Edition-Aware Updates: The system now identifies if you are running the Modern (Python 3.10+) or Legacy (Python 3.8) version and automatically downloads the correct binary (
Updater.exeorUpdater_Legacy.exe). - Registry Safeguards: The Updater now verifies your Windows Registry. If no previous installation is found, it will safely cancel and redirect you to the official download page instead of attempting an incorrect installation.
🚀 Massive Performance Boost (Pillow 12.2.0)
We have updated our image processing engine to Pillow 12.2.0. Thanks to the new lazy plugin loading, asset management is now faster than ever:
- Speed Improvements: Opening image files is now up to 15x faster, and saving operations are up to 9x faster for common formats.
- Lazy Loading: Plugins are now loaded only when required, significantly reducing memory overhead during quick tasks.
🛠️ Infrastructure Improvements
- Reproducible Builds: Re-added
requirements.txtto the repository. It now includes pinned versions for the modern edition and upper limits for legacy environments to prevent dependency conflicts.
💬 Community & Support
- Official Discord Server: Join our community! https://discord.gg/wsFFExCWFu
- Issue Reporting: If you encounter any problems, please report them on our GitHub Issues page.
How to Update:
Note: You must download this installer manually one last time due to the update bug in the previous version. Once installed, future updates will work automatically via Help -> About -> Check for Updates.
Happy GBA developing! 🚀
v2.0.0 - The Compatibility & Stability Update
v2.0.0 - The Compatibility & Stability Update
Release Date: May 1st, 2026
Version 2.0.0 is a major milestone that redefines the reach of GBA Background Studio. By implementing a new hybrid architecture, we have brought full graphical capabilities to legacy systems while significantly refining the professional editing workflow.
🖥️ New Hybrid Architecture (Qt4Python Compatibility)
We have migrated the project to a dual-backend state to ensure no developer is left behind:
- Hybrid PySide6/PySide2: The core now uses a custom
qt_compat.pylayer that automatically detects your Python version and initializes the appropriate backend (PySide6 for Python 3.10+ or PySide2 for Python 3.8). - Native Legacy Support: Users on Windows 7, 8, and 8.1 can now enjoy the full GUI experience using Python 3.8, eliminating the previous reliance on CLI-only tools for these environments.
- Smart Dependencies: The
requirements.txthas been updated to automatically install the correct Qt framework based on your operating system's compatibility.
🎨 Workflow & UX Enhancements
The editing process is now more intuitive and follows industry standards:
- Natural Selection Flow: The "Save Selection" logic has been inverted; you now select an area on the tilemap first and then trigger the save action, making the process faster and more logical.
- Persistent Session Memory: The application now tracks the last used directory for all file operations (Save, Export, Open) in real-time, regardless of settings.
- Real-Time Transformation Preview: The conversion dialog now displays the final image dimensions and boundaries (cropping or padding) in real-time before you commit.
- Safety First: Added a confirmation prompt before overwriting any existing files during export to prevent accidental data loss.
🛠️ Technical Bug Fixes
- 4bpp Engine: Fixed a critical bug in 4bpp conversions where transparent color replacement failed if the color index matched existing palette entries.
- Tilemap Tools: Resolved an issue where "Select Area" would stop responding after saving a selection.
- UI Precision: Corrected the "Save Tilset" typo and reorganized the "Open Tilemap" dimensions so 32xN sizes appear prioritized over 20xN.
- Visual Stability: Fixed unexpected tilemap scrolling when applying fills and implemented a real-time mask that shows exactly which areas will be trimmed when resizing maps.
💬 Community & Support
- Official Discord Server: Join our community! https://discord.gg/wsFFExCWFu
- Issue Reporting: If you encounter any problems, please report them on our GitHub Issues page.
How to Update:
If you have v1.1.0 installed, you can update directly through the application by going to Help -> About and clicking "Check for Updates" in the dialog box, or by downloading and running the Updater.exe.
Happy GBA developing! 🚀
v1.1.0 - Infrastructure & Optimization Update
v1.1.0 - Infrastructure & Optimization Update
Release Date: April 1st, 2026
This version marks a significant milestone in the evolution of GBA Background Studio, establishing the foundation for a more agile development cycle and refining critical UI and documentation details.
🔄 New Update System (Preparing the Ground)
We have redesigned how the application stays current:
- Support for Updater.exe: The installer is now optimized to preserve base files, allowing future updates to be delivered via lightweight patches rather than downloading the full package.
- Automatic Checking: Added a "Check for Updates" feature in the "About" dialog to immediately notify users of new releases.
🛠️ Legacy Wizard Improvements (GBA_Studio_Wizard.bat)
The assistant for older systems and manual environments is now smarter:
- Automated Verification: The script now verifies the presence of Python 3.8+ and validates the integrity of necessary dependencies including Pillow, NumPy, Scikit-Learn, and OpenCV.
- Silent Installation: If a library is missing, the
.batfile handles the installation automatically to facilitate startup on Windows 7/8/8.1 environments.
🎨 UI Refinements & Bug Fixes
- 4bpp Mode: Fixed a visual bug where 8bpp-related strings were displayed during conversion while in 4-bit per pixel mode.
- Localization: Standardized Japanese language identifiers to
.jpnacross all documentation and project assets. - Robust Documentation: All README images are now hosted internally within the repository, ensuring visual guides are always available without relying on external servers.
💬 Community & Support
- Official Discord Server: Join our community! https://discord.gg/wsFFExCWFu
- Issue Reporting: If you encounter any problems, please report them on our GitHub Issues page.
How to Update:
Since v1.0.0 was distributed as a OneFile version, it is highly recommended to perform a clean installation using this new v1.1.0 installer to enable future automatic update features.
Happy GBA developing! 🚀
v1.0.0 - Initial Official Release
🚀 GBA Background Studio v1.0.0 — First Stable Release
GBA Background Studio is a comprehensive desktop solution for transforming standard images into optimized assets for Game Boy Advance hardware.
✨ Key Features
🎨 Conversion & Editing Engine
- Image to GBA: Intelligent image importing with automated conversion to tilesets, palettes and tilemaps (4bpp/8bpp).
- Background Modes: Full support for both Text Mode and Rotation/Scaling Mode (Affine).
- Tileset Editor: Tools for drawing, rotating, mirroring (flipping), and tile optimization to save VRAM.
- Palette Editor: Total control over 256 colors with reordering tools and real-time synchronization.
- High-Precision View: Zoom levels from 100% to 800% and a high-fidelity Hardware Preview tab.
🛠️ Workflow & UX
- History System: Robust Undo/Redo support for all editing operations.
- Dynamic Status Bar: Real-time data on coordinates, tile indices, palette IDs, and flip states.
- Persistence: Automatically saves language preferences, zoom levels, and recent file paths.
💻 Architecture & Compatibility
- Core: Built with Python and PySide6 (Qt6).
- Compatibility: Windows 10/11 (High-DPI aware), macOS, and Linux.
- Legacy Wizard: Includes a command-line assistant (
GBA_Studio_Wizard.bat) for older systems (Win 7/8/8.1).
🌐 Globalization & Community
- Multi-language: UI localized in 18 languages (including Spanish, Japanese, Russian, Chinese, and more).
- Open Source: GPL-3.0 Licensed. Full documentation for installation and contributions available on GitHub.
📤 Export
Generate production-ready files for GBA toolchains (Tilesets, Tilemaps, and Palettes) via Ctrl+E or the dedicated export menu.