Lakka - The DIY retro emulation console

Lakka is a lightweight Linux distribution that transforms a small computer into a full blown emulation console.

• Powerful - Built on top of the famous RetroArch emulator, Lakka is able to emulate a large range of hardware and has some useful features such as Braid-like rewinding, joypad hotplug and video streaming.
• User friendly - Lakka is easy to setup and use. Once installed to your SD card, you just have to put your rom on the card, plug your joypad and enjoy your favorite old games. We also support PS3 and XBox360 controllers so you don't have to buy new ones.
• Low cost - We try our best to keep the hardware required to run Lakka as cheap as possible. The software is optimized to run fast even on low end computers. The power can be supplied by any micro USB adapter like the one for your smartphone.
• Open source - Our code is free as in freedom and hosted on Github (though the project uses emulators that forbid commercialisation). We accept external contributions, and we do our best to integrate our own patches into upstream projects.
• Enhanced Gaming Platform - This fork extends Lakka with Java support, J2ME emulation, and planned PortMaster integration for a comprehensive retro + modern gaming experience.

This Lakka fork includes a fully integrated Java development environment:

Features:

• Eclipse Temurin OpenJDK 8u422-b05 (includes JRE + development tools)
• Cross-platform support (x86_64, aarch64, arm)
• BusyBox compatible - designed for LibreELEC/Lakka environment
• Automatic configuration - Java available immediately after boot

Comprehensive J2ME (Java ME) game support fully integrated:

Completed Features:

• FreeJ2ME-Plus Core - Enhanced J2ME emulator with improved compatibility
• Automatic JAR Detection - Seamless J2ME game loading via RetroArch
• Performance Optimizations - Optimized for embedded hardware
• RetroArch Integration - Full integration with Lakka's interface

Planning to integrate PortMaster for extended gaming capabilities:

Upcoming Features:

• Game Ports Library - Access to modern game ports
• Easy Installation - Simple port management system
• Extended Compatibility - Beyond traditional emulation

After building and installing this Lakka version, Java is automatically available:

java -version                    # Check Java availability
javac MyProgram.java            # Compile Java programs
java MyProgram                  # Run Java programs
java -jar your-application.jar  # Run JAR files

Java environment is automatically configured with:

• JAVA_HOME: /usr/lib/jvm/java-8-openjdk
• PATH: Includes Java binaries
• Compatibility: Works with BusyBox ash shell
• Persistence: Configuration survives reboots

🚀 Active Development: This fork is making significant progress with enhanced emulation capabilities:

• ✅ Java Support: Successfully integrated Eclipse Temurin OpenJDK 8u422-b05
  • Built and tested across multiple platforms (x86_64, aarch64, arm)
  • Full JRE + development tools available
  • Automatic configuration and persistence
• ✅ FreeJ2ME-Plus Core Integration: Full J2ME emulation support added
  • ✅ Core builds successfully with all required components
  • ✅ JAR files (freej2me-lr.jar, freej2me.jar) properly installed
  • ✅ Core info file and configuration integrated
  • ✅ Available in RetroArch interface for Nintendo Switch and other platforms
• ✅ Build System: Successfully resolved major compilation issues
• ✅ Cross-platform Compatibility: Confirmed working on target hardware

• ✅ FreeJ2ME-Plus Integration: Successfully integrated FreeJ2ME-Plus emulator as built-in core
  • ✅ libretro-freej2me-plus package created and configured
  • ✅ Core properly builds and installs with all required files (.so, .info, JAR files)
  • ✅ RetroArch integration complete - core available in Lakka interface
  • ✅ Testing Complete: J2ME games loading and running successfully
• ✅ Core Library Integration: All dependencies properly bundled and working
• ✅ Build Documentation: Complete build instructions created for community

• 🎯 PortMaster Integration: Planning to add PortMaster for extended game porting capabilities
  • Will enable easy installation of ported games
  • Enhanced gaming ecosystem beyond traditional emulation
