• Move / swap apps between screens (Back · hold) — live: the app keeps running and keeps its state; the controller can go with the game you move (per game too)
• A glass slide animation when an app moves
• "Opens on": each app opens on its own screen; apps that break when moved live (Firefox) reopen on the other screen instead
• App pairs: two apps, one press — from the quick panel or a combo; "Save what's on the screens now"
• Screens restored after a restart (optional)
• Recent apps (Back · double), driven by the controller: browse, open, close, clear all — its hint one line of words, symbols or off
• Close background apps (Back · triple) — the apps on both screens stay open
• Close this app — close the game you're playing with a combo, no multitask view
• Home goes home on the screen that has the controller — or on the top, the bottom or both screens, with your own combo

• Bottom screen off with a 3-finger tap (tap again for on) or a 3-finger swipe down; wake it with a double tap (optional) so a thumb brushing it doesn't
• Auto-off when the bottom screen is unused (15 s – 2 min)
• Per-app bottom-screen rule (keep on / off)
• Screen modes: both / top only / bottom only
• Stay awake
• Do not disturb while playing — never touches a Do not disturb you turned on yourself
• A Battery page: what the Thor draws right now, stop charging at 80 % and direct power (with what the charger is doing now), sleep

• Brightness per screen; Home + R2 / L2 = brighter / dimmer on both, keeping their difference (or one screen, with your own combo)
• Volume per screen, and the volume buttons change both together; "Same on both" when they differ
• Colour saturation (50–130 %)
• Speaker fix: EQ, +15 dB with a limiter and a stereo widener — EQ on / off to compare, never on headphones. EQ curve: the community preset by Joey (Retro Handhelds) — thank you!
• Volume boost: up to +12 dB with a limiter, on the speakers, headphones and Bluetooth
• Headphones & Bluetooth EQ: wired, USB and Bluetooth each their own sound — presets or a curve you shape; follows what you plug in
• 60 / 120 Hz, per app or per game
• FPS counter on either or both screens, in any corner, + battery and temperatures — per app or per game

