FrogGBA changelog

This update is all about making games run smoothe. Thanks to a deep dive into gpSP’s codebase, we’ve unlocked big performance wins for audio-heavy titles.

📥 Install in 4 Steps

1. Download and extract the release
2. Copy the PSP folder to your Memory Stick root
3. Place gba_bios.bin in PSP/GAME/FrogGBA/
4. Launch from the PSP Game menu (requires CFW)

⚠️ Pokemon Unbound Compatibility Note

This game requires specific settings to run properly:

• In the game's audio menu, set to "Low Sound Quality" and "Mono" (results in 45-60 fps in game)
• Alternatively, disable background music entirely (results in 60 fps in game)
• Without these changes, expect severe performance issues

🔊 Audio – Huge Gains

We trimmed a lot of fat from the audio system:

• 48kHz → 22kHz output (less load, decent 🎶)
• Fast audio mode now default (no extra interpolation overhead)
• Volume caching (math done ahead of time = faster)
• Optimised audio buffering (less thread fighting)

🚀 CPU Emulation Optimisations

• Cut 75% of unnecessary cache flushes caused by self-modifying code checks
• Faster battles with lots of sprites (no more “slow-mo” fights)
• Reduced dynarec overhead during heavy processing

🎮 Game Performance Highlights

Pokemon Unbound

• Overworld = buttery 60fps
• Audio = clean, stable, no skips
• Battles = 40fps+ (up from \~20–30fps)

All games

• Lower audio latency
• Fewer dropouts in music-heavy areas
• More consistent frame pacing

🐸 FrogGBA v0.3.1

This release fixes critical performance and stability issues that have plagued recent versions. The main focus was restoring CPU optimizations that were previously disabled and resolving save state corruption that caused games to freeze or crash.

📥 Installation

1. Download and extract the release
2. Copy the PSP folder to your Memory Stick root
3. Place gba_bios.bin in PSP/GAME/FrogGBA/
4. Launch from PSP Games menu (requires CFW)

⚠️ Pokemon Unbound Compatibility Note

This game requires specific settings to run properly:

• In the game's audio menu, set to "Low Sound Quality" and "Mono" (results in 45-60 fps in game)
• Alternatively, disable background music entirely (results in 60 fps in game)
• Without these changes, expect severe performance issues

🆕 Major Changes

Performance Improvements

The emulator now uses PSP's volatile memory partition (4MB extra RAM) for critical CPU caches. This approach, inspired by the DaedalusX64 N64 emulator, provides 2MB for ROM translation cache and 512KB for RAM translation cache with direct memory access.

Note: This is NOT the extended memory layout.

CPU Optimization Restoration

Previously disabled optimizations have been restored after fixing the underlying memory corruption issues:

• Dynamic recompilation with proper MIPS32 instruction scheduling
• Branch prediction and optimization
• Memory access pattern fixes
• 32-byte aligned functions for cache efficiency

🐛 Bug Fixes

Critical Issues

• Stack overflow from infinite recursion in page loading

Other Fixes

• File handle cleanup and restoration
• CPU register preservation after state loads
• Memory leak prevention when switching games
• Instruction cache invalidation issues

🔧 Technical Details

The volatile memory implementation allocates performance-critical caches outside the main RAM partition, providing zero-copy access to translation caches. This technique was adapted from DaedalusX64's approach to utilizing the PSP's hardware capabilities.

Save state loading has been moved from the initialization phase to the main game loop, executing after approximately one second of gameplay. This prevents corruption of the emulation context that occurred when states were loaded too early.

💚 Compatibility

• All PSPs, potentially Vita (not tested)
• Any modern CFW
• Based on TempGBA4PSP with restored gpSP Kai optimizations

🔍 Known Issues

• Pokemon Unbound requires audio adjustments (see note above)
• Some ROM hacks may need custom settings
• Old save states may not be compatible

Credits

• Original gpSP by Exophase
• gpSP Kai optimizations by takka
• TempGBA4PSP base
• Datafrog SF2000 community for GPSP optimizations
• Volatile memory technique from DaedalusX64

GPL v2+ Licensed

Stability update with improved auto-resume functionality, per-game configuration system, and comprehensive bug fixes. This release focuses on reliability and user experience improvements.

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin into PSP/GAME/FrogGBA/.
4. Launch FrogGBA from your PSP Games menu (CFW required).

🆕 New in v0.3.0

