ShizuStore

Heimdall

mastercook777

0.5.0-alpha.1 · GitHub

Download APK
Vendor-specific Android 8.0+ 1 week ago Apache-2.0
94 ShizuStore
2.6k GitHub
111 Stars
24 MB Size

More about this app

Lower-screen game assistant for the AYN Thor with profiles, macros, touch controls, maps and Shizuku-powered touch injection.

Heimdall app icon

Heimdall

An open-source lower-screen game assistant built for AYN Thor.

Download Alpha · Setup Guide · 简体中文设置指南 · Report an issue

English | 简体中文

Heimdall keeps the game on Thor's upper screen while the lower screen becomes a persistent control and reference console: Profiles, macros, touch controls, translation, hardware status, maps, guides, local-media Canvases, Portals, recording, and Quick Actions stay within thumb reach.

Alpha software: Heimdall targets AYN Thor. Compatibility is not guaranteed for every Thor firmware, controller mode, game, emulator, or other dual-screen device.

Heimdall On A Real AYN Thor

Player using Heimdall Precision Aim and a circular magnifier on the lower screen while a shooter runs on the AYN Thor upper screen AYN Thor running an action RPG with Heimdall circular magnifier, touchpad, and Profile Macro controls on the lower screen
Active play: Precision Aim and circular magnification Profile controls: Portal, touchpad, and Macros
AYN Thor game on the upper screen with a local text Guide open in Heimdall on the lower screen Player using Heimdall Canvas move-list reference and Macro buttons while a fighting game runs on the AYN Thor upper screen
Reference: a local Guide without covering the game Execution: Canvas move list and structured Macros

What You Can Do

Area What Heimdall provides
Profiles and Grid Separate game layouts, App bindings, themes, touch settings, maps, guides, and Canvases. Drag and resize modules on a visible 12 x 8 Grid, then save explicitly. Browse curated Community Profiles and import each as a new Profile.
Macros Structured tap, hold, swipe, wait, and physical-controller sequences, including a controller composer with chords, charge holds, recomposition, mirroring, cloning, and bounded cancellation. No free-form command editing is required.
Touch and aiming Basic Touch, touchpad drag, Virtual Right Stick, Precision Aim, a real relative Virtual Mouse, and mapping-compatible Shizuku Touch when the required route is available.
PC keyboard A temporary complete US ANSI keyboard plus Profile-owned configurable Keypad modules through an available Advanced Controls/uinput route. This is active-play PC input, not Android IME text entry.
Reference tools Local maps, PDFs, guides, Interactive Map links, and Profile-owned image or muted looping-video Canvases.
Upper-screen tools Screenshot, screen recording, and up to two live Portals per Profile. A Portal can show an upper-screen region or send one-finger touches to it.
Translation and status Profile-owned upper-screen text translation with on-device OCR, plus a passive CPU-temperature and RAM monitor when Thor exposes the required ordinary-App sensor.
Appearance Six registered Heimdall/Freya colorways, optional per-Profile theme binding, and an experimental App-global opt-in switch for theme-matched Thor joystick LEDs.
Heimdall Freya White Main Grid with Macro buttons, Quick Actions, and touchpad Heimdall visual Grid editor with draggable and resizable modules
Play view: controls stay glanceable on the lower screen Edit view: drag modules and resize from visible corners

Start Here: Choose Only What You Need

Installing Heimdall does not require root or Developer options. Developer options are needed only if you want to start Shizuku for advanced controller features.

What you want to use Required setup
Profiles, Grid, maps, guides, Canvas, Community Profile browsing, and normal UI Install Heimdall only. The Community catalog and downloads need a network connection.
Upper-screen taps, holds, swipes, and compatible touchpad drag Enable the Heimdall Accessibility service for Basic Touch.
Real-time Translation Enable Heimdall Accessibility for upper-screen capture, then configure a supported HTTPS translation provider and API key. OCR runs on-device; recognized text is sent to the selected provider.
Physical-controller recording/replay, Virtual Right Stick, Precision Aim, Virtual Mouse, PC Keyboard, or mapping-compatible Enhanced Touch On supported Thor firmware, enable Thor Direct in Connections. Shizuku remains the fallback and the route for other devices; its wireless-debugging setup needs Developer options.
Quick Actions media controls or linked dual-screen brightness Grant Android notification access for media sessions. Linked brightness additionally needs Thor Direct Ready and manual brightness mode.
View Only or Interactive Portal, or screen recording Accept Android's screen-capture consent when Heimdall requests it. Interactive Portal also needs an available Advanced Controls route.