• 🎯 Enhanced Gaming Hub: Creating comprehensive retro + modern gaming platform

• DNS/Network Restrictions: Build process encounters frequent failures due to regional DNS blocking of source repositories
  • Multiple build hosts are inaccessible from certain geographic regions
  • Source downloads timeout or fail completely
  • Mirror repositories may be blocked or unreachable
  • Impact: Significantly slows development and testing cycles

• Local mirror setup for frequently accessed repositories
• VPN/proxy solutions for build environment
• Alternative source repositories and mirrors
• Offline build cache implementation
• Docker-based build environment with pre-cached dependencies

• Completed Phase: J2ME Game Compatibility Testing
  • ✅ Various J2ME games tested for proper loading and execution
  • ✅ Performance validation on Nintendo Switch and other hardware
  • ✅ RetroArch integration and UI testing completed
  • ✅ Core functionality verified and stable

If you're experiencing similar DNS/network issues during build:

1. Consider using a VPN service during build process
2. Set up local mirrors for critical dependencies
3. Use Docker with pre-cached layers when possible
4. Contact maintainer for alternative download sources

Note: This is an enhanced fork focusing on comprehensive retro and modern gaming capabilities. Active development with regular testing and improvements.

📍 Branch: Lakka-v5.x-new - Cutting-edge development with upcoming features

This experimental branch contains the latest development work and future features that are not yet ready for the main branch. It's where we actively develop and test new capabilities before they're merged into the stable release.

• Next-generation Features: Experimental implementations of upcoming enhancements
• Advanced Integrations: Bleeding-edge ports and emulation cores
• Performance Improvements: Optimization experiments and new technologies
• Extended Platform Support: Testing for additional hardware platforms
• Developer Previews: Early access to features planned for future releases

To see what's currently being developed and the progress of upcoming features:

1. 🔍 View Active Development: Compare branches to see latest changes
2. 📝 Check Commit History: Latest commits in the development branch
3. 🐛 Development Issues: Open issues tagged with Lakka-v5.x-new label
4. 🎯 Project Milestones: Milestones showing feature completion progress

• Experimental Status: Features in this branch are under active development
• Stability Warning: May contain bugs or incomplete implementations
• Testing Purpose: Primarily for developers and advanced users
• Regular Updates: Frequently updated with latest experimental work

Interested in contributing to upcoming features? Check out the Lakka-v5.x-new branch:

# Clone and switch to development branch
git clone https://github.com/KGBRecord/Lakka-LibreELEC.git
cd Lakka-LibreELEC
git checkout Lakka-v5.x-new

# See what's being worked on
git log --oneline -10

The development branch follows this workflow:

1. Concept → Lakka-v5.x-new (experimental implementation)
2. Testing → Lakka-v5.x-new (stability testing & refinement)
3. Ready → Merge to Lakka-v5.x (stable release)

Stay updated: Watch the repository to get notifications when new experimental features are added to Lakka-v5.x-new!

• Java Integration: ✅ Successfully built and integrated
• FreeJ2ME-Plus Core: ✅ Successfully built and integrated into Lakka
• J2ME Game Support: ✅ Testing completed - games working properly
• PortMaster Support: 📋 Planned for future releases

This fork welcomes contributions! Areas of focus:

• J2ME game compatibility testing
• Performance optimizations for embedded hardware
• PortMaster integration development
• Cross-platform testing and validation

Want to build this enhanced Lakka with Java and J2ME support?

📋 Complete Build Instructions → BUILD.md

This enhanced version requires building from source as it includes custom Java integration and FreeJ2ME-Plus core. The build guide covers:

• Docker-based building (works on Windows, macOS, Linux)
• All supported platforms (Nintendo Switch, PC, Raspberry Pi, ARM SBCs)
• Step-by-step instructions with copy-paste commands
• How to extract your built images

For standard Lakka installation, please refer to https://www.lakka.tv/get

For this enhanced version, build from source using the instructions in BUILD.md

• FAQ
• #lakkatv on irc.libera.chat
• Discord
• Forums