A faithful adaptation of Katawa Shoujo for the GBA, powered by the Butano framework. Includes Python tools to convert assets and scripts from the Katawa Shoujo: Re-Engineered project.
- Visual Novel Gameplay optimized for GBA.
- The entire OST carefully adapted for the GBA.
- Video Cutscenes fits alongside the game.
- Tools for converting assets and scripts.
- Huge bitmaps to display backgrounds with more than 1024 tiles (used for events).
- DevkitARM (Setup Guide)
- Windows: Use DevkitPro Installer.
- macOS/Linux: Install via
devkitpro-pacman.sudo dkp-pacman -S devkitARM
- Verify:
arm-none-eabi-gcc --version
- Python 3.12 for tools.
- Butano
fork with custom audio integrated (uses branch
custom_audio_upgrade) - libsavgba
- For CLion IDE users:
- Install
compiledb- macOS:
brew install compiledb
- Linux:
pip install --user compiledb
- macOS:
- Generate
compile_commands.json:compiledb make -j$(nproc) - Import the project in CLion as a Compilation Database project
- Configure the devkitARM toolchain in CLion (see devkitARM setup guides)
- Install
- Fork the repository.
- Clone the forked repository.
- Create a branch for your feature.
- Test your changes on emulators and hardware.
- Submit a pull request.
- Four Leaf Studios for creating Katawa Shoujo.
- Butano Framework by GValiente for the GBA development framework.
- ulc-codec by Aikku93 for the Ultra-low-complexity MDCT Audio Codec.
- 8ad by Damian Yerrick.
- GBA-image-tools by HorstBaerbel for the DXTV video codec.
- libsavgba by laqieer for Flash saving abilities.
- Katawa Shoujo: Re-Engineered by Fleeting Heartbeat Studios for the great adaptation Katawa Shoujo to the modern Ren'Py engine.
Some tools and projects may no longer be part of the current build, but they played a meaningful role in earlier stages of development. Their ideas, inspiration, and technical foundations helped shape this project, and for that, I'm truly grateful:
- afska for the GSM Player Butano integration and supporting the development process.
- libagmv by RyandracusCodesGames for the AGMV video codec.
- GSM Player by Damian Yerrick for the GBA audio player.
This project is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. See the LICENSE file for details.