You do not need to enable every permission during first launch. Start with one Profile and one route, test it, then add features as needed.

1. Download And Install

  1. Open the Heimdall Releases page.
  2. Open the newest versioned Alpha release.
  3. Download the file named like heimdall-vX.Y.Z-alpha.N.apk. The same release also includes SHA256SUMS.txt for file verification.
  4. Open the APK with Thor's file manager.
  5. If Android asks, allow that file manager to install unknown apps, return to the installer, and finish installation.
  6. Open Heimdall.

Install only immutable, versioned releases from this repository. The mutable private-development debug-latest channel is not a public release, and re-signed APKs from unknown sources should not be trusted.

Updating Or Moving From An Older Test Build

Official Alpha updates signed with the same release identity can normally install over the previous public Alpha. Do not uninstall first unless the release notes explicitly require it: uninstalling removes local Profile data and imported assets.

Older test packages and new Debug builds may be separate Apps and do not share data with the public package com.mastercook777.heimdall.

Before moving from an older test build:

  1. Open Profile management in the old build.
  2. Export all Profiles and keep the exported file somewhere easy to find.
  3. Install and open the public Alpha.
  4. Re-authorize the services you use.
  5. Import the exported file and confirm the important Profiles before deleting the old build or backup.

Older builds export configuration-only JSON, which remains importable but cannot recover missing external assets. Current builds export a self-contained .heimdall-profile bundle containing Profile data plus supported Profile icons, maps, file Guides, user Macro icons, and Canvas media.

2. Create Your First Profile

  1. Open Settings > Profile management.
  2. Create a Profile for one game or emulator.
  3. Start the target App on the upper screen, then bind it from Heimdall's recent-App selector.
  4. Choose a Grid preset. Balanced is the easiest starting point; Controls reserves more room for touch controls, and Macros shows more actions.
  5. Add only the modules you want now.
  6. Tap Save at the bottom of Settings.
  7. Switch back to the game and confirm Heimdall selects the expected Profile.

You may also designate one existing Profile as Desktop Profile in Profile settings. It is the fallback for a confirmed unbound upper-screen App or launcher, and the Profile switcher offers Return to Desktop. Manual selection remains in place until a confirmed upper-App or game change.

Save boundary: Grid and several Profile settings use preview/draft state. Seeing the preview does not mean it has been stored; save before leaving the editor or Settings.

3. Enable Basic Touch (Optional)

Basic Touch sends compatible taps, holds, swipes, and touchpad drags to the upper screen through Android Accessibility. It does not require Shizuku or Developer options.

  1. Open Settings > Connections in Heimdall.
  2. Choose Basic Touch and tap its enable action.
  3. In Android Accessibility settings, find Heimdall, read the system warning, and enable the service.
  4. Return to Heimdall and confirm Basic Touch is available.
  5. Test one simple tap macro or touchpad movement before building a longer macro.

Basic Accessibility touch and Thor's built-in mapper use separate touch streams and may cancel each other when used simultaneously. If coexistence is required, use the mapping-compatible Enhanced Touch route only when Heimdall reports it as available.

4. Set Up Advanced Controls (Optional)

On supported Thor firmware, open Heimdall > Settings > Connections > Thor Direct, choose Enable Thor Direct, and wait for Ready. This optional route supports physical-controller recording/replay, Virtual Right Stick, Precision Aim, Interactive Portal, Enhanced Touch, Virtual Mouse, PC Keyboard, and Game Context. If it is unavailable, use Shizuku as the fallback; Shizuku also serves other supported devices. Heimdall installation itself does not require root.

Shizuku fallback

Never Enabled Developer Options Before?