📂 Recent Games Improvements

• Path Doubling Fix – Recent games now load correctly on first attempt (previously required two tries)
• Absolute Path Detection – Improved handling of PSP absolute paths vs relative paths
• Instant Loading – Recent games launch immediately without file-not-found errors

🎮 Game Configuration System port from TempGBA mod

• Per-Game Settings – Automatic game detection via ROM header analysis
• Customizable Configurations – Per-ROM settings for frame skip, audio, video optimizations, and controls
• Game-Specific Optimizations – Better compatibility with ROM hacks and homebrew games
• Persistent Per-Game Config – Settings automatically saved and restored for each game

🔧 Enhanced Auto-Resume System

• Fixed Resume Freezing – Completely resolved auto-resume freeze issues that occurred with games like Castlevania and Advance Wars
• Improved State Loading – Auto-save states now load immediately after reset for seamless gameplay
• Hidden Slot 11 – Uses invisible save slot 11 for auto-resume functionality without interfering with user saves
• Timing Optimization – Fixed state loading timing to prevent emulation hangs

🛠️ Critical Fixes

🎯 Auto-Resume Stability

• Fixed Auto-Resume Freeze – Games no longer freeze when loading save states on boot
• Resolved White Screen Issue – Auto-resume now properly starts gameplay instead of showing blank screen
• State Loading Timing – Fixed emulation context issues when loading states during startup
• CPU State Restoration – Proper CPU register restoration after state loads

📁 File System Improvements

• Recent Games Path Fix – Fixed path doubling bug that caused "file not found" errors on first load attempt
• PSP Path Detection – Better handling of ms0:/ and host0:/ absolute paths vs relative paths
• Load Path Resolution – Improved path construction for both recent games and manual file selection

🏗️ Repository Cleanup

• Submodule Integration – Added psp-media-engine-custom-core as proper git submodule
• Removed Duplicate Code – Cleaned up 81,000+ lines of redundant reference code from repository
• Better Dependency Management – Streamlined build process with automatic ME library inclusion

⚡ Performance & Stability

• Enhanced Reliability – Fixed critical auto-resume and path handling bugs that caused crashes and hangs
• Improved User Experience – Games now resume seamlessly without freeze or white screen issues
• Cleaner Codebase – Repository cleanup reduces compilation time and improves maintainability
• Better File Management – Resolved file loading issues that required multiple attempts to load games

🎮 Enhanced Features

💾 Save & Resume System

• Auto Save/Load States – Automatic save state functionality using hidden slot 11
• Resume Game on Boot – Automatically resume your last played game when starting the emulator
• Recent Games Menu – Quick access to your last played titles (now works reliably on first try)
• Configurable Resume Options – Choose between resume last game, load last save state, or both

🎨 Visual & Controls

• Configurable X/O Button Mapping – Swap X and O button functions to match your preferences
• Lightning-Fast Overlays – Full-screen borders with zero performance impact
• Custom Overlay Support – Up to 10 designs with pixel-perfect positioning
• Online Overlay Generator – Create your own at froggba.onrender.com
• Multiple Aspect Ratios – Choose your preferred display mode
• Fast Color Correction – Hardware-accelerated color processing

🔧 Advanced Options

• ME Engine Control – Menu option for PSP Media Engine features (Auto/Disabled/Enabled)
• Per-Game Configurations – Automatic ROM detection with customizable settings per game
• Debug Logging – Optional froglog.txt for troubleshooting (can be enabled when needed)

🧠 Technical Details

🎯 Auto-Resume Architecture

• Immediate State Loading – Auto-save states load immediately after reset instead of delayed loading
• Skip Execution Path – Resume on boot bypasses normal loading flow to prevent conflicts
• CPU Context Management – Proper PC status flags and register restoration after state loads
• Hidden Slot Implementation – Uses slot 11 (invisible to users) for seamless auto-resume functionality

📁 Path Resolution System

• Absolute Path Detection – Improved detection of PSP device paths (ms0:/, host0:/) vs relative paths
• Path Construction Logic – Smart path building that avoids doubling directory paths
• Recent Games Integration – Fixed path handling for games launched from recent games menu

🏗️ Development Infrastructure

• Git Submodule Integration – PSP Media Engine library now properly managed as submodule
• Repository Cleanup – Removed 81,000+ lines of redundant reference code
• Build System Improvements – Streamlined compilation with automatic dependency inclusion
• Enhanced Debug Framework – Comprehensive logging system for troubleshooting complex issues