• Combos on Home / Back: tap, double, triple, hold, + a button (tapped, twice, three times or held) — 30+ actions: volume and brightness per screen, swipes on the screen, record the screen, close the other screen's app…
• Stick flicks as combo buttons (Home + right stick up / down), and any button can start a combo
• Combo editor: press the buttons to record a combo
• Hold Home: a cheat sheet of every combo (let go without pressing anything: nothing happens)
• Open an app (on the screen you choose), a pair or a Wayfinder page with a combo
• Per-app combos: normal / custom / off
• Send the controller to the top or bottom screen, lock it; 4 modes (follows touch, stays where sent, always top, always bottom)
• AYN button opens Wayfinder's quick panel (or AYN's drawer); a tap and a hold can each do an action, and it can start combos too (AYN + a button)
• One-press fix for AYN's "press Home twice"
• Face buttons Nintendo-style / Xbox-style, globally or per app / game
• Test the controller: stick drift → a suggested deadzone for every game
• Games see one clean controller that stays controller #1; Home + Back held 5 s = emergency off
• Bluetooth and USB controllers work alongside — only the Thor's own controls are taken over
• Button names on screen as printed, the Xbox way or PlayStation symbols (or following AYN's controller style)
• The input layer runs everywhere, only in the games you set up, or nowhere — and on / off per game

• Remap per app, and per game inside emulators — "Which game?" switcher, "Change a button" by pressing it
• Automatic game detection (RetroArch, other emulators, GameNative, Cocoon)
• A button can become a button, the D-pad, keys, the mouse, Android Back, nothing, a macro or a Wayfinder action
• Several buttons at once, turbo, toggle, long / double press
• Macros: record, edit, up to 20 steps
• Chords: two buttons pressed together
• Hold-to-shift layer (optional, off by default)
• Each D-pad direction on its own; a stick as the mouse, the scroll wheel or four keys (arrows / W A S D), with dead zones so a resting stick never moves anything; a Web browsing preset
• Stick deadzone / response curve, trigger ranges, swap sticks, invert up / down and left / right, D-pad ↔ left stick
• Gyro: mouse, right stick or steering — always, while holding, toggle or on trigger pull; smoothing, calibration and auto-calibration; "Gyro on / off" as an action (a combo, a long press, a tile)
• Emulator presets: RetroArch hotkeys (hold Select + R1 / L1 / R2 / Start), emulator menu on hold Select + Start
• Copy controls from another app
• Per-game performance, fan, refresh rate, stick lights, bottom screen and FPS counter
• Share / import controls as a file — filtered, macros arrive switched off

• A deck on the other screen (Home + Y): PC keys, trackpad, numpad, emulator, media, video, "My pad" — and the game's Guide (its guide page and your notes, even over dual-screen games)
• Trackpad gestures (2-finger tap = right click, 2-finger drag = scroll, hold + move = drag), sticky Ctrl / Shift / Alt / Win
• Touch mode: the trackpad moves a pointer on the game's screen and taps, drags and swipes there like a finger — for games that ignore a mouse; Direct mode: the trackpad is the game's screen
• The right pad picked automatically per app
• Stick-as-mouse mode
• My pad: your own keys and text snippets; a simpler keyboard page
• Wayfinder Keyboard: type with the controller, 17 languages, accents, password-safe — opens on the other screen so the game keeps its own; pick keys with the D-pad (option); hold Space and slide to move the cursor; emoji; a clipboard with your last 5 copied texts (also in the deck, pasted into the game's screen)

• A glass panel on the bottom screen, with the game blurred behind — over a dual-screen game's second screen too; the game never pauses under it
• The panel takes the controller, or leaves it to the game (touch only)
• Brightness, volume, live stats, screen modes
• 45 shortcut tiles: Wayfinder, Android and AYN switches (bypass charging, 80 % charge limit, L2 / R2 mode…), plus tiles that open an app, an app pair or a Wayfinder page
• Arrange tiles like a home screen; show, hide and reorder the cards
• "Now playing": keep performance, fan, refresh rate and the bottom screen for this game
• Optional media and details cards

• Screen, bottom screen, performance, fan, refresh rate, combos, controls, input layer, lights, guide — each shows only what you changed
• Two apps open: performance, fan and refresh rate take the more demanding one; buttons and lights follow the app that has the controller

• A game guide (small browser, pin a page) and your notes — per game, even inside an emulator; on the bottom screen, in the Home + Y deck, or beside the game when no screen is free (an action and a tile); well-known ad networks aren't loaded

• AYN default, off, colour, breathing, strobe, spectrum, screen colour
• Per app / per game, speed, brightness (down to 1 %, or following the screens'), a colour for each stick (wheel or hex); screen colour split left / right, taken from the top screen, the bottom screen or the controller's screen

• Screenshots: top, bottom or both stacked (Home + R1)
• Screen recording of the top screen (up to 3 min, from the quick panel)

• Sleep actions: Wi-Fi, Bluetooth, Tailscale, Syncthing… with conditions (delay, battery, charging, hours)
• Lid guard: stays asleep in its case — with a heat guard (45 °C closed in the case → pauses media, performance to Standard)
• Pause music and videos when the lid closes
• Sleep when an external display is unplugged
• Standby drain stats, battery health, an activity log
• Sleep from a tile, a combo or the AYN button

• Light / dark / black (OLED) / system theme, see-through glass, blur, your wallpaper or the aurora backdrop — or your own flat colours
• The Hub on either screen — with the Hub on top, the bottom screen shows your combos
• A status strip: where the controller is, the app on each screen, battery, brightness
• Settings search
• A welcome tour with practice mode; choose what Wayfinder is for (just screen switching, or everything) — More → Features, part by part
• One-press setup — no root, no Shizuku, no PC
• Backup & restore
• Help, troubleshooting, a system-access check, open-source licenses, the version number
• "Update available" next to Ready when a new version is out (checked once a day, can be turned off)

Every release lists the APK's SHA-256 and the signing certificate's SHA-256. Check them before installing:

certutil -hashfile wayfinder-1.4.1.apk SHA256              (Windows)
sha256sum wayfinder-1.4.1.apk                               (Linux / macOS)
apksigner verify --print-certs wayfinder-1.4.1.apk          (the certificate)

The source is published so anyone can audit it.

• Android Studio (its JBR, JDK 17+) with the Android SDK; the native parts need the NDK (27.2.12479018).

• ./gradlew :app:assembleDebug — a debug build (use -Pminify for a build shrunk like the release).

• Native binaries shipped in app/src/main/assets/fx/ are built from fx/: tools/build_wfpad.sh (the input layer; tools/build_wfpad.sh test runs its unit tests on a Thor) and tools/build_fx.sh (the speaker widener) — Windows + Git Bash, NDK in the default SDK folder. SHA-256 of the shipped copies:

  • wfpad — a08e13ea3a0bd90b9b5c8e2d7ea4c3594720f0522eb31133c46472aaac78b7b8
  • libwfwide.so — f64974296927c51c1645b5c56af38504ef5e364d34df7620c07c0ce8a08d6b8a

  Rebuilt from this source with NDK 27.2.12479018 and those scripts, both come out byte-identical.

• Release builds are signed by the maintainer (tools/release.ps1); the key is never in this repository.

• Some code comments refer to the maintainer's private design notes; they aren't needed to build or understand the code.

Wayfinder works around Android's limited support for two screens. Most apps move fine; a few heavy or unusual apps may restart or refuse to move.

Wayfinder is an independent project, not affiliated with, endorsed or sponsored by AYN or any other company named here. AYN, Thor and Odin are trademarks of AYN; Nintendo, Xbox, RetroArch, PPSSPP, Dolphin, DuckStation, GameNative, Cocoon, Spotify, Steam, Shizuku, Tailscale, Syncthing and other names are trademarks of their respective owners, used only to describe compatibility.

• Sleep & standby — the ideas come from SleepManager by Baggio94 (closed-lid protection, false-wake handling, sleep actions and conditions, standby statistics). Wayfinder's version is written from scratch: no SleepManager code was copied. Thank you!

Wayfinder's own code: PolyForm Strict 1.0.0 (SPDX: PolyForm-Strict-1.0.0) — source-available, not open source. The source is published for transparency and security auditing. In short: you may read it, audit it, and build it as-is for your own personal, non-commercial use; you may not share it or builds of it, change it, or use it commercially. For anything else, ask through the Ko-fi page below. The Wayfinder name and icon are not licensed.

Not covered by that license: the Gradle wrapper (gradlew, gradlew.bat, gradle/wrapper/, Apache 2.0) and the libraries built into the app — see THIRD_PARTY_NOTICES.txt (also in the app: Help & status → Open-source licenses).

Contributions: pull requests aren't accepted (the license doesn't allow changes to the code) — bug reports and ideas are welcome as issues.