Android menu names can vary slightly by Thor firmware. If a named page is hard to find, use the search box in Android Settings for Build number, Developer options, or Wireless debugging.

  1. Open Thor's Android Settings.
  2. Open About device, About handheld, or a similarly named page.
  3. Find Build number. On some firmware it may be inside a software/version details page.
  4. Tap Build number seven times.
  5. Enter the screen-lock PIN if Android asks. A message should confirm that Developer options are enabled.
  6. Go back to System > Developer options, or search Settings for Developer options.
  7. Enable USB debugging.
  8. Open Wireless debugging and turn it on.

Developer options are now available. You normally do not need to repeat these eight steps.

Pair And Start Shizuku

  1. Install and open Shizuku.
  2. Choose Start via wireless debugging, then start pairing.
  3. Return to Android's Wireless debugging page.
  4. Choose Pair device with pairing code.
  5. Enter the displayed code in Shizuku's notification or pairing screen.
  6. Return to Shizuku, tap Start, and wait for it to report that Shizuku is running.
  7. Open Heimdall > Settings > Connections > Advanced Controls.
  8. Tap the authorize/connect action and allow Heimdall in the Shizuku permission dialog.
  9. Return to Heimdall and confirm Advanced Controls are available.

After restarting Thor, check Shizuku before using controller features. If it is no longer running, start it again; pairing normally does not need to be repeated.

If Shizuku stays on "Searching for pairing service," allow it to run in the background, enable its notifications, keep local networking and wireless debugging available, and try turning wireless debugging off and on once. See the official Shizuku troubleshooting guide for current platform-specific advice.

5. Use Heimdall

Grid And Modules

Open the visual Grid editor to add, drag, resize, or remove modules. Modules snap to the 12 x 8 Grid. Preview first, then save the Grid and Profile explicitly. Layouts from earlier Alpha releases migrate forward; review the result before saving further edits.

Touch Macros

  1. Add a Macro module to the Grid.
  2. Hold a Macro button for about 1.8 seconds to open the structured editor.
  3. Add tap, hold, swipe, or wait steps.
  4. When capturing coordinates, act directly on the upper-screen target.
  5. Save the Macro, return to Main, and tap the button to run it.

Physical-Controller Macros

Controller recording and replay require an available Advanced Controls route. Thor's built-in mapper may hide already-mapped physical buttons from Heimdall's recording stream. If this happens, begin recording, temporarily return to Android Home to press the button, then return to Heimdall to review and save the sequence.

Enhanced Touch protects Thor's built-in mapping by default and rejects Macros containing physical-controller steps before replay. If the mapper is off, you may disable that protection for the current Profile; screen steps still use the strict mapping-compatible touch route and never fall back to Accessibility.

Touchpad, Virtual Right Stick, And Precision Aim

  • Touch drag converts lower-screen finger movement into an upper-screen drag.
  • Virtual Right Stick emits Thor right-stick input through Advanced Controls and should return to neutral immediately after release.
  • Precision Aim is for small camera corrections. Start with low sensitivity and keep the physical stick for large turns.

Portal, Community Profiles, Maps, Guides, And Canvas

  • Add up to two Portals to a Profile's Grid. Each Portal has its own upper-screen region, zoom, shape, frame rate, and View Only or Interactive mode. Both share one screen-capture session. Interactive mode sends one-finger input through an available Advanced Controls touch route; only one Portal gesture can be active at a time. Portal and screen recording cannot run together. Choose the region in Portal Settings, then press Save; Grid placement has its own Save.
  • Open Community Profiles from Profile management to browse the curated catalog. A download is checked against its catalog size and SHA-256, validated as a .heimdall-profile bundle, and imported as a new Profile. Existing Profiles are not replaced. The catalog and bundles come from the community repository.
  • Gallery groups the current Profile's maps, new Heimdall screenshots, and saved Canvas images. It can send an image to an existing Canvas. Removing a screenshot from Gallery leaves the original file intact.
  • Guides belong to the current Profile and may reference local PDFs, text, or links. Local Note/TXT/Markdown readers offer full-text search and chapter navigation; PDF and web links still open externally.
  • Canvas accepts local JPG, PNG, GIF, WebP, and MP4 media. GIF and animated WebP require Android 9 or newer; MP4 is always muted and loops. A Profile can contain multiple independent static Canvases, while GIF, animated WebP, and MP4 share a limit of one dynamic Canvas. Files are limited to 50 MiB; images may be up to 4096 × 4096 and MP4 video up to 2048px on its longest side. APNG is not supported. Double-tap a Canvas for full-screen viewing and hold it to replace its media or adjust composition.
  • A static Canvas can rotate through several saved images. Configure the slides and framing in its editor, then choose a transition and interval. Multiple Canvases with the same interval share slideshow timing.