🐛 Bug Fixes

🎮 Gameplay Issues Resolved

• Auto-Resume Freeze Fix – Games like Castlevania and Advance Wars no longer freeze when auto-loading save states
• Recent Games Loading Fix – Games now load successfully on first attempt instead of requiring multiple tries
• White Screen Resolution – Fixed auto-resume causing blank screens instead of proper gameplay
• State Loading Context – Resolved emulation hangs when loading states during startup sequence

📂 File System Fixes

• Path Doubling Prevention – Eliminated ms0:/PSP/GAME/FrogGBA/roms/ being added twice to file paths
• Absolute Path Handling – Proper detection and handling of PSP device paths vs relative filenames
• Recent Games Path Correction – Fixed path construction for games stored in recent games menu

🔧 Development & Build Fixes

• Submodule Integration – Proper git submodule setup for psp-media-engine-custom-core dependency
• Compilation Dependencies – ME library now automatically included when submodule is present
• Repository History Cleanup – Removed duplicate/reference code that was bloating the repository

🛠️ Building from Source (New!)

FrogGBA now uses proper git submodules for easy building:

# Clone with submodules
git clone --recursive https://github.com/yourusername/FrogGBA.git
cd FrogGBA

# Build with Docker (recommended)
./build.sh

# Or build manually if you have PSP SDK installed
cd source
make

The PSP Media Engine library is automatically included as a submodule, eliminating the need for manual dependency setup.

💚 Compatibility

• Works on all PSP models (1000/2000/3000/Go)
• CFW required (any modern CFW works)
• Based on heavily modified TempGBA4PSP with gpSP Kai optimizations
• Repository now properly structured with git submodules for dependencies

TL;DR: FrogGBA v0.3.0 delivers major stability improvements with fixed auto-resume functionality, resolved recent games loading issues, and a new per-game configuration system. No more freezes, white screens, or file-not-found errors. Enhanced repository structure with proper submodule management for easier building and maintenance. 🐸🎯

Credits

• Original gpSP by Exophase
• gpSP Kai optimizations by takka
• TempGBA4PSP base
• FrogGBA improvements by the community

GPL v2+ Licensed

🐸 FrogGBA v0.2.4 – Auto game resume & Auto Save State + Auto Save State Load

Critical update fixing major visual rendering issues and introducing convenient game resume functionality. This release prioritizes accuracy and user experience.

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin into PSP/GAME/FrogGBA/.
4. Launch FrogGBA from your PSP Games menu (CFW required).

🆕 New in v0.2.4

• Resume Game on Boot – Automatically resume your last played game when starting the emulator for seamless gaming sessions.
• Auto Save/Load States – New automatic save state functionality. Happens on menu open.
• Split Resume Options – Can resume last played game, also can load last save state upon game load
• Dedicated Saving Submenu – Added organized submenu for all save-related settings and options.

🛠️ Critical Fixes

• Fixed Water Transparency Issues – Resolved major visual bugs causing water and transparent effects to show vertical stripes instead of smooth transparency.
• Fixed Kirby Startup Logo – Kirby's black startup logo now displays in proper colors thanks to corrected blending calculations.
• Eliminated Green Flickering – No more green blinking during black transition screens in Castlevania and other games.
• Restored Visual Accuracy – Disabled problematic optimizations that were causing widespread blending and alpha channel rendering issues.

⚠️ Performance Impact

• Prioritized Accuracy – Some optimizations were disabled to fix critical visual issues, resulting in slight performance reduction compared to v0.2.3.
• Visual Quality First – Games now render correctly with proper transparency and blending effects, even if slightly slower.
• Stable Experience – Rock-solid compatibility with correct sprite and background rendering across all tested games.

🎮 Retained Features

• Configurable X/O Button Mapping – Swap X and O button functions to match your preferences (from v0.2.3)
• Recent Games Menu – Quick access to your last played titles
• Lightning-Fast Overlays – Full-screen borders with zero performance impact
• Custom Overlay Support – Up to 10 designs with pixel-perfect positioning
• Online Overlay Generator – Create your own at froggba.onrender.com
• Multiple Aspect Ratios – Choose your preferred display mode
• Fast Color Correction – Hardware-accelerated color processing

🧠 Technical Details

