Jarngreipr
3.1.3 · GitHub
More about this app
Launcher for dual-screen gaming devices. Uses Shizuku to map on of the touch screens to controller inputs
Jรกrngreipr ๐งค
Designed with dual-screen devices in mind, Jarngreipr is a clean, powerful launcher that lets you decide exactly where your apps open, browse your game library, and drive an ES-DE setup from the second screen.
Pairs with Mjolnir on the AYN Thor to turn the Home button into a dual-screen controller. Works on any Android 13+ device; dual-screen features light up on devices with a second display.
Just as Thor needs his iron gloves, Jรกrngreipr ๐งค, to safely wield Mjolnir ๐จ, this launcher helps you grip control of your device's interface.
๐ What is Jarngreipr
Three things in one app, each usable alone.
- A launcher. A free-form
Canvaspage, folders, widgets, themes, RSS feeds, and full gamepad navigation. - A game frontend. Scans your ROM folders, scrapes artwork, launches the right emulator per system. Systems and games browse on the top screen; art mirrors to the bottom.
- An ES-DE companion. Turns the second screen into a live wallpaper, marquee, music surface, and effects stage that reacts to whatever ES-DE is showing on top.
โจ Highlights
- Canvas โ one continuous grid that holds apps, folders, ROMs, widgets, live game art, GIFs, and RSS tiles together.
- Frontend game library โ 40-system catalog, 204 built-in system logos, ~110 known emulators wired up with the right launch intent.
- Scraping โ ScreenScraper and SteamGridDB with per-game, per-system, and
Scrape all nowbackground jobs. - Dual-screen swap โ click L3 or R3 anywhere to swap the top and bottom screens, with an animated hand-off.
- Per-app launch display โ pick
Primary,External, orAskfor every app. - ES-DE mode โ wallpaper, marquee logo, music, jingles, konfetti, and screensaver all react within half a second of an ES-DE event.
- Theme sharing โ broadcast your current theme over BLE to nearby Jarngreipr devices; receive wallpapers over Nearby Connections.
- Backup & Restore โ export your entire setup to JSON and bring it back on a new device.
๐งฉ Canvas
The flagship page type. One continuous grid that holds apps, folders, ROMs, and widgets together. Canvas is the default page on a fresh install.
What you can add (from the Add menu): App, Folder, ROM, Widget, Frontend Tile, Photo container, RSS launcher, RSS widget.
What makes it different from the older tabs:
| Apps Tab | Apps & Widgets Tab | Canvas | |
|---|---|---|---|
| Apps | โ | โ | โ |
| Widgets | โ | โ | โ |
| Folders | โ | โ | โ |
| Pinned ROMs | โ | โ | โ |
| Frontend Tile | โ | โ | โ |
| Last Played Tile | โ | โ | โ |
| Photo containers, GIFs | โ | โ | โ |
| RSS launcher and now-playing tile | โ | โ | โ |
| Separate portrait and landscape | โ | โ | โ |
Push-based move, resize, Tidy now |
โ | โ | โ |
More: Edit mode, Scroll orientation (Vertical / Horizontal), 1 to 12 columns and rows, long-press empty space for the Canvas Menu, in-app Welcome to Canvas onboarding.
๐ฎ Frontend (game library)
Enable: Settings โ Extras โ Enable frontend. Browse your library from a system โ games screen on the top display, with art mirrored to the bottom.
Library. Point it at ROM folders (SAF). Scans run in the background and re-run when an SD card is mounted. 40 systems ship in the catalog (NES through Switch, DOS through Winlator); the catalog is JSON under frontend/src/main/assets/systems/, open to PRs.
Browsing. Systems view in Row or Grid, chosen separately for the top and bottom screen. Games view with per-system layouts. Search commands: @android, @hidden, @{platform}; plain text matches name, system, genre, developer, publisher. Hide systems or games. Reorder systems. Per-system customization: tile background, color, default emulator, ROM folder.
Game details. Launch, Favorite, Hide, Pick Emulator, Change Core, Scrape, Edit Info, Companion, media type per game. Stats include genre, developer, publisher, players, rating, play count, play time.
Emulators. About 110 known emulators wired with the right launch intent per system: RetroArch cores, PPSSPP, AetherSX2 and NetherSX2, Dolphin, Azahar, Eden, Yuzu, aX360e, Winlator variants, and more. Resolution order: per-game โ per-system โ extension fallback โ picker.
Scraping. ScreenScraper (user account) and SteamGridDB (API key).
- Per-game
Scrapeand per-systemScrape Mediadownload artwork. Scrape all nowruns as a background job with a notification.- Output lands in
/storage/emulated/0/Jarngreipr Media/<system>/<kind>/.
ES-DE compatibility. Read gamelist.xml pulls titles, descriptions, and ratings from an existing ES-DE setup. ES-DE's downloaded_media and RetroHrai! art folders are read automatically. You do not need ES-DE installed.
๐ฅ๏ธ Dual-screen
- Swap screens.
SettingsโES-DEโDual-screenโSwap screens, or click L3 or R3 anywhere. Animated hand-off. The choice is remembered. - Home button gestures (Thor, via accessibility service).
Press onceopens the launcher on the bottom;Double pressopens the frontend;Long pressopens both. Disable Mjolnir's accessibility service first, since both apps bind the Home button. - Per-app launch display.
Launch on Primary Display,Launch on External Display, orAsk. - Companion apps. Bind an app to a game; it launches on the opposite screen alongside the game (guides, Discord, a second emulator window).
- Frontend Tile. A Canvas tile that shows art for whatever is focused in the frontend: covers, marquee, fanart, screenshots, miximages, or description. Tap for game details.
- Audio.
Top Screen VolumeandBottom Screen Volumecontrolled independently. - Game launch helpers.
Wake Method,Persist Display on Game Launch,Control Power on Game Events.
๐ญ ES-DE companion mode
Turn the frontend off and Jarngreipr becomes a live companion for ES-DE running on the other screen.
Setup. Settings โ ES-DE โ Run Setup Wizard. Installs event scripts into /storage/emulated/0/ES-DE/scripts; ES-DE writes events, Jarngreipr reacts within half a second.
What reacts to ES-DE focus:
- Wallpaper.
AppearanceโWallpaperโES-DE, with blur, dim, and image-type choices. - Marquee logo. Size, alignment,
Logo Only Mode, double-tap shortcut. - Background music. System, game, and screensaver tracks.
System-Specific Musicpicks a different track per system folder. - Jingles. Collections pulled from GitHub repos, with regex priority rules.
- Konfetti. Custom animations on select and launch.
- Screensaver.
ShowContentorPowerOffbehaviors. - Power. Screen off on launch, on at exit.
- Video playback. Uses the Presentation API to route video to the external display.
System Apps. Link each ES-DE system folder to an Android app for one-tap launching.
Broadcasts for scripts and automation: jr.brian.SET_ESDE_WALLPAPER, jr.brian.SET_STANDARD_WALLPAPER.
Extras. Hide UI When Browsing Games, Delete Empty Folders, Custom Paths.
๐ Launcher features
Pages. Canvas (default), Apps Tab, Apps & Widgets Tab, App Drawer Tab, RSS Tab. Unlimited pages, per-page type.
Apps. Folders, free positioning with Snap Mode, visibility per page, custom icons (PNG or GIF), icon packs (Lawnicons, Arcticons, any), name and size options, Recent Apps, Quick Delete, Back Button Shortcut (11 actions).
Widgets & Dock. On Apps & Widgets pages: resizable Android widgets from any installed app, a pinned dock row.
Gamepad. Full D-pad navigation, built-in on-screen keyboard, GamePad control of the main display via Shizuku, Control Pad button and joystick mappings.
Appearance. 7 built-in themes plus Create Custom, OLED Black Mode, Icon Shape, wallpaper as image, GIF, video, system, or ES-DE.
RSS. Add feeds (RSS 2.0 and Atom), audio and video playback, Now Playing shade with system equalizer support.
Audio. Launcher Background Audio keeps music playing underneath.
Sharing. Theme Sharing over Bluetooth (Ping) with a Quick Settings tile. Wallpaper sharing over Nearby Connections.
System. Backup and Restore to JSON, System Monitor, Crash Logs, Check for Updates, in-app FAQ, What's New, Floaty Mode easter egg (tap the version 7 times).
What is Ping?
Ping is an open-source library that powers Theme Sharing between two Jarngreipr devices. It uses Bluetooth Low Energy for themes and Google's Nearby Connections API for wallpapers. Open Settings โ Appearance โ Theme Sharing to get started.
๐ Requirements
- Android 13 (API 33) or higher.
- Dual-screen features need a second display. Swap and Home gestures are Thor-only.
- Optional: Shizuku (for
GamePad), ES-DE (companion mode), RetroHrai! media packs.
๐ ๏ธ Install
From Releases
- Download the latest APK from the Releases page.
- Enable installs from unknown sources if prompted.
- Install, then set Jarngreipr as your default launcher.
From Source
git clone https://github.com/BrianJr03/Jarngreipr.git
cd Jarngreipr
./gradlew assembleStandardDebug
adb install app/build/outputs/apk/standard/debug/*.apk
- JDK 17 required. Android Studio Ladybug or newer.
- Flavors:
standardandhidden. Thehiddenflavor removes the app from Recents and adds anhsuffix to the package name. - Release builds are unsigned unless you pass
-Pandroid.injected.signing.*. - ScreenScraper dev credentials are optional for local builds. Pass
-Pscreenscraper.devIdand-Pscreenscraper.devPassword, or set them as environment variables.
๐ฏ Getting started
Three paths, pick the one that fits.
Just a launcher. Install โ set as default โ the first page is already a Canvas โ long-press empty space to add apps, folders, widgets, and ROMs.
Game frontend. Settings โ Extras โ Enable frontend โ Settings โ ES-DE โ Systems โ Add Systems โ pick ROM folder(s). On the top screen, press START for Frontend Settings, enter your ScreenScraper account, then Scrape all now.
ES-DE companion. Install ES-DE โ Settings โ ES-DE โ Run Setup Wizard โ enable scripts in ES-DE โ set wallpaper to ES-DE.
๐ก Theme Sharing (Ping)
Jarngreipr supports sharing themes and wallpapers wirelessly with nearby devices using Ping (Bluetooth LE) and the Nearby Connections API.
Theme sharing (BLE). Settings โ Theme Share โ grant Bluetooth and battery-exempt permissions โ tap Start Sharing. Enable auto-start to broadcast every time the launcher opens. A system Quick Settings tile toggles broadcasting without opening the app.
Wallpaper sharing (Nearby). Same screen, toggle Nearby Wallpaper to discover senders. Received wallpapers appear in Received Wallpapers.
| Permission | Purpose |
|---|---|
BLUETOOTH_SCAN / BLUETOOTH_ADVERTISE / BLUETOOTH_CONNECT |
BLE theme broadcasting |
FOREGROUND_SERVICE / FOREGROUND_SERVICE_CONNECTED_DEVICE |
Background sharing |
ACCESS_FINE_LOCATION / ACCESS_WIFI_STATE / CHANGE_WIFI_STATE |
Nearby wallpaper discovery |
NEARBY_WIFI_DEVICES (API 33+) |
Nearby Connections |
๐ค Contributing
Fork, branch off main, open a PR against dev. The project uses Jetpack Compose, Hilt, Room, WorkManager, media3, Coil, and OkHttp; new features should ship with tests.
System JSON lives under frontend/src/main/assets/systems/ and is a good first contribution target.
๐ Bug reports & feature requests
Open an issue. For bugs include device model, Android version, and reproduction steps. For questions, check the in-app FAQ first.
๐ Support
If you enjoy using Jarngreipr, consider supporting development:
- โ Ko-fi โ early builds and the main support channel.
- ๐ฌ Discord community (link in-app, under
SettingsโAbout).
๐๏ธ Tech stack
- Modules:
:app,:core-model,:core-ui,:frontend. - Language: Kotlin 2.3, Jetpack Compose BOM 2026.02, Material 3.
- Build: AGP 9.0, JDK 17, Gradle Kotlin DSL.
- Architecture: MVVM with Hilt DI, Kotlin Coroutines and Flow.
- Persistence: SharedPreferences, DataStore, and two Room databases (launcher + library).
- Async work: WorkManager (scraping, library scans).
- Media: media3 for audio and video, Coil for images.
- Networking: OkHttp.
- SDK:
minSdk 33,targetSdk/compileSdk 37. - Testing: JUnit, Turbine, MockK across unit and instrumented suites.
CI runs unit tests and lint on every push; a dedicated build-apks.yml workflow produces sideload-friendly debug and release APKs on demand.
๐ License
MIT. See LICENSE.
๐ Acknowledgments
- AYN โ for the Thor handheld that shaped the dual-screen design.
- Mjolnir โ the companion app for Home-button dual-screen control.
- ScreenScraper and SteamGridDB communities โ for the art and metadata that make scraping possible.
- Icon pack creators โ for keeping things beautiful.
- Community contributors โ for feedback, bug reports, and feature ideas.
- You โ for using Jarngreipr! ๐งค
- Icons from Icons8: Ko-fi, Discord, Buy Me a Coffee.
Made with โค๏ธ by BrianJr03
Wield your launcher like Thor wields Mjolnir ๐จ
How Shizuku is used
Can map touch controls to gamepad input, use trackpad as mouse and pin input to a display via `InputManager.injectInputEvent` and `settings put` through Shizuku.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku is used to let one touch screen act as a controller for games on the other display.
- Press game buttons: on-screen buttons send gamepad key presses and releases to the active game through the privileged input service, with a shell key event as fallback.
- Use triggers and sticks: shoulder triggers send key plus analog trigger motion events, and left and right sticks send joystick motion events for movement and camera control through the same service.
- Control mouse cursor: the trackpad screen moves the cursor, sends left and right clicks and scrolls by injecting mouse motion events through the privileged input service.
- Keep input on chosen display: a focus lock choice (Top, Bottom or Follow) writes the
screen_focus_lockandfocus_changesystem settings with thesettings putshell command through Shizuku when games and apps launch, screens swap or the frontend regains focus, so gamepad input routes to the intended display.
Android APIs or commands used
InputManager.injectInputEventInputManager.getInstanceKeyEventMotionEvent.obtaininput keyeventsettings put
Notable details
Display focus locking only applies on Thor (AYN) dual-screen hardware and does nothing when the mode is Off.
Changelog
What's new for version 3.1.3
Back Button Shortcut
- You can now set two back gesture shortcuts and pick which one to run from a quick menu
- The second shortcut can be any shortcut or app, or set to None to keep a single shortcut
- Both shortcuts are included in settings backups
3.1.3
Permissions
33 permissions requested