Translation And Hardware Monitor

  • Add one Translation module to a Profile, hold it to choose the upper-screen region, OCR script, and target language, then save the component. The runtime region shortcut commits only the confirmed region; it does not save unrelated Grid placement changes.
  • Translation uses Heimdall Accessibility screenshots and bundled on-device ML Kit OCR. It does not acquire MediaProjection. Only recognized text is sent over HTTPS to the configured SiliconFlow or custom OpenAI-compatible /chat/completions endpoint.
  • Provider settings and the API key are App-global. The API key is encrypted with Android Keystore and is not included in Profile JSON or .heimdall-profile exports.
  • Test connection checks the current Settings draft. Press the Settings footer Save after a successful test to make that provider configuration active.
  • Add one Hardware Monitor per Profile to show CPU temperature and used/total RAM. It needs no Shizuku permission and shows unavailable rather than guessing when Thor's verified CPU sensor cannot be read uniquely.

Themes And Joystick Lighting

Choose a registered Heimdall or Freya colorway under Appearance. A Profile can use its own saved theme or follow the App default. The experimental Match joystick lighting switch is App-global and off by default; on supported Thor firmware it applies the resolved theme color and one shared brightness to both joystick rings. Heimdall does not use Shizuku, root, polling, animation, or game events for this feature, and theme changes remain usable if the firmware lighting call is unavailable.

Screenshot And Recording

Quick Actions can capture the upper screen, control compatible active media sessions, adjust media volume, and, with Thor Direct, adjust both Thor displays' brightness. Configure only the capabilities wanted for each Profile. Android notification access is required to discover media sessions. Tap the media permission text to open Heimdall's guide, then try enabling access on the system page. If Android blocks it as a restricted setting, long-press Heimdall on Thor's upper-screen launcher, open App info, and choose top-right menu > Allow restricted settings. Return to Heimdall and retry access. On some devices the menu option appears only after the first blocked attempt. Thor may hide this menu when App info is opened directly from Heimdall. Recording uses Android MediaProjection and Android Audio Playback Capture rather than microphone input. The upper App may still forbid its game audio from being captured.

6. Back Up Before Uninstalling

Use Profile management to export the current Profile or all Profiles after completing an important layout or Macro setup. The .heimdall-profile bundle is self-contained for supported Profile-owned assets and is validated before import. Heimdall also keeps bounded recovery snapshots for some destructive Profile changes, but these do not replace an export stored outside the App. See the Profile bundle format.

Android platform backup is disabled for this Alpha. Uninstalling the App removes its local data.

Known Alpha Limitations

  • Android streaming clients do not reliably forward external Meta/Win input from Heimdall's uinput keyboard. Full Keyboard shows disabled Win keys and Keypad does not offer Win bindings; use the streaming client's built-in keyboard when Win is required.
  • Mapping-compatible Shizuku Touch is verified only on tested Thor firmware, game, and mapper combinations. Other firmware may report it unavailable.
  • Basic Accessibility touch and Thor's built-in mapper may cancel each other during simultaneous operation.
  • Thor's mapper may hide mapped controller buttons from the Macro recorder.
  • A Profile supports at most two live Portals. Interactive input is one finger and one active Portal gesture at a time. Portals cannot share MediaProjection with recording.
  • After a lower-screen Tab round trip, a frozen Portal's Stop marker can occasionally be missing; stopping can also leave the final retained frame visible. These are known presentation-state issues, not proof that the frame is still live.
  • Translation quality, latency, and service availability depend on the selected OCR script, network, model, and provider. SiliconFlow China with Hunyuan-MT-7B is the owner-tested route; other listed or custom OpenAI-compatible endpoints are protocol-compatible but not all are Thor-validated.
  • Hardware Monitor reports CPU temperature only when Thor exposes one unique readable cpu-0-1 thermal source to the ordinary App process. It intentionally does not substitute battery temperature or estimate fan speed.
  • Theme-matched joystick lighting remains optional and off by default. It uses the Thor stock-lighting protocol; if firmware behavior differs, use Thor's system lighting controls to restore or disable the lights.