• Disabled Tile Base Caching – Reverted to direct tile calculation to fix transparency issues
• Removed VCOUNT Caching – All vertical counter reads now access register directly for accurate timing
• Conservative Sprite Clearing – Restored simple memset() approach for reliable sprite rendering
• Disabled Fast Path Optimizations – Prioritized accuracy over performance for consistent visual output
• Enhanced Auto-Save System – Robust state management with configurable timing intervals

🐛 Bug Fixes

• Critical Blending Fix – Water and transparent effects now render correctly without vertical stripe artifacts
• Alpha Channel Correction – Fixed black sprites and logos appearing due to broken alpha blending
• Transition Screen Fix – Eliminated green flickering during fade effects in various games
• Simplified FPS Display – Removed problematic sprite counter that was incrementing infinitely
• Clean Release Build – Removed all debug logging for production-ready performance

💚 Compatibility

• Works on all PSP models (1000/2000/3000/Go)
• CFW required (any modern CFW works)
• Based on heavily modified TempGBA4PSP with gpSP Kai optimizations

TL;DR: FrogGBA v0.2.4 fixes critical visual rendering issues that were causing broken transparency and blending effects. Now includes convenient resume-on-boot and auto-save features for the best user experience. Visual accuracy is prioritized over raw performance. 🐸🎯

Credits

• Original gpSP by Exophase
• gpSP Kai optimizations by takka
• TempGBA4PSP base
• FrogGBA improvements by the community

GPL v2+ Licensed

FrogGBA v0.2.3 Release Notes

Quality of life update focused on improving user experience across different PSP regions and user preferences.

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin into PSP/GAME/FrogGBA/gba_bios.bin.
4. Launch FrogGBA from your PSP Games menu (CFW required).

🆕 New in v0.2.3

• Button Mapping Options – Choose between X/O or O/X as confirm/cancel buttons in emulator settings to match your PSP region or personal preference.

🎮 Carryover Features

