Skip to content

sashkinbro/EmuCoreX

Repository files navigation

EmuCoreX

License: GPL v3+ Support the project

EmuCoreX is a PlayStation 2 library and launcher for Android. It pairs a custom Android interface with a PCSX2-based emulation core adapted by EmuCoreX for Android.

Official website: https://emucorex.web.app/

Status

Warning

EmuCoreX is currently in the early stages of development. Expect instability, visual issues, performance drops, random slowdowns, and occasional crashes depending on the game, device, renderer, and driver stack.

The current Android focus is mid-range and high-end phones. Budget devices are not optimized yet.

At this stage, optimization work is mainly focused on Snapdragon devices. MediaTek optimization is still incomplete and may improve later.

If you are using a MediaTek device, try the OpenGL renderer first. If that is still unstable or too slow for a specific game, try Software rendering as a fallback.

Current rough minimum chipset recommendations as of April 2026:

  • Snapdragon: Snapdragon 8 Gen 2 or Snapdragon 7+ Gen 3 class devices
  • MediaTek: Dimensity 9300 or Dimensity 8400 class devices

These are practical starting points, not guarantees. Cooling, GPU drivers, RAM bandwidth, renderer choice, and the game itself still matter a lot.

Not all games work correctly yet. Compatibility, fixes, and performance optimization are still in active development.

Highlights

  • PCSX2-based emulation core adapted by EmuCoreX for Android
  • Home screen with cover art, game metadata, recent games, and search
  • BIOS and game folder setup, with recovery when folders become invalid
  • In-game overlay for renderer, aspect ratio, resolution, speedhacks, cheats, FPS, and quick actions
  • Save state manager, BIOS boot, and library navigation from the side drawer
  • RetroAchievements integration and a dedicated achievements screen
  • Cheat management with .pnach import, editing, and per-game activation in overlay
  • Advanced graphics and GS hack controls, including device-safe defaults for MediaTek
  • Physical gamepad remapping and gamepad-aware UI flows

What This Repository Contains

This repository contains the Android app, UI, settings, bridge code, and bundled native core sources used by EmuCoreX.

Tech Stack

  • Kotlin + Jetpack Compose
  • Android DataStore
  • JNI bridge to native C++
  • Emulation core derived from PCSX2 and integrated into EmuCoreX's native Android stack
  • Firebase services used by the Android app

Current App Scope

EmuCoreX currently targets Android with:

  • minSdk 29
  • targetSdk 36
  • package id com.sbro.emucorex
  • version 0.1.1

Building Locally

Requirements

  • Android Studio with Android SDK and NDK configured
  • JDK compatible with the Gradle setup in this project
  • A device or emulator for Android testing

Debug Build

.\gradlew :app:assembleDebug

Release Build

.\gradlew :app:assembleRelease

Project Structure

  • app/ Android application module
  • app/src/main/java/com/sbro/emucorex Kotlin app code
  • app/src/main/cpp Native bridge and core sources
  • app/src/main/res Android resources and translations

Notes

  • BIOS files and game images are not distributed with this project.
  • You must use your own legally obtained BIOS files and game dumps.
  • Compatibility, performance, and graphics behavior vary by device and renderer.

Credits

EmuCoreX builds on the open-source PCSX2 project together with its own Android interface, library system, runtime controls, and handheld-focused UX. The Android bridge has also been rewritten in Kotlin, and the core has been adapted by EmuCoreX for Android. Further work on stability, integration, and core improvements is planned.

Support

If you want to support ongoing development:

License

This project includes and derives from GPL-licensed PCSX2 code, so the repository is distributed under the GNU General Public License v3.0 or later.

See LICENSE for details.

About

PlayStation 2 emulator for Android with a PCSX2-based core adapted by EmuCoreX, a modern game library, live overlay controls, and a handheld-focused experience.

Topics

Resources

License

Stars

Watchers

Forks

Packages