Read the v0.4.0-alpha.1 release notes for the new scope and known limitations. The visually reviewed 0.2.0 English and Simplified-Chinese PDF guides remain archived references; this README is the current setup guide.

Helpful Bug Reports

Use GitHub Issues and include:

  • Heimdall version and Thor firmware version.
  • Controller mode: native or Xbox.
  • Game or emulator name.
  • Active route: Basic Touch or Shizuku.
  • Whether Thor's built-in mapper is enabled.
  • Exact reproduction steps and frequency.
  • Screenshot or recording when possible.
  • Whether restarting Heimdall, restarting Shizuku, or re-authorizing changes the result.
Build From Source

Requirements:

  • JDK 17
  • Android SDK 35
  • CMake 3.22.1
  • Android NDK 30.0.14904198

Build the Debug APK:

./gradlew :assistant:assembleDebug --no-daemon

Run the same static gate used for Alpha:

./gradlew :assistant:lintDebug --no-daemon

The public repository contains no signing key. Local Debug builds use the Android development signing identity. Public Alpha builds are created only by the tag-gated release workflow with an external private signing key.

Data, Privacy, And Contributing

Profile data stays on the device unless the player explicitly imports or exports it. Internet access is used for player-configured Interactive Map pages and optional Translation requests. Translation OCR runs locally, but recognized text is sent to the provider selected by the player. See docs/PRIVACY.md.

Read CONTRIBUTING.md before submitting a change. Native input, cross-display routing, MediaProjection, performance, and physical ergonomics require clearly scoped AYN Thor evidence.

License

Heimdall source is licensed under the Apache License 2.0. See LICENSE, NOTICE, and THIRD_PARTY_NOTICES.md.

AYN and Thor are trademarks of their respective owner. Heimdall is a community project and is not presented as an official AYN application.

Close

How Shizuku is used

Can inject touch, gamepad, mouse and keyboard input and detect emulator games via `Shizuku user services`.

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

Heimdall uses Shizuku to run privileged helpers that inject input into games and detect which emulator game is active.

  • Inject touch gestures: touchpad drags, taps and saved touch macros are injected into the game through Shizuku, including mapped touch for the lower screen.
  • Replay controller input: saved gamepad macros and sequences are replayed as physical controller button combos through Shizuku, with adjustable hold timing.
  • Aim with right stick: right stick movements from profiles and macros are emitted as native stick motion through Shizuku.
  • Record controller sequences: physical controller input can be recorded for a short duration through Shizuku and saved as a reusable macro step.
  • Control virtual mouse: mouse moves, wheel motion and button presses from the assistant are emitted as virtual mouse input through Shizuku.
  • Control virtual keyboard: key presses and releases from the assistant are emitted as virtual keyboard input through Shizuku.
  • Detect active emulator game: the foreground emulator and loaded game are identified through Shizuku using fixed logcat, process and activity checks for supported emulators, so profiles, macros and maps can follow the current game.

Android APIs or commands used

  • android.hardware.input.InputManager.injectInputEvent
  • android.view.MotionEvent.setDisplayId
  • android.system.Os.sysconf
  • logcat
  • pidof
  • dumpsys activity activities

Notable details

Touch moves and macros without controller steps can fall back to the accessibility input path when Shizuku is unavailable; native touch, gamepad replay, virtual mouse and keyboard, and game detection need Shizuku. Game detection only covers a fixed allowlist of supported emulator apps.

Close

Changelog

What's new for version 0.5.0-alpha.1

Heimdall 0.5.0 Alpha 1 Release Notes

Release tag: v0.5.0-alpha.1