• Recent Games Menu – Quick access to your last played titles
• Lightning-Fast Overlays – Full-screen borders with zero performance impact
• Custom Overlay Support – Up to 10 designs with pixel-perfect positioning
• Online Overlay Generator – Create your own at [froggba.render.com](https://froggba.render.com)
• Multiple Aspect Ratios – Choose your preferred display mode
• Fast Color Correction – Hardware-accelerated color processing
• gpSP Kai Optimizations – Proven performance techniques for smooth gameplay

💚 Compatibility

• Works on all PSP models (1000/2000/3000/Go)
• CFW required (any modern CFW works)
• Based on heavily modified TempGBA4PSP with gpSP Kai optimizations

TL;DR: FrogGBA v0.2.3 adds button remapping flexibility while maintaining all the performance and stability improvements from previous releases. Small update, big convenience boost! 🐸⚡

Credits

• Original gpSP by Exophase
• gpSP Kai optimizations by takka
• TempGBA4PSP base
• FrogGBA improvements by the community

GPL v2+ Licensed

Minor performance update inspired by gpSP Kai optimizations. This release brings some FPS improvements in demanding games, eliminates micro-stutters, and makes the emulator more stable than ever.

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin into PSP/GAME/FrogGBA/gba_bios.bin.
4. Launch FrogGBA from your PSP Games menu (CFW required).

🆕 New in v0.2.2

• gpSP Kai Optimizations – Implemented some of the proven performance techniques from the legendary gpSP Kai, resulting in noticeable FPS gains.
• Fixed Multi-Layer Bottlenecks – Games like Castlevania (water sections) now run at better speed with 4-layer Mode 0 rendering.
• Eliminated Micro-Stutters – Smart cache management prevents stuttering during level transitions in games like Kirby Amazing Mirror.
• Optimized Memory Usage – Reduced translation cache sizes to optimal levels (2MB ROM, 256KB RAM) for better PSP memory utilization.
• Enhanced Audio Processing – Improved audio buffering reduces crackling and provides smoother sound output.
• Better Sprite Rendering – Optimized sprite handling for games with many on-screen objects.

⚡ Performance Gains

• Golden Sun Series – Battle effects and world map rendering improved
• Fire Emblem – Large battle animations no longer cause slowdown
• Overall – up to 10% performance improvement in most demanding titles

⚠️About Pokemon Unbound

• _TLDR: disable background music from in-game menu, keep the sound effects - they are fine. It'll give you 60 fps._

Pokemon Unbound is one of the few hacks that struggles on low end devices like the PSP. This is due to it's implementation of high quality audio background music.
Sadly we will never be able to run the game full speed using FrogGBA, or another emulator. That's at least my belief.

🎮 Carryover Features

• Recent Games Menu – Quick access to your last played titles
• Lightning-Fast Overlays – Full-screen borders with zero performance impact
• Custom Overlay Support – Up to 10 designs with pixel-perfect positioning
• Online Overlay Generator – Create your own at froggba.render.com
• Multiple Aspect Ratios – Choose your preferred display mode
• Fast Color Correction – Hardware-accelerated color processing

🧠 Technical Details

• Static translation caches for reduced memory fragmentation
• Cache invalidation reduction for smoother frame pacing
• Simplified tile rendering pipeline matching gpSP Kai approach
• Pre-warmed cache lines to reduce initial load stutters
• Optimized memory access patterns for PSP's architecture

🐛 Bug Fixes

• Fixed BSOD on emulator exit
• Eliminated micro-stutters during level transitions
• Resolved glitchy tile rendering in certain games
• Fixed recent games path handling
• Improved save/load memory reliability

💚 Compatibility

• Works on all PSP models (1000/2000/3000/Go)
• CFW required (any modern CFW works)
• Based on heavily modified TempGBA4PSP with gpSP Kai optimizations

TL;DR: FrogGBA v0.2.2 brings the performance optimizations from gpSP Kai to modern PSP homebrew. Enjoy full-speed emulation in previously slow games, butter-smooth transitions, and rock-solid stability. The best GBA experience on PSP just got even better. 🐸⚡

Credits

• Original gpSP by Exophase
• gpSP Kai optimizations by takka
• TempGBA4PSP base
• FrogGBA improvements by the community

GPL v2+ Licensed

🐸 FrogGBA v0.2.1 – Faster, Smoother, Smarter

froggba21 1

Small update, big quality-of-life gains. This release makes the overlay system lightning fast, adds a proper Recent Games list, and now supports full-screen borders for those who want every pixel looking sharp.

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin into PSP/GAME/FrogGBA/.
4. Launch FrogGBA from your PSP Games menu (CFW required).

🆕 New in v0.2.1

• Recent Games Menu – Your last played titles now appear right at the top when loading a game.
• Much Faster Overlays – Completely reworked overlay code; loads instantly, zero slowdown.
• Full-Screen Borders – Overlays can now stretch across the entire display for maximum style.

⚡ Carryover from v0.2.0

• 110%+ performance boost in heavy GBA titles thanks to volatile memory.
• Full custom overlay support with up to 10 designs, pixel-perfect positioning, and an online generator at [froggba.render.com](https://froggba.render.com).
• New aspect ratio modes, faster colour correction, and overlay-friendly scaling.
• Major stability fixes, better save/load behaviour, and crash prevention for bad ROMs.

🧠 Tech Bits

• Works on all PSP models (1000/2000/3000/Go).
• GPL v2+ with proper credits.
• Based on heavily modified TempGBA4PSP.

TL;DR: FrogGBA is now faster to use, prettier to look at, and even easier to navigate. Load recent games instantly, rock full-screen overlays, and enjoy a smoother experience all around. 🐸💚

🐸 FrogGBA v0.2.0 – The Big One!

frog2

Alright folks, this is the release. We’ve gone all-in, tuned it, cleaned it, and squeezed every last drop of performance out of the PSP. Let’s hop right in.

TL;DR: FrogGBA just hit 100% speed on heavy games, got a brand-new overlay system, tons of optimisations, and enough bug fixes to make it rock-solid. This is the PSP GBA experience. 🐸💚

📥 Install in 4 Steps

1. Download + unzip the release.
2. Copy the PSP folder to your Memory Stick root.
3. Drop gba_bios.bin file into PSP/GAME/FrogGBA folder
4. Run FrogGBA from your PSP Games menu (CFW required).

⚡ Full Speed Ahead – +110% Performance!

• Volatile Memory Magic – We’re tapping into that extra 4MB on your PSP for a massive speed boost.
• All PSP Models Welcome – 1000, 2000, 3000, Go… they all fly now.
• Clever Resource Handling – Saves and loads without choking your RAM.
• Partial Memory Flush – Massive benefits in memory heavy games like pokemon romhacks and late GBA releases

🎨 Custom Overlay System

• Make it Yours – Drop in your own PNG overlays for that perfect retro vibe.
• Instant Builder – Make overlays in seconds at [froggba.render.com](https://froggba.render.com) – no Photoshop degree needed.
• Up to 10 Designs – Switch between them in-game, on the fly.
• Pixel-Perfect Control – Move the game window exactly where you want it.
• Smart Memory – Overlays only take up RAM when you’re actually using them.

🖼 Display Upgrades

• Three Aspect Ratios:

• 3:2 Original – Pure GBA nostalgia.
• Zoom – Fill the screen (a teensy crop).
• Stretch – Full PSP screen takeover.
• Better Colours – 10× faster correction with lookup tables.
• Overlay-Friendly Scaling – Every mode works with your custom bezels.

💾 Save State Quality of Life

• No Menu Fuss – Save/load and it kicks you back to the game instantly.
• Crash Guard – Checks saves before loading.
• Overlay-Friendly Saves – Temporarily frees overlay RAM while saving.
• ROM Checks – Stops bad files from nuking your session.

🚀 Under the Hood Optimisations

• Partial Flush for MIPS32 – Faster cache work.
• Dynamic RAM Use – Freed up 550KB of static memory.
• 30K Pixel Overlay Cache – Even heavy overlays won’t slow you down.
• Double Buffer Sync – Bye-bye flicker.

📊 Real-World Gains

• Metroid Zero Mission – 45 → 60 FPS (+33% speed).
• Sprite-Heavy Games – 20–30% boost.
• Overall – Locked 60 FPS with volatile memory on for many, many games

🐞 Bug Squash List

• No more missing overlay pixels or weird glitches.
• Fixed save state RAM errors.
• Stops crashes from empty/bad ROMs.
• No more flicker in overlay’s top-right corner.
• Fixed menu text alignment.

🎮 New Shortcuts

• HOME – Main menu + overlay settings.
• Aspect Ratio – Change in Emulator Settings.
• Overlay Menu – Enable/disable & tweak while playing.

🖌 Make Your Own Overlay

1. Head to [froggba.onrender.com](https://froggba.onrender.com).
2. Upload a 480×272 PNG with a transparent window.
3. Download your .ovl.
4. Copy it into the PSP overlays folder.

🧠 Tech Bits

• Works on all PSP models with volatile memory.
• 30,000 pixel overlay cache.
• GPL v2+ with proper credits.
• Based on heavily-modified TempGBA4PSP.

⚠️ You’ll Need

• A PSP with Custom Firmware.
• At least 10MB free space.
• A GBA BIOS file.

🙏 Credits

• Exophase – gameplaySP original.
• Nebuleon, Normmatt, BassAceGold – TempGBA improvements.
• daedalus Team, PSP Homebrew Community – For implementation and help with Volatile Memory
• Andy from Retro Handhelds Community - For help with Partial Flush MIPS32 implementation

Release notes

This is a first release of GBA emulator for the PSP called FrogGBA.

✨ New Features

• 🎨 Color Correction: Authentic GBA screen colors with GPSP and Retro modes
• ⚡ Fast Forward: SELECT + R to toggle 2x/3x speed modes
• � Turbo Buttons: Triangle and Square as dedicated turbo buttons
• � FPS Display: SELECT + Square to toggle performance counter
• � Cute Loading Screen: ASCII frog animation during ROM loading
• � Enhanced UI: Mint green color palette and mod attribution

Installation

1. Download and extract the release
2. Copy the PSP folder to your PSP's memory card root
3. Launch from Games menu on your CFW PSP

Note: Custom firmware (CFW) is required to run homebrew applications on PSP.

Controls

• SELECT + R: Fast forward toggle (2x/3x speed)
• SELECT + Square: FPS counter toggle

🔥 Performance Improvements

• 22% FPS boost in Metroid Zero Mission (45→55+ FPS)
• Sprite rendering optimizations for sprite-heavy games
• Memory waitstate optimization (~50% reduced access delays)
• PSP cycle batching reduces dynamic recompiler overhead
• Conservative cache management prevents performance drops
• Block coalescing for better instruction cache usage

Technical Enhancements

All optimizations are permanently enabled for the best experience:

• PSP MIPS32 instruction optimizations
• Improved timer prescaling for better audio/video sync
• Reduced cache invalidation overhead
• Modern PSP SDK compatibility
• Docker-based build system

Compatibility

• Requires CFW-enabled PSP
• Improved compatibility with modern homebrew scene
• Better performance across all GBA games