English | 简体中文

English

Updating

  • Install this official Alpha over an existing official Heimdall Alpha. Uninstalling first removes local App data.
  • Export important Profiles and keep the .heimdall-profile bundles outside the App until the update has been checked. Provider API keys are not included in Profile exports.

What's New

  • Gallery and Canvas: The Gallery now groups Profile maps, newly indexed screenshots, and saved Canvas images. Images can be sent to an existing Canvas through its composition editor. Canvas can also rotate through a saved set of images; its slideshow timing stays aligned across Canvas widgets.
  • Guide reader: Search the full text of a local Note, TXT, or Markdown guide and jump through its detected chapter headings. The earlier Guide Peek Home widget was withdrawn and is not in this release.
  • Controls and layout: Virtual Mouse can use a movement-only mode or enable gestures, including an optional three-finger middle click. Macros can repeat with a chosen time limit and the same button stops them. Grid Add makes room in a crowded layout preview while keeping Save/Discard explicit. About Heimdall shows the creator and support link.
  • Desktop Profile: Choose one existing Profile as the fallback for a confirmed unbound upper-screen app or launcher. The Profile switcher provides a Return to Desktop action. Manual Profile selection remains in place until the upper-screen app or a confirmed game changes; ambiguous recognition does not force a switch.
  • Quick Actions: Choose shortcut actions and optional media controls, linked dual-screen brightness, and media volume for each Profile. The module reflows with its selected capabilities; the full set fits a 4 × 6 Grid area on the tested Thor layout. Media controls use Android's active media sessions, include a player switcher, and can open a launchable player on the upper screen. The speaker icon toggles mute. Linked brightness requires an available Thor Direct connection and manual brightness mode.
  • Thor Direct: On supported AYN Thor firmware, an optional direct connection now provides the native controller and upper-screen input routes previously requiring Shizuku. Shizuku remains available as a fallback and for other devices. Thor Direct is experimental and can become unavailable if the firmware's service changes.
  • Profile binding: Choose an app by name from recently detected or installed apps. The editable package-name field has been removed; the chosen app and game-context binding still take effect only after Settings Save.

Privacy and Requirements

  • Media controls require Android notification access and a compatible active media session. Heimdall guides first-time access through the app's own permission page and Android's restricted-settings step when required. A player that does not expose a usable session or action may offer limited controls. Selecting a player does not guarantee that a background app can start playback.
  • Linked brightness uses Heimdall's opt-in Thor Direct helper on the two recognized physical Thor displays. It is unavailable when that route is not ready or automatic brightness mode is active.
  • Thor Direct does not change the existing permissions for Basic Touch or Android screen capture. See Privacy and the setup guide.

Known Limitations

  • Heimdall targets AYN Thor; other firmware, controller modes, games, emulators, streaming clients, and dual-screen devices are not guaranteed.
  • Automatic Profile matching remains conservative. RetroArch and PPSSPP Gold retain pending or limited coverage; ambiguous evidence never triggers a switch.
  • Media controls depend on each app's MediaSession behavior. Some apps require playback to be started inside that app before Heimdall can control it.
  • The Gallery indexes only new Heimdall screenshots for a Profile; removing a Gallery reference does not delete its original file. Guide search and chapters apply to local text, not PDF or web links.
  • About's online supporter list will remain empty until consenting names are published; its creator and support information work independently.
  • The Grid and Profile editors still require explicit Save. Export Profiles before uninstalling; Android platform backup remains disabled.

简体中文

更新说明

  • 可直接覆盖安装到现有的官方 Heimdall Alpha。先卸载会清除应用本地数据。
  • 更新前导出重要 Profile,并将 .heimdall-profile 迁移包保存在 App 外部,直到确认更新正常。Profile 导出不包含翻译服务的 API Key。

本版改进

  • 图库与画布: 图库按当前 Profile 展示地图、新建立索引的截图和已保存的画布图片。可将图片送入现有画布的编辑器;画布还可轮播已保存的多张图片,多个画布的轮播时间保持同步。
  • 攻略阅读: 可搜索本地笔记、TXT、Markdown 攻略全文,并通过识别出的章节标题跳转。此前试做的主页 Guide Peek 小组件已回退,不包含在本版中。
  • 操控与布局: 虚拟鼠标可只移动指针,或开启手势及可选的三指中键。宏可按选定时限循环,再按同一个按钮停止。Grid 在拥挤的草稿中添加模块时会尝试腾出空间,仍须明确保存或放弃。“关于 Heimdall”展示作者和支持链接。
  • 桌面 Profile: 可将一个现有 Profile 设为桌面回退页。当上屏应用或启动器已被可靠识别、且没有对应绑定时,Heimdall 显示该 Profile;切换面板提供“返回桌面”。手动选择其他 Profile 后,会保持到上屏应用或明确识别的游戏发生变化;有歧义的识别结果不会强制切换。
  • 快捷操作: 每个 Profile 可选择快捷按钮和媒体控制、双屏联动亮度、媒体音量等可选能力。模块会随所选能力调整布局;全部开启时,在已测试的 Thor 布局中可使用 4 × 6 格。媒体控制使用 Android 当前媒体会话,提供播放器切换,并可在上屏打开可启动的播放器;点击喇叭图标可静音或恢复。双屏亮度需要可用的 Thor 直连及手动亮度模式。
  • Thor 直连: 在受支持的 AYN Thor 固件上,可选的直连通道提供原先需要 Shizuku 的原生手柄与上屏输入能力。Shizuku 仍可作为备用方案,也可用于其他设备。Thor 直连仍为实验性能力,固件服务变化可能使其不可用。
  • Profile 绑定: 可按名称从最近识别或已安装的应用列表选择绑定对象,移除了手填包名框。选中的应用及游戏上下文仍须点击设置页“保存”后才生效。

隐私与使用条件

  • 媒体控制需要 Android 通知使用权和兼容的媒体会话。首次授权会直接引导到 Heimdall 的权限页面,必要时提示系统的“受限制的设置”步骤。播放器未提供可用会话或动作时,控件能力可能受限。选中播放器不保证后台应用能够直接开始播放。
  • 双屏联动亮度使用由玩家主动开启的 Thor 直连助手,仅作用于识别到的两块 Thor 实体屏。直连未就绪或系统处于自动亮度模式时不可用。
  • Thor 直连不会改变基础触控或 Android 屏幕捕获原有的授权要求。详见隐私说明和入门指南。

已知限制

  • Heimdall 面向 AYN Thor,不保证兼容其他固件、手柄模式、游戏、模拟器、串流客户端或双屏设备。
  • Profile 自动匹配仍保持保守。RetroArch 与 PPSSPP Gold 仍有待验证或覆盖有限;证据有歧义时不会自动切换。
  • 媒体控件依赖各 App 的 MediaSession 行为。某些 App 需要先在自身界面启动播放,Heimdall 才能控制。
  • 图库只为当前 Profile 的 Heimdall 新截图建立索引;移除图库引用不会删除原文件。攻略搜索与章节适用于本地文本,不处理 PDF 或网页链接。
  • “关于”里的在线支持者名单须待获得同意的昵称发布后才会显示;作者和支持信息不受影响。
  • Grid 和 Profile 编辑仍须明确保存。卸载前请导出 Profile;Android 平台备份仍关闭。

Build integrity

  • Source commit: e610cf135ed413de5433ea28b9825c9bf9027473
  • Candidate workflow run: 42168178993
  • Candidate artifact: heimdall-alpha-candidate-0.5.0-alpha.1-42168178993-1
  • Package: com.mastercook777.heimdall
  • Version code: 9
  • Version: 0.5.0-alpha.1
  • Signing certificate SHA-256: 7B779E4A082DDBC00FF47706B3B3A9E91B2594E33EA39DFE1376E1DBA538F458
  • Owner-approved APK SHA-256: 5E3887B1DDF0AEEF930D44007C66257992FD3542A522EA3F1B495C7C18EF952D
Close

Permissions

7 permissions requested

  • android.permission.INTERNET
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION
  • android.permission.RECORD_AUDIO
  • moe.shizuku.manager.permission.API_V23
  • com.mastercook777.heimdall.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
Close