GitHub Kotlin Monthly Trending Repositories

ExTV/Podroid

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

https://extv.github.io/Podroid/

Podroid

Run Linux containers and a full Linux desktop on your Android phone. No root.

A real Alpine Linux VM with its own kernel - not a chroot or proot trick - so Podman, Docker and LXC behave exactly like they do on a server.

Website · Documentation · Download APK

_Home

_Running

_Terminal

_{Themes & fonts}

What you get

Podman, Docker and LXC - pre-installed, ready the moment it boots
A real VM - Alpine Linux on a custom kernel via QEMU, or hardware-accelerated AVF on supported pKVM devices
In-app terminal - full xterm-256color, 122 color themes, 13 fonts, live resize
X11 desktop - run GUI Linux apps in a built-in viewer with touch, keyboard, mouse and audio
USB passthrough, SSH, port forwarding and a guest-to-Android bridge
Container backup, a live VM/device status view and Downloads-folder sharing with the guest
English and 中文, no root, any arm64 device on Android 8+

Quick start

Download the APK and install it.
Tap Start VM, wait for Ready!, open the terminal.

# rootless containers, straight away
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx

# expose that container to your phone and LAN, right from the VM shell
podroid-forward add 8080 8080 tcp     # TCP or UDP, on both the QEMU and AVF backends
curl http://<phone-ip>:8080
podroid-forward clean                 # remove every rule you added, in one go

# SSH in from your laptop (enable SSH in the setup wizard or Settings)
ssh root@<phone-ip> -p 9922        # password: podroid

Setup, the two backends, networking, the X11 viewer and troubleshooting all live in the documentation.

Build

git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all     # kernel, rootfs, QEMU and APK (needs Docker + Android SDK/NDK)

Per-component builds and toolchain details: CONTRIBUTING.md.

Contributing

Contributions of every size are welcome: bug reports, kernel-config tweaks, new themes, UI polish, X11 input fixes, anything.

Pull requests: read CONTRIBUTING.md first. Keep changes scoped, run ./build-all.sh test before pushing, and explain why in the PR description.
Bug reports: open an issue with your device and Android version, a short repro, and the diagnostic log (Settings → Export Diagnostic Log in the app).

Related projects

RikkaHub Agent is a fork of RikkaHub, the native Android LLM chat client, that turns it into a real on-device agent: 80+ device tools, scheduled jobs, an AI-driven browser, a Linux workspace, SSH, screen automation and a remote Telegram bot, all opt-in. Its SSH tool can log into a running Podroid VM (localhost:9922), so an agent on your phone can build, run and inspect containers without you typing a command.

Credits


QEMU	Machine emulation
Termux	Terminal emulator engine
Alpine Linux	The guest distribution

Full list in CREDITS.md.

License

GPLv2. If Podroid is useful to you, a star helps other people find it.

YuKongA/ghostlock-app

GhostLock One-Tap Execution App (CVE-2026-43499)

GhostLock-App

中文: README_ZH.md

Documentation

Kernel Profile Porting Guide - add support for a new kernel. GhostLock matches kernels by exact uname -r and rejects unsupported builds, showing the status at the top. Built-in profiles live in app/src/main/assets/kernel_profiles/: one HOCON file per release, index.conf as the runtime index, and <major.minor>-template.conf version-family templates.
Supported devices - the built-in kernel list.
Shared execution defaults - every execution-tuning field, its default, and why.
Profile schema - full profile structure and data flow.
Adding a component - developer guide for a new native middleware / backend / frontend (Chinese).

For the complete device-porting workflow, kernel-family template links, and tuning rationale, see the Kernel Profile Porting Guide.

Rows explicitly marked Shizuku required run through a shell UserService. Start Shizuku with ADB and tap the status card to grant access; all other rows use the app's normal execution path.

Quick Start

Open GhostLock and tap Run. KernelSU (me.weishu.kernelsu), ReSukiSU (com.resukisu.resukisu), or KowSU (com.kowx712.supermanager) provides ksud for module loading; without it, W1/W2 still grant uid 0 but no module is loaded.

The execution chain is a pipeline of three components: a frontend (root_child startup/handoff), a backend (the CVE-2026-43499 futex primitive), and a middleware route. The catalogued combinations are instantiated at build time; the resolved profile selects which one runs. The route races two cores: on the 6.6/6.12 tree-waiter kernels the main thread hammers select while a consumer thread perturbs the waiter's priority; on the 6.1 compact-waiter kernels it drives getsockopt(TCP_ZEROCOPY_RECEIVE) through a punched-hole page; the 5.15 kernels use the multicast waiter. The CPU pair also comes from the resolved profile.

Command-Line Debugging

adb/shell has no seccomp filter, so W3 is skipped - handy for quick verification:

make -C src ghostlock
./gradlew exportKernelProfiles
adb push build/native/ghostlock /data/local/tmp/ghostlock
adb push build/kernel-profiles/<release>.bin /data/local/tmp/profile.bin
adb shell chmod 755 /data/local/tmp/ghostlock
adb shell /data/local/tmp/ghostlock --load-prebuilt-profile /data/local/tmp/profile.bin

Offset Extraction

tools/extract_rs derives offsets from a boot.img (plus optional xbl_config.img), a full OTA ZIP, or an http(s) URL pointing at one. kallsyms come from --kallsyms or are recovered from the image's embedded table. pselect_waiter_shift and off_slide_loggers_0_1 are derived by the built-in arm64 disassembler. MediaTek images have no xbl_config.img and usually no BTF: the physical load address is derived from kallsyms _text (override with --phys).

Push-Location tools/extract_rs
cargo build --release
Pop-Location
build/extract/release/ghostlock-extract.exe boot.img --xbl-config xbl_config.img --format conf --out profile.conf
build/extract/release/ghostlock-extract.exe OTA.zip --format conf --out profile.conf

--format conf is the extractor output: a flattened, self-contained profile (no include lines, the shared 6.x credential/KernelSnitch constants inlined, the route selected from --analysis evidence unless --route overrides it). The extractor emits every field the image actually yields and omits the rest; it never fills gaps from a neighbouring kernel family's guesses (unverified-family 6.6, the default -2, the 5.15 multicast constants, or a phys default). Every output is an unverified candidate: importable and parseable, with missing or invalid fields blocked by the app's pre-execution validation, so a successful run never implies device support. On 5.x it also derives the credential reference repair from init_cred and the multicast geometry from BTF (see docs/analysis/extractor-5x-derivation-plan.md). --format json stays for the v1 import path. To add a built-in profile, complete and validate the matching version-family template, save it as a standalone .conf profile, and add it to kernel_profiles/index.conf. The old C offsets.h registry is deprecated and removed.

MediaTek

MediaTek images have no xbl_config.img and usually no embedded BTF, so the extractor cannot derive the two physical addresses (kernel_phys_load, kernel_phys_offset) from the image and leaves them null. The runtime then falls back to the SoC formula, which fails at W1 on MediaTek. Fill both by running the separate tools/mtk-phys/ extractor on a rooted device (it reads /proc/iomem) and pasting the values into the app's advanced overrides. See MEDIATEK.md.

Preflight

The extractor disassembles remove_waiter() before extracting offsets. Kernels with the fix are rejected with exit code 6; only vulnerable kernels continue.

On-device analysis

A full OTA can be analyzed entirely on the phone: boot plus xbl_config are extracted automatically. Pass --work-dir an app-writable dir when running inside the app sandbox. Cross-compile and push:

rustup target add aarch64-linux-android
$ndk = "$env:ANDROID_HOME\ndk\<version>\toolchains\llvm\prebuilt\windows-x86_64\bin"
$env:CC_aarch64_linux_android = "$ndk\aarch64-linux-android35-clang.cmd"
$env:AR_aarch64_linux_android = "$ndk\llvm-ar.exe"
$env:CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER = $env:CC_aarch64_linux_android
Push-Location tools/extract_rs
cargo build --release --target aarch64-linux-android
Pop-Location
adb push build/extract/aarch64-linux-android/release/ghostlock-extract /data/local/tmp/
adb shell /data/local/tmp/ghostlock-extract /sdcard/OTA.zip

Importing offsets without rebuilding the app

New kernels no longer need an app rebuild: tap Import offsets.conf (HOCON) and pick the extractor's flattened .conf, or use Import offsets.json (v1) for an older JSON report. v1 JSON is converted in-app, so nothing has to be pushed to the device: native always starts from the GLK1 document the app sends on stdin, and matches the current uname -r against the resolved profile before rejecting the kernel. Imports merge across files; a release already stored prompts before overwrite.

The app can also generate the profile itself — Parse OTA link (full OTA ZIP URL) and Parse image (boot.img + optional xbl_config.img) run the extractor in-process and write a flattened .conf into the app data dir on success:

# GhostLock kernel profile: 6.12.38-android16-5-g844001fb8721-ab14552068-4k (HOCON, self-contained).
release = "6.12.38-android16-5-g844001fb8721-ab14552068-4k"
schema_version = 1
kernel_major = 6
recommend_shizuku = 0
kernel_phys_load = 0xC7800000
route {
  select_stack {
    waiter_shift = 0
  }
}
fallback {
  to = "none"
}
kernelsnitch {
  collisions = 4
}
task_struct {
  prio = 148
  cred = 2304
}
cred {
  caps_offset = 48
  copy_size = 136
  usage_value = 1
  caps_count = 5
  caps_value = -1
}
offset {
  init_task = 37801728
  init_cred = 37891184
}

Credits & License

Based on the following projects, licensed under Apache License 2.0 (see LICENSE):

tiann/KernelSU

A Kernel based root solution for Android

https://kernelsu.org

KernelSU

A kernel-based root solution for Android devices.

Features

Kernel-based su and root access management.
Module system based on metamodules: Pluggable infrastructure for systemless modifications.
App Profile: Lock up the root power in a cage.

Compatibility state

KernelSU officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also supported, but the kernel will need to be built manually.

With this, WSA, ChromeOS, and container-based Android are all supported.

Currently, the arm64-v8a and x86_64 architectures are supported.

Caution

Recent kernel versions have implemented a breaking change causing KernelSU to fail and potentially trigger a kernel panic on x86_64! Check the website for more info!

Usage

Translation

To help translate KernelSU, we no longer accept translation contributions via Weblate. All translations are now handled using LLMs.

If you would like to add support for a new language, feel free to open a PR. Please note that modifications to existing English and Chinese translations are not accepted.

Discussion

Telegram: @KernelSU

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

Files under the kernel directory are GPL-2.0-only.
All other parts except the kernel directory are GPL-3.0-or-later.

Credits

Kernel-Assisted Superuser: The KernelSU idea.
Magisk: The powerful root tool.
genuine: APK v2 signature validation.
Diamorphine: Some rootkit skills.

gkd-kit/gkd

基于无障碍，高级选择器，订阅规则的自定义屏幕点击安卓应用 | An Android APP with custom screen tapping based on Accessibility, Advanced Selectors, and Subscription Rules

https://gkd.li

gkd

基于高级选择器 + 订阅规则 + 快照审查的自定义屏幕点击 Android 应用

通过自定义规则，在指定界面，满足指定条件(如屏幕上存在特定文字)时，点击特定的节点或位置或执行其他操作

快捷操作

帮助你简化一些重复的流程, 如某些软件自动确认电脑登录
跳过流程

某些软件可能在启动时存在一些烦人的流程, 这个软件可以帮助你点击跳过这个流程

免责声明

本项目遵循 GPL-3.0-only 开源，项目仅供学习交流，禁止用于商业或非法用途

安装

如遇问题请先查看疑难解答

截图

选择器

一个类似 CSS 选择器的选择器, 能联系节点上下文信息, 更容易也更精确找到目标节点

https://gkd.li/guide/selector

@[vid="menu"] < [vid="menu_container"] - [vid="dot_text_layout"] > [text^="广告"]

示例图片 - 选择器路径视图 (点击展开)

开发

衍生

开发过程中的衍生项目，它们正在被 gkd 使用，也许对你有帮助

捐赠

如果 GKD 对你有用, 可以通过以下链接支持该项目

https://github.com/lisonge/sponsor

或前往 Google Play 给个好评

KernelSU-Next/KernelSU-Next

An advanced Kernel based root solution for Android

https://kernelsu-next.github.io/webpage/

KernelSU Next

A kernel-based root solution for Android devices.

🚀 Features

Kernel-based su and root access management.
Module system based on Magic Mount and OverlayFS.
App Profile: Limit root privileges per app.

✅ Compatibility

KernelSU Next supports Android kernels from 4.4 up to 6.12.

Kernel version	Support notes
5.10+ (GKI 2.0)	Supports pre-built images and LKM/KMI
4.19 – 5.4 (GKI 1.0)	Requires KernelSU driver built-in
< 4.14 (EOL)	Requires KernelSU driver (3.18+ is experimental and may need backports)

Supported architectures: arm64-v8a, armeabi-v7a and x86_64

Caution

Recent kernel versions have implemented a breaking change causing KernelSU Next to fail and potentially trigger a kernel panic on x86_64! Check the website for more info!

📦 Installation

Please refer to the Installation guide for setup instructions.

🏅 Contribution

Go to our Crowdin to submit a translation for the manager!
To report security issues, please see SECURITY.md.

📜 License

/kernel directory: GPL-2.0-only.
All other files: GPL-3.0-or-later.

💸 Donations

If you'd like to support the project:

USDT (BEP20, ERC20): 0x0b269716dc00692676e4217e23c7f67abd5f0f3e
USDT (TRC20): TXu6VX8dvJLQPx4WBobjbYT5tefHTDikWo
LTC: LMYRqRXPKAFpYncBhNS44W1iwFit14LH1u

🙏 Credits

Kernel-Assisted Superuser – Concept inspiration
Magisk – Core root implementation
Genuine – APK v2 signature validation
Diamorphine – Rootkit techniques
KernelSU – The original base that made KernelSU Next possible
Magic Mount Port – For Magic Mount support

open-ani/animeko

集找番、追番、看番的一站式弹幕追番平台，云收藏同步 (Bangumi)，离线缓存，BitTorrent，弹幕云过滤。100% Kotlin/Compose Multiplatform

https://animeko.org

正式版	测试版	讨论群

Animeko 支持云同步观看记录 (Bangumi)、多视频数据源、缓存、弹幕、以及更多功能，提供尽可能简单且舒适的追番体验。

Animeko 曾用名 Ani，现在也简称 Ani。

立即下载

https://github.com/user-attachments/assets/e63636c9-30b7-411c-aa6b-e5b78b900726

主要功能

浏览来自 Bangumi 的番剧信息以及社区评价

丰富的检索方式：新番时间表、标签搜索

由 Bangumi 和 Animeko 服务端共同提供的精确新番时间表

云同步追番进度

省心的追番进度管理，看完视频自动更新进度
打开 APP 立即继续观看，无需回想上次看到了哪

聚合数据源

聚合视频数据源，全自动选择

还支持 BitTorrent、Jellyfin、Emby、以及自定义源
聚合全网弹幕源（弹弹play），以及 Animeko 自己的弹幕服务

离线缓存

所有数据源都能缓存

精美界面

适配平板和大屏设备

下载

Animeko 支持所有主流平台：Android、iOS、Windows、macOS、Linux。

稳定版本: 功能稳定
下载稳定版本

通常建议使用稳定版本. 如果你愿意参与测试并拥有一定的对 bug 的处理能力, 也欢迎使用测试版本更快体验新功能. 具体版本类型可查看下方.

测试版本: 体验最新功能
下载测试版本

技术总览

如果你是开发者，我们总是欢迎你提交 PR 参与开发！以下几点可以给你一个技术上的大概了解。

Kotlin 多平台架构；
使用新一代响应式 UI 框架 Compose Multiplatform 构建 UI；
内置专为 Animeko 打造的“基于 libtorrent 的 BitTorrent 引擎，优化边下边播的体验；
高性能弹幕引擎，公益弹幕服务器 + 网络弹幕源；
适配多平台的视频播放器，Android 底层为 ExoPlayer，PC 底层为 VLC；
多类型数据源适配，内置动漫花园、Mikan，拥有强大的自定义数据源编辑器和自动数据源选择器。

参与开发

欢迎你提交 PR 参与开发，有关项目技术细节请参考 CONTRIBUTING。

FAQ

资源来源是什么?

全部视频数据都来自网络, Animeko 本身不存储任何视频数据。 Animeko 支持两大数据源类型：BT 和在线。BT 源即为公共 BitTorrent P2P 网络，每个在 BT 网络上的人都可分享自己拥有的资源供他人下载。在线源即为其他视频资源网站分享的内容，目前使用 creamycake ani-subs。Animeko 本身并不提供任何视频资源。

本着互助精神，使用 BT 源时 Animeko 会自动做种 (分享数据)。 BT 指纹为 -AL4123-，其中 4123 为版本号 4.12.3；UA 为类似 ani_libtorrent/4.12.3。

弹幕来源是什么?

Animeko 拥有自己的公益弹幕服务器，在 Animeko 应用内发送的弹幕将会发送到弹幕服务器上。每条弹幕都会以 Bangumi 用户名绑定以防滥用（并考虑未来增加举报和屏蔽功能）。

Animeko 还会从弹弹play获取关联弹幕，弹弹play还会从其他弹幕平台例如哔哩哔哩港澳台和巴哈姆特获取弹幕。番剧每集可拥有几十到几千条不等的弹幕量。

thejaustin/ShizukuPlus

An enhanced fork of Shizuku — adds Root/ADB/Dhizuku unification, a Plus API suite, and OneUI/Android 16+ compatibility fixes, while staying fully compatible with existing Shizuku apps.

https://github.com/thejaustin/ShizukuPlus/wiki

Shizuku+

The advanced privileged-process manager for Android.

An enhanced version of Shizuku built on top of thedjchi/Shizuku, with quality-of-life improvements, backported optimizations, and exclusive Plus APIs.

Shizuku lets normal apps use system-level APIs directly via a privileged process started with adb or root. Shizuku+ keeps full compatibility while adding features for power users and developers.

🌐 Languages: English · Simplified Chinese

Contributors welcome! If you've found a bug or want to improve the codebase, please open an issue or pull request — the project is actively looking for contributors and collaborators.

⬇️ Download

Get the latest release from GitHub Releases — see the release notes there for what's changed recently.

✨ Shizuku+ Core Features

Universal Privilege Provider: One interface for Root, ADB Shell, and Dhizuku (Device Owner).
OneUI 8+ Theming Fix: Lets theming engines like Hex Installer or Substratum keep working on Android 16/17 and OneUI 8+.
Dhizuku Mode: Share the system Device Owner binder with any app that has Shizuku permissions — set up via ADB, no root needed.
Customizable Gestures: Swipe left, swipe right, and long-press actions, configurable per app.
In-App Changelogs: See what's new after an update without leaving the app.
Bulk Management: Multi-select apps to grant/revoke permissions or hide them in one tap.
Activity Log: Audit trail of API calls and su bridge commands, with app icons and real-time updates.
Root Compatibility Hub: Dashboard for legacy root apps, with granular module control (Magisk mocking, auto-grant, file interceptor, and more).
Universal SU Automation: One-tap 'Magic Setup' to point all installed root apps at the Shizuku+ SU Bridge.
Service Doctor: Diagnoses and fixes service startup issues (Samsung Auto Blocker included).
Integrated Feature Guides: Every Plus feature has an info icon with a plain-language explanation of what it does.
Quick Settings Tile: Check and toggle the service status from your notification panel.

🚀 Plus API Features

Shizuku+ provides exclusive system interfaces for advanced automation and tools — none of these exist in stock Shizuku:

AICore+ Automation Bridge: Privileged UI automation (hierarchy dumps, tap/swipe) for AI-driven tools — no root needed. (added)
AVF (Virtual Machine) Manager: Run isolated Linux/Microdroid VMs with GPU acceleration. (added)
Privileged Storage Proxy: Authenticated access to restricted paths for backups and file management. /data/app/ and external /Android/data/ work in ADB mode; /data/data/ requires root (the server must run as UID 0 to cross app-private directory boundaries). (added)
Device Spoofing (Spoof Device Identity in Settings): Present a different device identity to bypass device-specific restrictions. (added)
Intelligence Bridge (AI Core Plus): Privileged NPU scheduling and screen context intelligence. (added)
Window Manager Plus: Force free-form resizing, manage the Bubble Bar, and resilient overlays. (added)
System Theming Bridge (Overlay Manager Plus): Privileged overlay management for rootless theming (e.g. Hex Installer). (added)
Network & DNS Governor: Manage Private DNS and firewall routing for rootless ad-blockers. (added)
Deep Process Control (Activity Manager Plus): Lets process managers kill apps and set standby buckets more aggressively. (added)
Continuity Bridge: Secure state and task handoff between Shizuku+ devices. (added)

See the Shizuku+-API repository for full documentation and client bindings.

🛠️ Backporting & Optimizations

Shizuku+ makes regular Shizuku apps faster and more compatible without any code changes:

Transparent Shell Interceptor: Routes common pm, am, and settings commands through faster native APIs.
Local ADB Proxy: Emulates an ADB server on port 15555, so legacy apps can use Shizuku without Wireless ADB staying on.
SU Bridge: A Shizuku-backed su drop-in for non-rooted apps that support a custom root path. Common root commands are translated into real framework operations where shell UID allows it — iptables --uid-owner per-app blocks become live NetworkPolicy restrictions, resetprop reads/writes real system properties, and chmod/chown apply for real — falling back to mocked success only when an operation genuinely requires root (e.g. flashing partitions or loading kernel modules).
plus CLI Helper: A privileged command-line utility, available inside rish.
Dynamic App Database: Keeps app descriptions and suggestions in the UI up-to-date from GitHub.

⚙️ Modular Control

Everything in Shizuku+ is optional. Use the Plus Features category in Settings to toggle:

Transparent Shell Interception
Individual Plus APIs (AVF, Storage, Intelligence, etc.)
Home screen card visibility
Activity Logging

🔌 Third-Party App Compatibility

Shizuku+ installs under its own package (af.shizuku.plus.api) so it can coexist with stock Shizuku. Because most Shizuku-aware apps look specifically for the moe.shizuku.privileged.api package, Shizuku+ ships a lightweight Compat Hub — a tiny companion app that registers that package name and forwards binder/permission requests to Shizuku+.

If third-party apps don't detect Shizuku+:

Start the Shizuku+ service (ADB or root).
On the home screen, use the Compat Hub card to install the companion (it's bundled in the app; installation goes through the running service, so start the service first).
Re-open the third-party app — it should now detect Shizuku and receive the service binder.

Alternatively, install the drop-in build, which registers as moe.shizuku.privileged.api directly (do not install it alongside stock Shizuku).

☑️ Requirements

Minimum: Android 7+ · Fully supported through Android 17 (SDK 37)

Root mode: Requires a rooted device
Wireless Debugging mode: Android 11+ and all Android TVs
PC mode: All devices
Start on boot: Available only with Wireless Debugging or Root mode

On Android 16+, Shizuku+ requests the new Local Network Protection permissions so wireless-debugging discovery and pairing keep working; on Android 17, it transparently handles the hidden-API deviceId change so authorized apps still appear and permission grants still apply.

📃 License

Apache 2.0

🙏 Acknowledgements & Upstream Projects

Shizuku+ is a community-driven enhancement and fork of thedjchi/Shizuku, which is itself a fork of the original RikkaApps/Shizuku. This project is not affiliated with the original RikkaApps team.

Thanks to the following upstream contributors and projects whose work makes Shizuku+ possible:

RikkaApps / Rikka — For the foundational Shizuku project and its elegant API design.
thedjchi — For the intermediate fork and quality-of-life improvements, and for carrying the Android 17 (SDK 37) compatibility work that Shizuku+'s A17 support is adapted from.
kerneldroid / Nightzuku — Origin of the Android 17 hidden-API deviceId compatibility approach (the Android17Compat / InstalledPackagesCompat reflection layer) and Local Network Protection handling that this fork's A17 support descends from.
LandonMoran — For porting Nightzuku's Android 17 support into the thedjchi fork and verifying it end-to-end on a physical Android 17 device (pairing, service start, and the authorized-apps list), which is the field validation Shizuku+'s port builds on.
Muntashir Akon — For the aShell You codebase, which inspired the terminal and shell automation features.
iamr0s — For Dhizuku, enabling the unified Device Owner privilege mode, and AndroidAppProcess for standalone Java process execution.
pascua28 — For native Samsung System UID 1000 escalation integration.
kerneldroid — For the Nightzuku fork, which inspired our Android 16/17 (SDK 37) hidden API resilience (handling deviceId) and UI modernizations.
ShizukuExt-SystemUID — For conceptualizing systemic UID 1000 privilege escalation beyond standard limits.

Upstream Projects

Project	Author	License	Role
Shizuku	RikkaApps / Rikka	Apache 2.0	Foundational privileged-process architecture
Shizuku (fork)	thedjchi	Apache 2.0	Intermediate fork with QoL improvements; carried the Android 17 compat work Shizuku+ adapted
Nightzuku	kerneldroid	Apache 2.0	Origin of the Android 17 hidden-API `deviceId` + Local Network Protection compatibility approach
Shizuku (fork)	pascua28	Apache 2.0	Samsung UID 1000 system execution exploit
Nightzuku	kerneldroid	Apache 2.0	Android 16/17 API resilience & UI modernizations
ShizukuExt-SystemUID	ShizukuExt Team	Apache 2.0	System UID privilege escalation concepts
Dhizuku	iamr0s	Apache 2.0	Device Owner binder sharing (Dhizuku Mode)
AndroidAppProcess	iamr0s	LGPL-3.0	Standalone high-privileged Java process wrapper

Open Source Libraries

Library	Author	License
AndroidX Jetpack	Google / AOSP	Apache 2.0
Material Components	Google	Apache 2.0
Material Symbols	Google	Apache 2.0
Kotlin / Coroutines / Serialization	JetBrains	Apache 2.0
RikkaX Libraries (appcompat, material, insets, html, recyclerview, preference, lifecycle, parcelablelist)	Rikka	Apache 2.0
Hidden API / Refine	Rikka	Apache 2.0
Mavericks (MvRx)	Airbnb	Apache 2.0
Lottie	Airbnb	Apache 2.0
Coil	Coil Contributors	Apache 2.0
Koin	Koin Contributors	Apache 2.0
Timber	Jake Wharton	Apache 2.0
libsu	topjohnwu	Apache 2.0
AndroidHiddenApiBypass	LSPosed	Apache 2.0
libcxx	LSPosed / LLVM	Apache 2.0 + LLVM Exception
AppIconLoader	Zhang Hai	Apache 2.0
BoringSSL (NDK)	vvb2060 / Google	Apache 2.0 / ISC
Gson	Google	Apache 2.0
LeakCanary	Square	Apache 2.0
AboutLibraries	Mike Penz	Apache 2.0
Bouncy Castle	Legion of Bouncy Castle	MIT
Sentry Android SDK	Sentry	MIT
SQLite (C Recovery API / CLI)	D. Richard Hipp / SQLite Consortium	Public Domain

Full license texts and per-library details: OPEN_SOURCE_LICENSES.md | NOTICE

👥 Contributors

Code Contributors

Contributor	Contribution
thejaustin	Project founder & primary maintainer — all core Plus features, UI/UX, and infrastructure
thedjchi	Intermediate fork base; Android 17 (SDK 37) compatibility groundwork
Kevin Doremy	Dead code removal, unused import cleanup, layout & class refactoring
Ryfter	mDNS timeout improvements, FGS subtype refactoring, notification UX
vvb2060	AGP build system updates, LTO optimization, license clarifications
Haruue Icymoon	Documentation & README improvements

Translation Contributors

Language	Contributor
Brazilian Portuguese	odorizzioficial
French	Ryfter, T. Clement
Vietnamese	ThePrimalPea
Filipino	IverCoder
Italian	Dany-coder778
Japanese	MES-mitutti

Plus many more via community translation through Weblate — thank you to all translators!

Acknowledgments

Special thanks to AkayamiShurui42 for the proactive security research and stability patches (Reference: #239).
Thank you to AlexeiCrystal for identifying MIUI crash bugs and suggesting the Compat Hub workaround for legacy apps (#241, #242).
Thank you to ddnexus and kai-bash for highlighting the Device Owner factory reset trap and Google Backup conflicts (#237).
Thank you to Kevinco1 for feedback on root compat app detection issues (#243).
Thank you to aragortsantiago6-beep and Scoop2389 (Pixel 9a) and ConversionRituals (Xiaomi) for on-device Android 16/17 testing, crash reports, and logs that drove the SDK 37 hidden-API and Local Network Protection compatibility fixes (#317, #323).
Thank you to gmm96 for extensive multi-round logcat debugging across several builds that pinned down the Cached Apps Freezer binder-delivery bug (#371).
Thank you to odorizzioficial for the complete Brazilian Portuguese translation (#409), and for the detailed report on the Samsung "Sleeping apps" Watchdog freeze (#415).

maxrave-dev/SimpMusic

A cross-platform music app using YouTube Music for backend

https://simpmusic.org/

SimpMusic

A FOSS YouTube Music client for Android and Desktop with many features from
Spotify, SponsorBlock, ReturnYouTubeDislike using Compose Multiplatform to develop.

Download

_{On vivo phones, install SimpMusic-full-vivo-*.apk from Releases for Origin Island and the music widget. It installs as a separate app and can't sit next to Spotify.}

Nightly Build

SimpMusic is available on Desktop now!

kotlin-footguns — the Kotlin, Compose Multiplatform and desktop JVM traps this project ran into the hard way. Star it if it saves you a night.

Features ✨️

Play music from YouTube Music or YouTube for free, without ads and in the background
Three Now Playing styles: Classic, Material 3 Expressive and a redesigned Apple Music player with Apple Music-style lyrics (NEW)
Ten-band equalizer with presets and AutoEq headphone profiles, plus Delay and Reverb effects, or your phone's system equalizer on Android (NEW)
Pick the speaker, headphones or Cast device SimpMusic plays on, without moving other apps' audio (NEW)
SimpMusic Wrapped: your year in music, plus monthly recap playlists (NEW)
On-device listening analytics: charts, period history, listening clock and a shareable listening receipt (NEW)
Word-by-word Apple Music-style lyrics, romanization for 12 languages, share lyrics as an image, landscape fullscreen lyrics and a timing offset (NEW)
Home screen widgets: turntable, playlists and listening insights (NEW)
Send your sign-ins from Android to Desktop by scanning a QR code (NEW)
Preferred audio language for videos with several audio tracks (NEW)
High quality up-to 256kbps stream (Opus or AAC) for YouTube Music Premium users
Browsing Home, Charts, Podcast, Moods & Genre with YouTube Music data at high speed
Search everything on YouTube
Spotify Canvas and Animated Album Art supported (NEW)
Power your experience with SimpMusic Chart (https://chart.simpmusic.org/)
Play 1080p video option with subtitle
Play YouTube Music live stations (NEW)
AI song suggestions and an AI reading of your music taste (NEW)
Import playlists converted from Spotify and other apps
Customize your playlist, synced with YouTube Music
Notifications from followed artists
Caching and offline playback support
Crossfade with DJ-style like Apple Music
Customizing THEME (Light, Dark, Color, etc)
Synced lyrics from SimpMusic Lyrics, LRCLIB, Spotify (require login) and YouTube Transcript - AI lyrics translation (BETA) (*)
Personalize data (**) and multi-YouTube-account support
Last.fm scrobbling (Full version)
Supports SponsorBlock and Return YouTube Dislike
Sleep Timer
Android Auto with online content, feature rich UI/UX
Discord Rich Presence support
Listen Together: shared rooms that play in sync with friends, compatible with Metrolist (NEW)
And many more!

(*) Use your OpenAI or Gemini API key
(**) For users who chose "Send back to Google" feature

Warning
This app is in the beta stage, so it may have many bugs and make it crash. If you find any bugs,
please create an issue or contact me via email or Discord server.
Because of depending on YouTube Music, the player error will happen and it's normally, please don't ask me about the stable state of this app.

Screenshots

More screenshots here.

Data

This app uses hidden API from YouTube Music with some tricks to get data from YouTube Music.
Use Spotify Web API and some tricks to get Spotify Canvas and Lyrics
Thanks to InnerTune for the idea to get data from YouTube Music. This repo is my inspiration to create this app.
Special thanks to SmartTube. This repo help me to extract the streaming URL of YouTube Music.
My app is using SponsorBlock to skip sponsor in YouTube videos.
ReturnYouTubeDislike for getting information on votes
Main lyrics data from SimpMusic Lyrics
Alternative lyrics data from LRCLIB. More information LRCLIB

Privacy

SimpMusic doesn't have any tracker or third-party server for collecting user data in FOSS version. If YouTube
logged-in users enable "Send back to Google" feature, SimpMusic only uses YouTube Music Tracking API to send listening history and listening record of video to Google for better recommendations and
supporting artist or YouTube Creator (For API reference,
see this).

We collect crash data in the Full version to improve the app.

Full or FOSS version

I use Sentry crashlytics to catch all crashes in the Full version. Sentry is the open-source project. If you don't want to be collected crash data, you must use FOSS version.

Desktop app

Which file should I download?

For Windows: Download SimpMusic-Windows-installer.zip, unzip it and run install.bat.
For macOS (macOS 15 or newer): Download the file with extension .dmg.
For Linux: Download the file with extension .AppImage (all Linux distributions)

Log in guide: https://www.simpmusic.org/blogs/en/how-to-log-in-on-desktop-app

Discord login guide: https://gist.github.com/MarvNC/e601f3603df22f36ebd3102c501116c6

Some limitations on Desktop app:

Some Linux distributions may have stability issues (upstream JetBrains issue).
ARM64 on Windows and Linux: use the x64 build.

Please report issues on our Discord server if you find any bugs.

Translation

You can help me translate this app into your language by using Crowdin SimpMusic on Crowdin

Special thanks to all translators on Crowdin ❤️

FAQ

1. Wrong Lyrics?

Lyrics are provided by LRCLIB and other sources. Sometimes lyrics may not match perfectly with the YouTube videoId parameter. So I need to use some "String Matcher" and "Duration" to search lyrics. So sometimes, some songs or videos get the wrong lyrics.

2. Why the name or brand is "SimpMusic"?

Simply, because I love the name. It's a combination of 'Simple' and 'Music'. But SimpMusic is not a simple app, it's all you need for a powerful music streaming app.

More FAQ, join my Discord channel

Contributing

Contributions are welcome — the full guide lives in CONTRIBUTING.md. The short version:

Start from an issue. Every PR needs an accepted issue behind it — open one first so the change is agreed before the code exists.
Fork and branch from dev (main tracks releases), and fill in the whole PR template — one checkbox is machine-checked.
AI policy. AI-assisted work is welcome; AI-driven work is not:
- A human must have written or personally reviewed every line and be able to answer review comments about it.
- Unattended agent submissions (Jules, Devin, and friends) are closed automatically by the triage bot, on sight.
- Commits carrying AI co-author trailers (Co-Authored-By: Claude/Copilot/…) or "Generated with …" markers are rejected the same way — squash them out first.
- Repeat offenders are blocked.
Translations go through Crowdin, never PRs editing the string files directly.

Legal Disclaimer & Terms of Use

1. 100% Free, Open-Source & Strictly Non-Commercial

SimpMusic is a fully open-source project (FOSS) created purely for educational purposes and personal use. We do not sell this application, nor do we monetize it in any way. There are no advertisements, no premium features, no subscriptions, and no hidden fees within the app. This project has absolutely no commercial value or financial intent.

2. A Custom Browser with Content Filtering

SimpMusic acts strictly as a specialized, third-party web browser and client. It simply parses the publicly available website content and APIs of YouTube and YouTube Music, rendering them in a custom user interface. The ad-free experience it provides is fundamentally no different from using a standard web browser (like Chrome, Firefox, or Brave) equipped with a common ad-blocking extension (such as uBlock Origin).

3. Support Content Creators

We deeply respect the hard work of artists, musicians, and content creators. We strongly encourage all users to subscribe to YouTube Premium. Purchasing a Premium subscription is the best way to financially support the creators you listen to and ensure the continued growth of the platform. SimpMusic is built as a proof-of-concept for developers and enthusiasts, not to harm creators' revenues.

4. No Hosting of Copyrighted Material

We do not host, upload, distribute, or store any audio, video, or copyrighted media files on our own servers. All content accessed through this application is stored entirely on Google's/YouTube's servers and remains the property of their respective copyright owners. The app merely acts as a conduit to stream publicly accessible links.

5. User Responsibility & Legal Contact

The software is provided "AS IS", without warranty of any kind. The developers of SimpMusic do not encourage or condone piracy. Users are solely responsible for ensuring their usage of this app complies with their local copyright laws and the Terms of Service of the platforms they access.

Because we do not host any media files, we cannot process DMCA takedown requests for audio or video content. However, if you represent a copyright holder or have legal concerns regarding the open-source code itself, please contact us via email at: ndtminh2608@gmail.com

Contribute

We're looking for more contributors, all contributions are welcome! See our CODE OF CONDUCT

Thanks for all my contributors:

Showcase

This project is following clean architecture and MVVM pattern (in UI, app module).

Dependencies graph

Support & Donations

Special thanks to all supporter ❤️

MOMO or Vietnamese banking

SimpMusic is sponsored by:

Crowdin and Sentry both have a free enterprise plan for Open-source projects. Follow the URLs:

Past sponsored:

Check out the Vercel open-source program:

https://vercel.com/open-source-program

This project is tested with BrowserStack

Checkout BrowserStack now: https://www.browserstack.com/

This project is a part of SimpMusic.org Open-source project by me maxrave-dev

deniscerri/ytdlnis

Full-featured audio/video downloader for Android using yt-dlp

https://ytdlnis.org

YTDLnis

YTDLnis is a free and open source video/audio downloader using yt-dlp for Android 7.0 and above.

Created by Denis Çerri

Only the links above are the only trusted sources of YTDLnis. Everything else is not related to me.

💡 Features:

Download audio/video files from more than 1000 websites
Process playlists
- Edit every playlist item separately just like in a normal download item
- Select a common format for all items and/or select multiple audio formats in case you are downloading them as a video
- Select a download path for all items
- Select a filename template for all items
- Batch update download type to audio/video/custom command in one click
Queue downloads and schedule them by date and time
- You can also schedule multiple items at the same time
Download multiple items at the same time
Use custom commands and templates or use yt-dlp with the built-in terminal
- You can backup and restore templates so you can share them with your buddies
Supports cookies. Log in with your accounts and download private/unavailable videos, unlock premium formats etc.
Cut videos based on timestamps and video chapters (experimental yt-dlp feature)
- You can make unlimited cuts
Remove SponsorBlock elements from downloaded items
- Embed them as a chapters in your video
Embed subtitles/metadata/chapters etc
Modify metadata such as title and author
Split item into separate files depending on its chapters
Select different download formats
Bottom card right from the share menu, no need to open the app
- You can create a txt file and fill it with links/playlists/search queries separate by a new line and the app will process them
Search or insert a link from the app
- You can stack searches so you can process them at the same time
Log downloads in case of problems
Re-download cancelled or failed downloads
- You can use gestures to swipe left to redownload and right to delete
- You can long click the redownload button in the details sheet to show the download card for more functionality
Incognito mode when you don't want to save a download history or logs
Quick download mode
- Download immediately without having to wait for data to process. Turn off the bottom card and it will instantly start
Open / share downloaded files right from the finished notification
Most yt-dlp features are implemented, suggestions are welcome
Material You interface
Theming options
Backup and restore features
MVVM architecture with WorkManager

🧩 Plugin Support

YTDLnis orchestrates plugins so users can freely upgrade and downgrade components such as:

Python
JS Runtimes (NodeJS, Deno)
FFmpeg
Aria2c

You can install ytdlnis packages from this repository ytdlnis-packages or through the updating section in the application.
For more information refer to the repo's README.

📲 Screenshots

💬 Contact

Join our Discord or Telegram channel for announcements, discussion and releases.

😇 Contributing

Please read the contributing section if you would like to contribute.

📝 Help translate on Weblate

🔑 Connect with third-party apps using the package name

The app's package name is "com.deniscerri.ytdl".

🔍 Verify application signature

The app should contain the signature below. The github workflow action uses it, and the releases are based on it to make it a reproducible build. If the signature is different, your third party distributor has modified the application. Please use the app with the original signature.

Signer #1 certificate DN: CN=Denis Cerri, OU=Personal, O=Personal, L=Albania, ST=Albania, C=AL
Signer #1 certificate SHA-256 digest: 263645cb5272eb290759fe1f59149ae24df6ce171e9f6666eead981d3fc64c95
Signer #1 certificate SHA-1 digest: 2fec9c2fcef68d29a60857e185c795fec5f56fb6
Signer #1 certificate MD5 digest: 429d0c6315d2f99650f66cc44cf5a794

🤖 Connect with third-party apps using intents

You can use intents to push commands to the app to run downloads without user interaction. Accepted variables:

TYPE -> it can be: audio,video,command
BACKGROUND -> it can be: true,false. If its true the app won't show the download card no matter what and run the download in the background

An example of downloading an audio item in the background with Tasker

Create Send Intent task
Action: android.intent.action.SEND
Cat: Default
Mime Type: text/*
Extra: android.intent.extra.TEXT:url (instead of "url" write the URL of the video you want to download)
Extra: TYPE:audio
Extra: BACKGROUND:true

📄 License

GNU GPL v3.0

Except for the source code licensed under the GPLv3 license, all other parties are prohibited from using the "YTDLnis" name as a downloader app, and the same is true for its derivatives. Derivatives include but are not limited to forks and unofficial builds.

😁 Donate

🙏 Thanks

decipher3114 for the app's icon
dvd for being an example youtubedl-android implementation
seal for certain design elements and features I wanted to have in this app when I started developing it
youtubedl-android for porting yt-dlp to Android
yt-dlp and its contributors for making this tool possible. Without it this app wouldn't exist

and to a lot of other people, such as contributors.

wangzhishou/OneBox

A free AI agent & toolbox for Android | 一站式安卓 AI 智能体 & 工具箱

https://www.oneboxable.com

OneBox (万宝盒)

English | 简体中文

A free AI agent & toolbox for Android: say what you need and the built-in agent drives 90+ in-app tools to get it done — plus image & document tools, productivity and daily utilities.

Screenshots

Download

International: Google Play · Official site
中国: 万宝盒官网 · 小米 / 应用宝 / OPPO / vivo / 华为应用商店搜索「万宝盒」

AI Assistant: More Than Just Feature Count

Plenty of toolbox apps are long on features. OneBox's built-in AI assistant saves you from hunting for tools and memorizing steps — just say what you want:

"Turn these images into a PDF." "Log this bill screenshot into my ledger." "Make me a to-do list." "Look up today's stock prices online."

It understands, acts, and reports back — in one flow.

Bounded by its own permissions: everything the agent does stays inside the app's own Android sandbox and declared permission set — it never touches contacts, SMS or call logs; local tools run entirely on-device, and only the conversation with your chosen model goes online.
An agent that drives the tools: the AI agent can invoke 90+ in-app local tools (PDF processing, image editing, file management, bookkeeping…), chaining multi-step tasks across tools — executed locally with per-tool timeouts and iteration limits.
Picture-in-picture robot, no more waiting around: long agent task? Just leave the app — with an active AI session it drops into system picture-in-picture, where the mini-window robot keeps you posted on progress and one tap brings you back to the result. Native PiP, zero permissions required.
One chat, many models: talk to multiple mainstream LLMs from a single entry, with custom AI engines and prompt management.
Bring your own key — use it for free: drop in any OpenAI-compatible API key (including free tiers like Gemini or OpenRouter's free models) and the full assistant + agent is yours at zero cost. Custom engines, endpoints and tokens are fully open in the Google Play build and in builds from this repo.
Transparent by source: every line is public — how data is processed locally and what never leaves the device is something you can verify, not a promise you have to trust.

Features

OneBox ships 104 feature modules. Local tools run entirely on-device; only the conversation with your chosen AI model goes online. The tables below list every module — names refer to the feature/* directories in this repo.

AI & Assistant

Module	Feature	Description
`feature/ai`	AI Chat & Agent	Multi-model chat, dual-model duels, prompt execution, and an agent that invokes in-app tools, with token stats
`feature/ai-image`	AI Image	Text-to-image generation, with share / copy / edit
`feature/ai-detect`	AI Detector	Check whether a text or an image is AI-generated
`feature/dsh-client`	DSH Client	Drive a DeepSeek Harness agent on your computer — scan-to-pair, end-to-end encrypted, LAN or cloud relay (computer side: `onebox-dsh-bridge`)
`feature/visual-automation`	Visual Automation	Feed screenshots to a multimodal model for screenshot-based UI automation

Image Viewing & Editing

Module	Feature	Description
`feature/image-viewer`	Image Viewer	Immersive viewer with swipe browsing, double-tap / pinch zoom (up to 5×), online image download
`feature/image-preview`	Image Preview	Preview and manage images; the entry point to edit / crop / filter flows
`feature/single-edit`	Single Edit	All-in-one editor: crop, filters, draw, curves, resize, format & quality, before/after compare
`feature/draw`	Draw	Free-form canvas: pen / neon / highlighter / blur / pixelate / text / stickers / healing, shapes and flood fill
`feature/markup-layers`	Layers	Layer-based creation: add / order / merge / blend / opacity, brushes, text, shapes, export settings
`feature/crop`	Crop	Crop with rotation, free-corner crop, shaped outlines and aspect ratios
`feature/image-stitch`	Image Stitch	Horizontal / vertical / grid stitching with alignment, spacing and fading edges
`feature/image-splitting`	Image Split	Split one image into a rows × columns grid of tiles
`feature/image-stacking`	Image Stacking	Overlay multiple images into a single composite
`feature/image-cutting`	Image Cut	Precise cut by horizontal / vertical start–end percentages, with invert
`feature/compare`	Compare	Side-by-side or overlay diff of two images, slider and pixel-level highlight
`feature/load-net-image`	Net Image Loader	Paste a URL to parse, preview and download images from the page
`feature/pick-color`	Color Picker	Tap / drag to pick pixel colors, with pan and zoom modes
`feature/collage-maker`	Collage Maker	Collages of up to 10 photos with templates, spacing, rounded corners, backgrounds
`feature/text-card`	Text Cards	Turn quotes into beautiful cards with paper backgrounds, layers and AI illustrations

Filters & Effects

Module	Feature	Description
`feature/filters`	Filters	100+ filters (blur, color, artistic, edge, warp) with mask-based partial application
`feature/gradient-maker`	Gradient Maker	Pure / overlay / mesh gradients with configurable color stops
`feature/mesh-gradients`	Mesh Gradients	Browse and download mesh-gradient packs, jump into the editor
`feature/noise-generation`	Noise Textures	Procedural noise via FastNoiseLite (OpenSimplex2 / Perlin / Value…)
`feature/ascii-art`	ASCII Art	Convert images into character-based text art
`feature/color-tools`	Color Tools	Color info (HEX / RGB / HSL), harmonies, shades / gradients, histogram analysis
`feature/palette-tools`	Palette Extract	Extract palettes from images, Material You style, custom palette export

Conversion & Compression

Module	Feature	Description
`feature/format-conversion`	Format Convert	JPEG / PNG / WebP conversion with quality control, EXIF retention, batch processing
`feature/resize-convert`	Resize & Convert	Resize + convert in one pass: width / height / preset / scale modes, batch
`feature/weight-resize`	Compress by Size	Compress to a target file size, with before/after size comparison
`feature/limits-resize`	Limit Resize	Scale within max width / height; skip / re-encode / scale modes
`feature/gif-tools`	GIF Tools	Multi-image GIFs with frame rate, repeat count, size and per-frame preview
`feature/apng-tools`	APNG Tools	Multi-image APNGs with frame delay and repeat count
`feature/webp-tools`	WebP Tools	Multi-image animated WebP with frame delay and repeat count
`feature/svg-maker`	SVG Maker	Convert bitmaps into SVG vector graphics
`feature/zip`	ZIP Archive	Pack images into a ZIP archive

Metadata & Encoding

Module	Feature	Description
`feature/edit-exif`	Edit EXIF	View and modify camera model, capture time, GPS, copyright…
`feature/delete-exif`	Delete EXIF	Batch-strip EXIF for privacy, or add new EXIF data
`feature/base64-tools`	Base64 Tools	Two-way image ↔ Base64 conversion
`feature/checksum-tools`	Checksum Tools	Compute and compare file / text hashes with multiple algorithms

Documents & Text

Module	Feature	Description
`feature/pdf-tools`	PDF Toolbox	Preview, image → PDF, PDF → image, merge, split, compress, rotate, page management
`feature/ocr-document`	OCR	OCR recognition and format conversion with task tracking, preview and export
`feature/document-scanner`	Document Scanner	Scan paper documents into images / PDF
`feature/markdown-edit`	Markdown Editor	WYSIWYG Markdown editing, export to PDF
`feature/code-editor`	Code Editor	Syntax highlighting, file I/O and history

Watermark & ID Photo

Module	Feature	Description
`feature/watermarking`	Watermark	Text / image / steganographic / stamp watermarks with position, rotation, opacity, tiling
`feature/camera-watermark`	Camera Watermark	Stamp photos with time / location / device watermarks
`feature/id-photo`	ID Photo	Standard ID-photo sizes, background replacement, batch export
`feature/wallpapers-export`	Wallpaper Export	Read and save the system and lock-screen wallpapers

Scanning & QR

Module	Feature	Description
`feature/scan-qr-code`	QR Tools	Scan (camera / image) and generate QR & barcodes: text, URL, WiFi, contacts…

Measurement & Utilities

Module	Feature	Description
`feature/unit-converter`	Unit Converter	Length, weight, temperature, area, volume, speed, time and more
`feature/compass`	Compass	Compass & luopan dials with bearings, magnetic declination and calibration hints
`feature/measurement`	Ruler	On-screen ruler and protractor, cm / inch
`feature/altitude`	Altitude	GPS altitude with history
`feature/speed-test`	Speed Test	Download / upload speed with a gauge animation
`feature/calendar`	Calendar	Calendar with Chinese almanac, bazi chart and lunar conversion
`feature/schedule`	Schedule	Events with system-calendar sync and reminders
`feature/teleprompter`	Teleprompter	Script editing + fullscreen playback with speed / font / color controls
`feature/dead-pixel-test`	Dead Pixel Test	Fullscreen solid colors with color switching and grid overlay
`feature/marquee`	Marquee	Fullscreen scrolling text, LED style and subtitle modes
`feature/audio-cover-extractor`	Cover Extractor	Extract album covers from audio files

Security & Encryption

Module	Feature	Description
`feature/cipher`	Image Cipher	Encrypt / decrypt images with passwords
`feature/password-vault`	Password Vault	Local encrypted account & password storage with categories and search

Life & Productivity

Module	Feature	Description
`feature/bookkeeping`	Bookkeeping	Income / expense tracking with charts — the AI can log bills for you
`feature/marktodo`	To-do	Topic-based tasks with tags, priorities, due dates and filters
`feature/habit-tracker`	Habit Tracker	Daily check-ins with reminders, streaks and completion stats
`feature/household-items`	Item Tracker	Track where things are stored, expiry dates and notes; AI can log & query
`feature/period`	Period Tracker	Log periods, flow, symptoms and mood; predicts the next cycle
`feature/record-center`	Health Records	12 metric types (blood pressure, weight, glucose…), trends and AI insights
`feature/loan-calculator`	Loan Calculator	Equal-payment / equal-principal loans: monthly payment, total interest, schedule
`feature/lifetime`	Lifetime	A timeline of life events and milestones
`feature/decision-wheel`	Decision Wheel	Custom random spinner to help you choose
`feature/blessing-wall`	Blessing Wall	Greeting cards with background music and sharing
`feature/poem`	Chinese Poetry	Random poems, keyword search, AI interpretation, history & favorites
`feature/iching-divination`	I Ching	Shake to cast a hexagram, with changing lines and AI interpretation

Games

Module	Feature	Description
`feature/game2048`	2048	The classic sliding-tile merge game
`feature/xiangqi`	Chinese Chess	Vs AI, online play, game library, endgame analysis
`feature/gomoku`	Gomoku	15×15 board, vs LLM, AI battles, game library, review
`feature/chess`	Chess	Full rules (castling / en passant / promotion), vs LLM, game library, review
`feature/minesweeper`	Minesweeper	Multiple difficulties, timer, flags
`feature/sudoku`	Sudoku	Three difficulties, hints, undo, timer, stats
`feature/survive30s`	Survive 30s	Dodge obstacles for 30 seconds
`feature/dice-roller`	Dice Roller	D4 / D6 / D8 / D10 / D12 / D20 dice

Content & Community

Module	Feature	Description
`feature/online`	Discover	Content square aggregating recommended apps, notes and mini-programs
`feature/blog`	Blog & Feedback	Read articles and send feedback
`feature/profile`	Profile	VIP level, data backup & restore, about
`feature/notification`	Notifications	Message center with unread badges
`feature/ad-watch`	Watch & Earn	Watch rewarded ads to earn points, with a daily cap

Files & Transfer

Module	Feature	Description
`feature/file-browser`	File Browser	Directory navigation, search, sort, multi-select operations
`feature/file-transfer`	File Transfer	LAN file transfer with QR pairing and encryption
`feature/cloud-storage`	Cloud Storage	Browse, upload, download and delete cloud files
`feature/media-picker`	Media Picker	Image / video picking shared by the other tools

App Shell & System

Module	Feature	Description
`feature/app`	App Shell	Entry navigation with adaptive layout: drawer + bottom bar in portrait, navigation rail in landscape
`feature/settings`	Settings	AI engines, themes, display, TTS, system prompts and more
`feature/common`	Common	Shared UI base, data sync and category management
`feature/search`	Global Search	Search features, content and messages, with quick navigation
`feature/quick-tiles`	Quick Tiles	Quick-settings tiles: screenshot, color picker, scan…
`feature/webview`	Web Browser	Built-in browser with tabs, bookmarks and history
`feature/login`	Sign In	Auth flows and user agreement
`feature/wechat`	WeChat Integration	WeChat SDK sign-in and payment callbacks
`feature/demo`	Demo	Developer component showcase grid
`feature/libraries-info`	Open-source Licenses	License list of all third-party libraries
`feature/library-details`	License Details	Per-library license details
`feature/boardgame`	Board Game UI Kit	Shared board-game UI scaffolding reused by gomoku / chess

Tech Stack

UI: Jetpack Compose, Material 3
Navigation / components: Decompose (StackNavigation, childStack, retained components)
DI: Hilt
Code generation: KSP
Build conventions: custom Gradle convention plugins in build-logic/convention
Persistence: SQLite / Room (AppDatabase), MMKV (per-module)
Network & images: Retrofit / OkHttp, Coil

Repository Structure

Path	Description
`app/`	Application shell and packaging entry; `AppActivity.kt` is the main Activity
`feature/app/`	Top-level shell, root navigation, global CompositionLocals, screen wiring, adaptive layout
`feature/*`	Business / tool feature modules
`feature/ai/`	AI chat, agent, tool-calling chain, AI image features
`feature/common/`	Shared business logic, AI engine catalog/sync
`feature/settings/`	Settings, themes, AI engine & working-model configuration
`core/*`	Foundation layers: UI, domain, data, database, theme, settings, etc.
`libs/*`	In-project reusable libraries
`build-logic/convention/`	Custom Gradle convention plugins
`web/`	Web frontend source of the file-transfer module (esbuild project)
`fastlane/`	Google Play listing copy & assets (fastlane supply format)

Architecture Entry Points

Paths beginning with com.t8rin.* are inherited from upstream ImageToolbox and left unchanged on purpose, so the diff against upstream stays reviewable. Everything written for this project lives under com.wanbaohe.* / com.shifenmiao.*.

App entry: app/src/main/java/com/shifenmiao/app/AppActivity.kt
Runtime navigation root: feature/app/src/main/java/com/t8rin/imagetoolbox/feature/root/presentation/screenLogic/RootComponent.kt
Route definitions: core/ui/src/main/kotlin/com/t8rin/imagetoolbox/core/ui/utils/navigation/Screen.kt
Child factory wiring: feature/app/.../navigation/ChildProvider.kt
Child composable wrappers: feature/app/.../navigation/NavigationChild.kt
Top-level shell selector: feature/app/src/main/java/com/wanbaohe/app/screen/ScreenSelector.kt
Adaptive navigation layout: feature/app/src/main/java/com/wanbaohe/app/navigation/AdaptiveNavigationLayout.kt

Building from Source

Requirements

Use the bundled Gradle Wrapper 9.7.0
JDK 17 (build-logic and CI target it)
Android targets: Compile SDK 37 / Target SDK 37 / Min SDK 24
Toolchain: Kotlin 2.4.0 / AGP 9.3.1
When in doubt, gradle/libs.versions.toml and gradle/wrapper/gradle-wrapper.properties are the source of truth

Clone

The repository carries a lot of binary assets, so a full clone is large. For building, a shallow clone is enough:

git clone --depth=1 https://github.com/wangzhishou/OneBox.git

Common Commands

./gradlew :app:assembleGoogleArm64Debug       # single-variant debug APK (google = default channel)
./gradlew tasks --group=assemble              # list all assemble tasks
./gradlew :app:tasks

Variants

The app module uses two flavor dimensions:

app: xiaomi / yyb / oppo / vivo / huawei / onebox / google / foss (foss is the fully-FOSS build: no GMS, Firebase, WeChat or Alipay SDKs; this is the variant CI verifies)
abi: arm64 (64-bit only)

Build and verify with the google (overseas / Play) flavor by default; pick a domestic flavor only when it is actually needed. Task names combine the two dimensions, e.g.:

:app:assembleGoogleArm64Debug
:app:assembleGoogleArm64Release
:app:assembleHuaweiArm64Debug

See run.md for more command examples.

Signing & API Keys (Optional)

The project syncs and builds without any key files:

release signing falls back to placeholder values (not for production use)
debug builds fall back to AGP's default debug signing
third-party service keys (AI providers, Google Places, etc.) are empty and the corresponding features stay disabled

To customize, copy the root templates and fill in real values:

keystore.properties.template → keystore.properties: release signing + service keys
keystore-google.properties.template → keystore-google.properties: dedicated signing for the google flavor

Both target files are git-ignored; never commit real values.

Multi-channel Release Builds

build_release.sh builds 7 channels × 1 ABI (arm64, 64-bit only) = 7 release APKs into release/ with a release/manifest.txt summary. Examples:

./build_release.sh                                # all 7
./build_release.sh --channel xiaomi huawei        # selected channels
./build_release.sh --abi arm64                    # 64-bit only
./build_release.sh --no-offline --clean           # fetch deps online + clean first
./build_release.sh --skip-build                   # re-collect artifacts only

A real keystore.properties is required for release packaging (the script exits early without it).

CI Releases

.github/workflows/android.yml defines the tag-based release pipeline: Ubuntu runner, JDK 17, assembleRelease, then APK signing and release upload.

Update reminders & domestic distribution

The "Open Source Project" row under Profile → About shows the latest release (plus a tab badge on Profile when a newer version exists). A startup dialog can be enabled from the remote config:

"appUpdate": { "dialogEnabled": true, "dialogForVersionBelow": 150, "dialogCooldownHours": 24 }

The version source depends on the flavor: overseas (google / foss) reads GitHub Releases, the six domestic channels read the GitCode OpenAPI. GitCode mirrors only branches/tags/commits — not releases — so domestic builds need an extra publish step:

export GITCODE_TOKEN=xxx          # https://gitcode.com/setting/token-classic
git push gitcode --tags           # the tag must exist: it is used as target_commitish
./scripts/publish_gitcode_release.py --tag 1.4.0 --dir release --abi arm64

Tag pushes do this automatically: CI additionally builds the six domestic channels (arm64, appended via matrix.include) and publishes them to GitCode — requires the GITCODE_TOKEN secret and the tag being pushed to GitCode (the script uses the tag as target_commitish). The GitHub Release keeps the overseas packages only. The GitCode repository has to be public, otherwise the anonymous API returns 403.

AI / Agent Capabilities

AI features are composed from several modules:

feature/ai/: AI chat, agent loop, tool-call execution, interactive tool bridging
feature/common/: AI engine catalog, engine sync, shared managers
feature/settings/: AI engine, model and working-mode configuration UI

The tool-calling chain is built on ToolCallTaskManager, AgentLoopExecutor and AppDatabase.

Security & Third-party Services

No production secrets in this repo: payment (WeChat Pay / Alipay), AI provider and Google Places keys are injected via the optional keystore.properties or kept server-side.
Backend domains and guest tokens are not in source: API base URLs and read-only guest tokens are injected from keystore.properties at build time, so builds from this repository never contact the production servers and hosted content stays empty. To enable connected features, point the app to your own backend (core/r/**/UrlConstantsFlavor.kt).
WeChat appId / WeCom corpId are public identifiers; the WeChat platform verifies callers by package name + signature, so third-party builds cannot impersonate the official app.
Forks & redistribution: change the applicationId (com.shifenmiao.app is taken), replace app/src/google/assets/google-services.json with your own Firebase configuration, and point the app to your own backend (API domains in core/r/**/UrlConstantsFlavor.kt).

Documentation

run.md: build / install / lint commands
docs/modules.md: module catalog (Chinese)
CONTRIBUTING.md: setup, conventions, and what will not be merged
SECURITY.md: how to report a vulnerability privately, and what is deliberately public
docs/database-migrations.en.md: database migration rules (中文)

Support the Project

OneBox is built and maintained by a one-person company (OPC), with a limited budget for servers and AI resources. If it helps you:

In-app donation: in the app, go to Profile → Buy Me a Coffee (points-based)
Partnership & sponsorship: AI providers, cloud vendors and partners willing to sponsor tokens or resources are very welcome — reach us at support@oneboxable.com

Every bit of support turns directly into better features and a more stable service.

Community & Feedback

The same links are in the app under Profile → Join Community (overseas builds show Discord / X / YouTube, domestic builds show the QQ and WeChat groups):

Discord: discord.gg/7j4hEBYGWv — chat, show & tell, early builds
X (Twitter): @OneBoxAndroid
YouTube: @OneBoxAndroid — intro videos and feature demos
Bug reports & feature requests: GitHub Issues
Questions, ideas, show & tell: GitHub Discussions
Security problems: report them privately, see SECURITY.md — please do not open a public issue
中文用户:QQ 群 / 微信群见中文版 README

Contributors Wanted

OneBox is a one-person project and its surface area is now much larger than one person can cover. Help here is genuinely welcome, not a polite formality.

The most useful contributions right now, roughly in order:

Translations. The app and the Play listing ship in 13 locales. If your language reads wrong, only you can tell us. See fastlane/metadata/android/<locale>/.
Device testing. Confirm a build actually works on your OEM ROM, and report what broke.
The open good first issue and help wanted list — start here.
The agent's tool choices. 90+ tools are exposed to the agent; telling us which tool it picks badly, and what it should have picked instead, is real feedback.

Start with CONTRIBUTING.md. No keystores, API keys or backend access are needed to build.

License

Apache-2.0, see LICENSE. The project is a fork of ImageToolbox (T8RIN, Apache-2.0): the image-processing core deliberately stays close to upstream so the diff stays reviewable, and upstream copyright notices are preserved in the files they came from.

Feature Gallery

One box, everything AI. Fully open source, free to use, and your data stays on-device — 18 cards to see what OneBox can do:

MuwMx/YumaPlayer

🎵 Hybrid music client for Android: Spotify discovery & UI + YouTube Music library + Hi-Res Lossless (FLAC) streaming with fluid Glassmorphism💫

YumaPlayer (Yuma)

A hybrid music client for Android focused on usability, clean aesthetics, and audiophile-grade sound.
Spotify UI + Discovery Algorithms + YouTube Music Library + Hi-Res Lossless (FLAC).

Showcase • Features • Architecture • Download • Contributing • Support

🌟 About the Project

YumaPlayer is an independent, open-source Android music player that unites the libraries and recommendation features of two leading streaming services alongside standalone local playback in Hi-Res quality.

The project evolved as a comprehensive rebuild of ArchiveTune (with foundations from Metrolist and SimpMusic), inspired by PixelPlayer's queue mechanics, Meld's Spotify integration pipeline, and Stash's FLAC architecture. On top of this base, YumaPlayer implements a modular 18-module architecture, the custom YDS 2.1 design system, and hardware-accelerated fluid gesture physics.

No subscriptions. No advertisements. Zero telemetry, crash reporters, or third-party trackers. All credentials live exclusively on your device, encrypted with AES-256-GCM via Google Tink, and the codebase is completely open under the GNU General Public License v3.0.

📸 Showcase

_{Main Player (FLAC & Glass)}	_{3-Tier Synced Lyrics}	_{Queue (Dual-Sheet & Haptic)}
_{Immersive Artist Poster}	_{Telegram-Style Morphing}	_{Home (Quick Picks & YDS)}
_{Spotify Feed & Recommendations}	_{Spotify Radio & Mixes}	_{Spotify Daily Mixes}

✨ Key Features

🔄 Dual Mode (Spotify + YouTube Music)

Spotify Home: Personalized recommendation feeds, Daily Mixes, Discover Weekly, favorite artist shelves, and direct import of your Spotify playlists and liked songs.
YouTube Music Home: Full-catalog search across YouTube Music, charts, mood & genre categories, radio stations, and fast channel switching.

🎧 Audiophile Playback & Lossless FLAC

Lossless FLAC: Stream and download true lossless FLAC tracks (via Qobuz / QBDLX backbone integration) using your own credentials or open community resolvers.
Seamless Fallback: If a track is unavailable in lossless catalogs, playback instantly and silently routes through YouTube Music's high-bitrate stream (Opus / AAC).
Local Audio Engine: Built-in player for standalone files stored on your device (FLAC, MP3, AAC, OGG, WAV).
Offline & Caching: Automatic caching of played YouTube Music tracks for offline listening without recurring data usage (FLAC offline caching in active development).
Audio Tuning: Built-in 5-band equalizer with system audio effects support, EBU R128 loudness normalization, smooth crossfading, tempo and pitch adjustment, and a sleep timer.

🎤 Synchronized Lyrics & AI Translation

3-Tier Synchronized Display: Simultaneous live display of original lyrics (Kanji / Hangul), pronunciation guide (Romaji), and translated lines.
Live Karaoke Scrolling: Word-by-word and line-by-line sync pulled from 6+ providers (LRCLIB, Kugou, BetterLyrics, SimpMusic, Unison, YouLyPlus).
On-the-Fly AI Translation: Instant translation of lyrics into your preferred language right inside the player.
Lyrics Card Sharing: Export and share formatted lyrics quote cards as clean images.

🎨 Yuma Design System (YDS 2.1) & Fluid Motion

Real Glassmorphism: Translucent glass cards (GlassScaffold, 0.5dp hairline borders, composite 22dp / 5dp corner geometry).
Dual-Sheet Gesture Engine: Independent, conflict-free player sheets (swipe up on the left for Lyrics, swipe up on the right for Queue).
Telegram-Style Morphing Header: Smooth, scroll-linked transformation of artist posters into a status-bar drop using custom 3-point lerp3 without image distortion.
Smart Freeze & Pre-warming: Instant sheet expansion with 0-frame startup latency, while off-screen physics loops and background tasks suspend automatically (snapshotFlow) to preserve battery life and keep the device cool.
Dynamic Monet Theming: Adaptive palette extraction powered by the currently playing track's artwork, tuned for strict WCAG contrast compliance.

🌐 Integrations & Convenience

Spotify Canvas & Apple Motion: Looping video backgrounds during playback (In development).
Music Recognition (Shazam): Acoustic fingerprint search for songs playing around you (In development).
Together (Listen Together): Synchronized playback with friends over WebSockets.
Scrobbling: Native Last.fm and ListenBrainz integration.
Discord Rich Presence: Real-time presence status showing your current track and album art on Discord.
Android Auto & Widgets: In-car playback support and home screen Glance widgets.

🌍 Globalization & Localization

YumaPlayer is localized into multiple languages thanks to our amazing community translators. The localization pipeline is continuously synchronized with the codebase via Hosted Weblate.

Want to help translate Yuma? No coding or Git knowledge required. Just open our Weblate translation dashboard, choose your language, and start contributing directly through your browser.

🏛️ Architecture & Tech Stack

YumaPlayer is built as a multi-module Android project following Clean Architecture and Unidirectional Data Flow (UDF) principles:

UI & Design: Jetpack Compose, YDS 2.1 design tokens, Hardware-accelerated Haze overlays, fluid gesture physics.
Audio Engine: Media3 (ExoPlayer), standalone local audio pipeline, Qobuz/FLAC resolver backbone.
Data & Storage: Room ORM, encrypted secure preferences (AES-256-GCM via Google Tink).
Network & Ingestion: Ktor/Retrofit, InnerTube (YouTube Music engine), custom multi-source lyrics scrapers.

📖 Detailed Developer Documentation:

📥 Download & Installation

GitHub Releases	Telegram Channel	Obtainium

Building from Source

git clone https://github.com/MuwMx/YumaPlayer.git
cd YumaPlayer
./gradlew assembleRelease
# Built APK will be located at: app/build/outputs/apk/release/

Prerequisites: A recent Android Studio version with AGP 9.x support, JDK 21, Android SDK 37 (compileSdk/targetSdk 37, minSdk 26).

⚙️ Account Setup

YumaPlayer is fully functional out of the box without signing in. Logging in is optional and only required to sync personal playlists, likes, and recommendations:

🎵 Connecting Spotify

Open Settings → Account → Spotify → Tap Log In.
Sign in with your standard Spotify credentials in the secure in-app browser window.
Your session cookie (sp_dc) will be automatically captured and encrypted on your device.

📺 Connecting YouTube Music

Two convenient login methods are supported:

Method 1 (Google Account): Open Settings → Account → YouTube → Sign in using the secure in-app authentication sheet.
Method 2 (Token / Cookie Input): If you use two-factor authentication or prefer manual setup, navigate to Settings → Account → Token Editor and paste your session cookies directly.

☕ Support the Project

YumaPlayer is free, open source, and has no ads or subscriptions. If you enjoy using the player and wish to support ongoing development:

Solana (SOL, USDT, USDC):
DT3ckdbNuiQMR1mrCpBXCMrhLB19GckVv3YfxsLLiF8z

PayPal / Email Transfer:
muwmix.coffee@gmail.com

📈 Star History

💡 Contributing

Contributions make open-source projects thrive! Whether you are fixing bugs, proposing new features, or improving docs:

Read our Contribution Guidelines before submitting code or PRs.
Want to translate? Head over to our Hosted Weblate — no coding required.

👥 Contributors

🤝 Acknowledgments (Open-Source Credits)

YumaPlayer is built on the shoulders of the open-source community:

ArchiveTune — for the solid playback foundations, rich settings base, and core architecture.
Meld — for the conceptual breakthrough and implementation of the Spotify hybrid integration.
Stash — for inspiration in organizing lossless FLAC streaming and download pipelines.
Metrolist & SimpMusic — for early lyrics parsing and interface inspirations.
PixelPlayer — for swipe kinematics ideas and queue structure.
QBDLX — for the lossless audio streaming infrastructure.
LRCLIB & BetterLyrics — for the open synchronized lyrics databases.

⚖️ License & Legal Disclaimer

License

YumaPlayer is free software licensed under the GNU General Public License v3.0 (GPLv3).
You may freely copy, modify, and redistribute the source code provided you preserve copyright notices and distribute derivative works under the same GPL-3.0 license.

Disclaimer

YumaPlayer is an independent third-party client. It is not affiliated with, endorsed by, or sponsored by Google LLC, YouTube Music, or Spotify AB. The application is provided for personal use only as a tool for managing your own library.

Crafted with ❤️ and attention to every frame. Enjoy the music! 🎵

frknkrc44/HMA-OSS

A Zygisk module to hide your app list, settings, package installers and more. It is a fork of Hide My Applist project, but LSPosed dependency is replaced with Zygisk.

HMA-OSS

About this module

Although it's bad practice to detect the installation of specific apps, not every app using root provides random package name support. In this case, if apps related to root (such as Fake Location and Storage Isolation) are detected, it is tantamount to detecting that the device is rooted.

Additionally, some apps use various loopholes to acquire your app list, in order to use it as fingerprinting data or for other nefarious purposes.

This module can work as an Zygisk module to hide apps or reject app list requests.

About HMA-OSS

https://github.com/frknkrc44/HMA-OSS/wiki

I want to contribute translation

You can contribute translation here.

Update log

Reference to the commits page

AndyShaman/BYDMate

BYD DiLink app (3.0/5.0/5.1, UI7): split screen 1/3+2/3, navigation on instrument cluster, Yandex Navigator on HUD, blind-spot cameras on turn signal, Russian voice AI agent, real BMS consumption, trips/charges journal, automation, ABRP + webhook telemetry. Leopard 3 / Bao 3, Sea Lion 07, Song, Atto 3.

BYDMate

Trip Logger & Energy Analytics for BYD DiLink 5.0

English | 中文 | Русский

Реальный расход, GPS-маршруты, автоматизация, локальная AI-аналитика.

Разделение экрана 1/3 и 2/3, навигация на приборной панели, подсказки Яндекс Навигатора на лобовом стекле, камеры слепых зон по поворотнику, голосовой помощник по-русски, телеметрия в ABRP.

Проверено на Leopard 3 (方程豹豹3), есть поддержка Sea Lion 07, Song, Atto 3, Seal, Han. DiLink 3.0, 4.0, 5.0, 5.1 и прошивки с новым интерфейсом UI7 (OTA V1.6).

Зачем это нужно

Штатный бортовой компьютер BYD занижает расход на 10-30%. BYDMate берёт данные напрямую из BMS (energydata) и показывает реальное потребление. Плюс данные, которых нет в штатной системе: расход на стоянке, баланс ячеек, стоимость поездок, AI-аналитика.

Все основные функции (поездки, зарядки, автоматизации, локальные инсайты, офлайн голосовой агент) работают локально на DiLink и не требуют интернета. Облачные функции выключены по умолчанию и включаются только вручную вводом ключа. Что именно и когда уходит в сеть, описано в разделе «Данные и сеть».

Что нового

Главное в версии 3.19.6.

Трек Яндекса на приборке. Название трека и исполнитель из Яндекс Музыки и из музыки в Яндекс Навигаторе (Алиса) показываются в карточке музыки на приборке, раньше машина оставляла её пустой. Включается переключателем «Трек Яндекса на приборке» в Настройки → Дисплей, по умолчанию выключен. Спасибо @vladh91 за эту доработку. В итоговом виде на машинах пока не проверено.

HUD, способ 3 передаёт машине больше. Кроме стрелки, метров и улицы он сообщает оставшееся время и расстояние до конца маршрута и время прибытия, а стрелку, метры и улицу отправляет ещё и вторым путём. Если в способе 2 на стекле видны метры и улица, а стрелки нет, попробуйте способ 3. Способы 1 и 2 не изменились. На машинах пока не проверено.

HUD понимает больше манёвров. Подсказки Навигатора на английском, номер съезда с кольца словами («второй съезд»), «круто влево», «плавно вправо» и другие. Манёвры, которые приложение понимало раньше, читаются так же.

HUD дольше держит подсказку. Если приложение на время перестало видеть подсказку в окне Навигатора, стекло больше не гаснет через 10 секунд: оно ждёт до полутора минут. После отмены маршрута последнее расстояние и улица могут оставаться на стекле столько же. На машинах без сервисов Google уведомление «Установите сервисы Google Play» больше не включает HUD без маршрута.

Главное в версии 3.19.5.

Новые действия в автоматизации. «Закрыть приложение» полностью закрывает выбранное приложение, маршрут или музыка, которые в нём не сохранены, пропадут. «Медиа: играть» и «Медиа: пауза» продолжают или ставят на паузу то, что играет в уже запущенном плеере. Если плеер не запущен, поставьте перед этим шагом «Запуск приложения». В одно правило теперь помещается до 20 действий.

TRIP 1 и TRIP 2 в отчёте в Telegram. В настройках отчёта появились две галочки: каждый счётчик с Главной добавляется в отчёт отдельно.

Вывод на приборку на Han и Tang 2024. На машинах с Android 12, где приложение само не видит экран приборки, вывод сразу прерывался. Теперь этот экран находится. На машинах пока не проверено.

HUD, способы 2 и 3. Манёвр «плавно направо» показывается стрелкой направо, раньше машина рисовала его как «плавно налево». Если приложение закрылось посреди маршрута, при следующем запуске оно убирает карточку навигации с приборки.

Главное в версии 3.19.4.

Три способа вывода на стекло. В настройках HUD вместо двух режимов теперь три способа. Способ 1 стоит по умолчанию и работает как раньше: подсказки идут на стекло, приборку приложение не трогает. Способ 2 переводит машину в режим навигации и передаёт стрелку, метры и улицу в карточку навигации на приборке, улица там пишется латиницей. Способ 3 пробный: всё как в способе 2, и ещё одним путём, которым пользуется OpenBYD. Способы 2 и 3 новые и на машинах пока не проверены. Когда маршрут закончен, способ сменён или HUD выключен, приложение убирает со стекла и приборки всё, что выводило.

Проверка HUD сама выбирает способ. Проверка показывает на стекле по очереди числа 111, 222, 333 и 444, каждое своим способом, а в конце спрашивает, какое число вы увидели, и ставит нужный способ. Если стекло ничего не показало, приложение попросит прислать лог. Тестовое расстояние 333 м после проверки стирается.

Окно не опускается само. После стоянки окно больше не открывается само при включении машины, а повторные «проветрить» и «половина» срабатывают с первого раза: после каждой команды окну на часть приложение снимает её с машины так же, как штатный голосовой помощник BYD.

Яндекс Музыка без интернета. Фразы «включи Яндекс Музыку», «запусти Яндекс Мьюзик» и просто «Яндекс Музыка» включают «Мою волну» сразу, без облачного помощника.

Главное в версии 3.19.3.

Агент закрывается сам. В настройках голосового агента появился переключатель «Закрывать агента после выполненной команды», по умолчанию выключен. Когда он включён, после выполненной команды или ответа агент закрывается сам. Если агент задал вам вопрос, он дождётся ответа.

Закрыть агента можно словами. Скажите «закрой агента», «выключись» или «всё, спасибо, отдыхай», и агент закроется. Это работает через модель, поэтому нужен интернет.

Два режима HUD. В карточке HUD появился выбор режима. Режим 1 стоит по умолчанию: подсказки идут на стекло, приборку приложение не трогает. Режим 2 на время маршрута переводит машину в режим навигации, его стоит попробовать, если в режиме 1 стекло пустое. Вывод приложений и камер на приборку снова работает во время маршрута. Тестовая надпись после «Проверки HUD» стирается со стекла.

«Климат авто». Фразы «климат авто» и «климат в автомате» переключают климат в автоматический режим, а не только включают его.

Окна на часть. Повторная команда открыть окно на часть, например проветривание или наполовину, срабатывает и там, где машина раньше её пропускала.

Магнитолы с Android 10. Кнопка руля, назначенная в автоматизации, работает после выключения и включения машины. Виджет после включения машины больше не пропадает на полминуты. Запись логов теперь сохраняет и работу камер слепых зон.

Возможности

	Функция	Описание
BMS	Реальный расход	Данные BMS (energydata), не бортовой компьютер. Тренд по скользящему окну 25 км
GPS	Трекинг поездок	GPS-маршруты, дистанция, скорость
Charge	Зарядки	Автоматическая запись AC/DC, статистика за период и за всё время, ручное добавление и редактирование
AI	Инсайты	Анализ вождения: локальные правила на устройстве, без интернета
TRIP	Счётчики TRIP 1/2	Пробег, расход, время и стоимость с момента сброса (как в машине); сброс долгим нажатием, подробности по касанию
Bat	Здоровье батареи и «Техника»	Карточка: SoH (Leopard 3, DiLink 3.0), температура, 12V, разброс ячеек, изоляция. Тап открывает экран «Техника» с живыми параметрами батареи, моторов, климата и шин, включая долю мощности перед/зад в процентах
Map	Карта маршрута	osmdroid (OpenStreetMap) в деталях поездки
Rules	Автоматизация	Правила WHEN→THEN: триггеры по параметрам → команды управления машиной
Cluster	Вывод на приборку	Вывод выбранного приложения на приборную панель кнопкой руля (по умолчанию правая звезда)
HUD	Проекция на лобовое	Манёвры, дистанция и знак ограничения скорости из Яндекс Навигатора на заводском проекционном дисплее
Split	Разделение экрана	Два приложения сразу: окнами BYDMate в пропорции 1/3 и 2/3 либо штатным разделением прошивки
Cam	Камеры слепых зон	Камера нужной стороны по включённому поворотнику: на приборке или в окошке на экране
Voice	Голосовой агент	Русский офлайн-ассистент: распознавание речи на устройстве, AI-агент (32 инструмента), нейросетевая озвучка
Widget	Плавающий виджет	7 полей поверх других приложений: SOC, запас хода, расход + тренд, время, t° салона, t° батареи, 12V
Auto	Автозапуск	WorkManager, запускается при включении
Backup	Сохранение конфигурации	Поездки, зарядки, настройки и ключи в одном архиве в Download, восстановление по частям, автосохранение по расписанию с копией в ваш Telegram-бот
Share	Обмен автоматизациями	Правило в файл без номеров, контактов и ваших мест; импорт чужого правила с предпросмотром
Aa	Размер текста	Обычный, крупный или очень крупный текст на экранах приложения и в окнах голосового агента

Скриншоты

Dashboard

Вокруг SOC-кольца расположены четыре значения в стиле плавающего виджета: сверху длительность поездки, одометр и температура - в салоне и за бортом в одном слоте (если машина не сообщает наружную температуру, слот показывает только температуру в салоне, как раньше); снизу пробег текущей поездки, расчётный запас хода и расход текущей поездки со стрелкой тренда. Цвета и логика тренда такие же, как в плавающем виджете, поэтому информация читается одинаково и на главном экране, и поверх других приложений.

Ниже кольца: AI-инсайт, малая карточка здоровья батареи (SoH на Leopard 3 и DiLink 3.0, температура, 12V), два счётчика TRIP 1 и TRIP 2, последние поездки, фильтр периода. Каждый счётчик показывает пробег, расход в кВт·ч (включая стоянку), время в пути и стоимость с момента сброса. Долгое нажатие сбрасывает счётчик, касание открывает детали. В окне счётчика можно включить сброс после зарядки: после любой, только AC, только DC или только после зарядки до 100%.

AI Инсайты

Анализ эффективности вождения — расход, тренды, батарея, рекомендации (считается на устройстве)

Здоровье батареи

Температура, SoH (Leopard 3, DiLink 3.0), 12V аккумулятор, баланс ячеек, напряжение

Поездки

Аккордеон Месяц > День > Поездка с фильтрами и цветовой индикацией расхода

Чип «Температура» над списком открывает экран «Расход и температура»: точка на каждую поездку длиннее 5 км, линия медиан по 5-градусным полосам, медианы по холоду (ниже 0 °C), межсезонью (0…15 °C) и теплу (выше 15 °C) и вывод, на сколько процентов расход в холод выше. Поездки короче 5 км в график не попадают: там всё съедает прогрев. Нужно 8 поездок с температурой и разброс хотя бы в 15 °C, иначе экран честно скажет, чего не хватает.

В окне поездки видно одометр на старте и на финише, время в движении, стоимость на 100 км, изменение заряда в процентах и температуру за бортом в начале и в конце. Одометр пишется только для поездок после обновления.

Автоматизация

Правила КОГДА→ТОГДА, редактор условий и действий, настройки срабатывания

Настройки

Разделы: Голос-агент, Виджет, Дисплей, Разделение экрана, Авто и батарея, Интеграции, Сервис и данные, Приложение

Разделение экрана

Две панели 1/3 и 2/3, виджет BYDMate поверх

Автоматизация

Вкладка Автоматизация позволяет создавать правила для автоматического управления автомобилем напрямую через системный интерфейс машины.

Принцип работы

КОГДА условие выполняется → ТОГДА выполнить команду.

Примеры:

SOC < 20% → включить внутреннюю циркуляцию
Скорость > 0 → закрыть шторку
Температура за бортом < 0 → включить подогрев зеркал

Возможности

	Описание
Триггеры	SOC, скорость, температура, поворотник, передача, двери, окна, люк, багажники, давление шин, режим езды, точки-геозоны, время суток, точное время и промежуток с днями недели, клавиша руля, тап по виджету, голосовая фраза, запуск сервиса, появление интернета и др. Поворотники, передача, двери, окна, багажники и датчики слепых зон приходят в приложение в момент события, а не по опросу
Команды	Окна (включая отдельные — водителя и пассажира), климат, свет, замки, люк, зеркала — напрямую через системный интерфейс машины. Подогрев руля на машинах, где он есть
17 видов действий	Команда автомобилю, уведомление, запуск приложения, звонок, маршрут в Я.Навигаторе, открыть URL, Яндекс.Музыка, запуск ролика на YouTube, пауза, громкость медиа, охранный режим, точка доступа Wi-Fi, озвучить текст, запрос агенту, главный экран BYDMate, вывод на приборку, разделение экрана (запуск, закрытие, переключение). У команд машины, охранного режима и вывода на приборку есть вариант «Переключить»
Edge trigger	Срабатывает только при переходе false→true (не повторяется каждые 3 сек)
Cooldown	Настраиваемая пауза между срабатываниями
Overlay-подтверждение	Всплывающее окно «Отмена / Выполнить» перед действием. Таймаут 15 с → автоотмена
Безопасность	Окна не открываются на скорости > 120 км/ч, люк > 80 км/ч, двери не отпираются > 30 км/ч, CAN/SHELL команды заблокированы
Журнал	Лог всех срабатываний с результатами
Шаблоны	6 готовых правил для быстрого старта
Выполнить сейчас	Ручной запуск правила из редактора, мимо триггеров и cooldown

«Переключить» — это третий вариант рядом с самим действием, а не отдельный пункт. В списке команд под парой «открыть / закрыть» стоит строка вида «Багажник: переключить», а у охранного режима и вывода на приборку к кнопкам «Включить» и «Выключить» добавилась кнопка «Переключить».

Переключать умеют: багажник, передний багажник, люк, замки, аварийку, климат, подогрев и обдув сидений водителя и пассажира, подогрев руля, вывод на приборку и режим охраны. Состояние берётся из машины: что открыто — закроется, что выключено — включится. Сиденье, которое сейчас работает, выключится, а выключенное вернётся на ту ступень, которую вы задавали последней (по умолчанию третью). Если машина не сообщает состояние, действие честно откажется и напишет об этом, а не будет угадывать.

Правила, созданные в прошлых версиях, продолжают работать и открываются на редактирование как раньше — менять ничего не нужно.

Списки команд и параметров свёрнуты по разделам. Открыт только раздел с текущим выбором, остальные разворачиваются тапом по заголовку.

Тестовый запуск. В редакторе правила кнопка «Тестовый запуск» сразу выполняет все действия, как будто сработало условие. Срабатывание при этом не засчитывается. Открытие окон, люка и переднего багажника и отпирание дверей пропускаются, если нет свежих данных о скорости: не старше 10 секунд при работающем сервисе. Нераспознанная команда тоже пропускается, с пояснением. Закрыли редактор, и запуск останавливается.

Списком или карточками. Переключатель в шапке вкладки показывает правила компактным списком или карточками в три колонки, выбор запоминается. У каждого правила видно, сколько раз и когда оно срабатывало.

Места. Кнопка «Места» переехала из Настроек в шапку вкладки «Автоматизация», рядом с «Журналом». Добавлять и править точки можно прямо там.

Подогрев руля. Действие «Подогрев руля» включает, выключает и переключает подогрев. Результат проверяется по состоянию машины, а на машине без подогрева руля действие честно сообщит, что его нет. На машине с подогревом руля команда пока не проверена, ждём отзывов.

Логика

AND — все условия должны выполняться
OR — достаточно одного условия
Только на P — правило срабатывает только когда авто на паркинге

Проверка условия при каждом включении

Правило срабатывает в момент, когда значение переходит через порог, пока приложение работает. Если вы сели в машину, где в салоне уже 32 градуса, а порог 29, перехода не было, и правило не сработает. Чтобы условие проверялось при каждом включении, сделайте рядом с первым правилом второе:

Первое условие: «Запуск BYDMate».
Второе условие: «Темп. салона» больше 29.
Выберите «Все условия».
Действия те же, что в первом правиле.

«Любое условие» не ставьте: правило будет срабатывать при каждом запуске, какая бы температура ни была.

Поделиться автоматизацией и импорт

Готовое правило можно отдать другому владельцу, а чужое добавить себе.

Как поделиться

Нажмите «Поделиться» на карточке правила или в редакторе.
Посмотрите, что попадёт в файл: окно показывает это до сохранения.
Нажмите «Продолжить». Правило сохранится в папку Download в файл bydmate_rule_<имя>.json, имя файла покажется во всплывающем сообщении, и откроется системное окно «Поделиться».

Что приложение убирает из файла:

номера телефонов и имена контактов;
привязки к вашим местам;
логин и пароль из ссылок и параметры ссылок, похожие на ключи (token, api_key и подобные). Обычные параметры остаются.

Что остаётся в файле: адрес ссылки, тексты уведомлений и фраз, запросы агенту и точки маршрутов. Проверьте их перед отправкой.

Как добавить чужое правило

Положите файл bydmate_rule_*.json в папку Download на DiLink.
На вкладке «Автоматизация» нажмите «Импорт» в шапке и выберите файл из списка.
Проверьте правило в окне предпросмотра. Там видны настоящие параметры: все условия или любое, номер и автодозвон у звонка, адрес ссылки, команда машине, текст запроса агенту, куда на самом деле поведёт маршрут и нажмёт ли приложение «Поехали» само.
Если места или контакта из правила у вас нет, выберите свои кнопками «Выбрать место» и «Выбрать контакт».
Нажмите «Добавить». По умолчанию правило добавится выключенным, отметка «Включить сразу» включит его сразу.

Правило со ссылкой, адрес которой нужно ввести заново, добавляется только выключенным. Если из ссылки удалены параметры, похожие на ключи, окно попросит проверить адрес. Файлы с чрезмерной вложенностью или слишком длинными строками приложение не принимает.

Вывод на приборку

BYDMate умеет выводить выбранное приложение (по умолчанию навигацию) на приборную панель за рулём, чтобы карта и манёвры были перед глазами, а центральный экран оставался свободным.

Управление кнопкой руля

Короткое нажатие выбранной кнопки переносит навигацию на приборку.
Повторное короткое нажатие возвращает её на центральный экран.
Удержание правой звезды работает штатно (меню машины), BYDMate его не перехватывает.

По умолчанию проекцию включает правая звезда. Кнопку можно переназначить, см. «Выбор кнопки» ниже.

Включение

Откройте Настройки → Дисплей и включите тумблер «Проекция на приборку». Приложение само активирует нужный сервис (нужна выполненная активация ADB при установке, см. «Установка») и само переводит приборку в режим проекции: за это отвечает тумблер «Сразу показывать на приборке», он включён по умолчанию. На головном устройстве вручную ничего настраивать не нужно.

После этого короткое нажатие выбранной кнопки руля (по умолчанию правая звезда) переносит выбранное приложение на приборку и обратно.

Если «Сразу показывать на приборке» выключить, приборку придётся один раз перевести в режим проекции самому: иконка проекции на главном экране головного устройства, затем кнопка IPC на появившейся карте. Выключать стоит, если после вывода на приборку с неё пропадает ADAS или штатный виджет и не возвращается сам (на части прошивок DiLink 5.0 экран проекции живёт внутри штатной мини-карты): с выключенным тумблером приложение не трогает режим приборки, это касается и камер слепых зон, а картинка видна в мини-карте.

Режимы проекции: «Заводской» и «Расширенный»

В Настройки → Дисплей, рядом с тумблером проекции, выбирается режим вывода на приборку. Их два, и отличаются они тем, трогает ли приложение системные настройки машины.

«Заводской» (по умолчанию). Приложение не меняет ни одной системной настройки: проекция работает через виртуальный дисплей (картинка зеркалится на приборку), ползунки подстройки окна работают точнее. Ставится и удаляется бесследно. Ограничение: голосовой агент и HUD не видят экран навигатора во время проекции, подсказки о манёврах агент берёт только из уведомления Навигатора.

«Расширенный». Навигатор запускается отдельным окном прямо на дисплее приборки, поэтому голосовой агент и HUD видят маршрут во время проекции. Для этого приложение включает системную настройку оконного режима (enable_freeform_support). Режим включается только через диалог с объяснением, после включения нужна однократная перезагрузка головного устройства (долгое зажатие колёсика громкости). Новый режим применяется при следующем выводе на приборку.

На части прошивок (DiLink 4.0, Song Plus 2021 и похожие) экран приборки скрыт от приложений, и «Заводской» режим там работать не может: приложение само находит приборку через служебный канал и выводит навигатор «Расширенным» режимом, независимо от выбранного. На DiLink 4.0 это проверено на машине. В этом режиме не работает ползунок «Масштаб» в настройке «Размер окна на приборке».

Как вернуть заводские настройки. Переключите режим обратно на «Заводской»: приложение сразу вернёт системную настройку к заводскому значению, а перезагрузка ДиЛинка полностью завершит возврат. После этого система в том же состоянии, что и до установки BYDMate.

Там же, под выбором режима, есть тумблер «Полный экран приборки». По умолчанию карта занимает верх приборки, а внизу остаётся штатная полоса со скоростью и основными показателями. Включите тумблер, если хотите карту на всю приборку без этой полосы. Работает только на прошивках с новым интерфейсом, на остальных ничего не меняет; применяется при следующем выводе на приборку.

Если вы пользовались проекцией в версиях до 3.7, при обновлении прежнее поведение сохранится автоматически: режим останется «Расширенный». У тех, кто проекцию не включал, приложение системные настройки не трогает вообще.

Выбор кнопки

По умолчанию проекцию включает правая звезда руля. Если этой кнопки нет или удобнее другая, под тумблером нажмите «Изменить» и нажмите нужную кнопку на руле, приложение её запомнит. Назначить можно любую кнопку руля, которую видит система. Системные кнопки (громкость, питание и т.п.), обзор 360 и карусель приборки назначить нельзя.

Какое приложение проецировать

По умолчанию на приборку выводится Яндекс.Навигатор. Под тумблером включения есть выбор приложения: можно указать любое установленное (другой навигатор, медиаплеер и т.д.). Новый выбор применяется при следующем нажатии кнопки.

Размер и положение окна

В разделе Настройки → Дисплей → «Размер окна на приборке» пять ползунков. Если на вашей машине проекция и так занимает всю приборку (например, Leopard 3), настраивать ничего не нужно: значения по умолчанию дают прежний полноэкранный режим.

Ширина и Высота (20-100%) - размер окна в процентах от приборки. Уменьшенное окно освобождает место, штатная приборка просвечивает вокруг.
Сдвиг по горизонтали (0-100%) - положение окна: 0 - левый край, 50 - центр, 100 - правый край. Действует, только когда ширина меньше 100%.
Сдвиг по вертикали (0-100%) - то же по вертикали: 0 - верх, 50 - центр, 100 - низ.
Масштаб (50-150%) - крупность интерфейса проецируемого приложения: чем меньше значение, тем мельче надписи и тем больше карты помещается в окне.

Изменения применяются сразу, прямо во время проекции - двигайте ползунок и смотрите на приборку.

Машины с мини-окном на приборке (Sea Lion 07 и похожие)

На части моделей штатная приборка показывает проекцию не на весь экран, а в фиксированной зоне (на Sea Lion 07 - правая треть). Полноэкранное окно там обрезается. Решение: уменьшить окно и сдвинуть его в видимую зону ползунками выше.

Проверенные владельцем Sea Lion 07 значения: ширина 32%, высота 92%, сдвиг по горизонтали 100%, сдвиг по вертикали 6%, масштаб 90%.

Вывести окно на весь экран приборки на таких машинах не получится: зону показа задаёт прошивка панели, и она не управляется.

Как это устроено

Проекция работает в одном из двух режимов, описанных выше. В «Заводском» BYDMate создаёт виртуальный дисплей и зеркалит в него выбранное приложение, не меняя настроек системы. В «Расширенном» приложение запускается отдельным окном прямо на дисплее приборной панели, поэтому голосовой агент и HUD видят маршрут во время проекции. Чтобы перехватывать кнопки руля, приложение включает собственный сервис специальных возможностей (accessibility). Он работает только при включённом тумблере и нужен исключительно для выбранной кнопки. Прошивку и саму машину это не меняет, всё обратимо.

HUD

Если в машине есть заводской проекционный дисплей, BYDMate выводит на лобовое стекло подсказки Яндекс Навигатора: значок манёвра, дистанцию до него, название улицы и время прибытия. Отдельным тумблером включается знак ограничения скорости, он передаётся числом. Пока Навигатор предупреждает о камере, вместо стрелки манёвра показывается значок камеры и расстояние до неё. Ведение продолжается, даже когда Навигатор свёрнут или выведен на приборку; Яндекс Карты работают источником подсказок наравне с Навигатором.

Включается в Настройки → Дисплей, раздел «HUD (проекционный дисплей)»: тумблер «Навигация на HUD» и отдельно «Знак скорости под стрелкой». Там же выбирается способ вывода на стекло: способ 1 по умолчанию, способы 2 и 3 для машин, у которых в способе 1 стекло пустое. Подсказки идут по штатному каналу самого HUD, поэтому нужна комплектация с проекционным дисплеем. Если такого канала на машине нет, приложение честно пишет об этом в настройках и функцию не включает.

Что приложение меняет в машине. В способе 1 ничего: подсказки идут по каналу самого HUD. В способах 2 и 3, пока «Навигация на HUD» включена и навигатор ведёт по маршруту, BYDMate включает в машине режим навигации и пишет стрелку, метры и улицу в карточку навигации на приборке. В способе 3 туда же передаются оставшееся время и расстояние до конца маршрута и время прибытия. Когда маршрут закончен, способ сменён или тумблер выключен, всё возвращается в прежнее состояние. При выключенном тумблере приложение ничего в машине не трогает.

Если на стекле ничего не появляется. Откройте Настройки → Сервис и данные, раздел «Данные», и нажмите «Запустить» рядом со строкой «Проверка HUD». Машина должна стоять, маршрут в навигаторе не запущен. Проверка идёт около двух минут и по очереди показывает на стекле числа 111, 222, 333 и 444, каждое своим способом. В конце она спросит, какое число вы увидели, и сама поставит нужный способ. Если стекло ничего не показало, запишите лог кнопкой записи логов и пришлите его в issue на GitHub вместе с моделью машины.

Камеры слепых зон

При включённом поворотнике BYDMate сам показывает картинку с боковой камеры: левый поворотник выводит левую камеру на приборку, правый показывает окошко на главном экране. Если датчик видит машину сзади-сбоку, окно подсвечивается оранжевой рамкой.

Включается в Настройки → Дисплей, раздел «Слепые зоны» (по умолчанию выключено). Там же настраиваются порог скорости, ниже которого камера не показывается, ширина окошка и его положение: кнопка «Настроить положение» показывает пустое окошко, которое перетаскивается пальцем туда, где будет камера. Если левая камера на приборке мешает, включите там же «Обе камеры на главный экран»: обе картинки будут показываться на планшете, приборка не трогается. Левое окошко по умолчанию стоит зеркально правому, а кнопка «Положение левой камеры» под тумблером задаёт ему своё место. Тумблер «Окно камеры вертикально» ставит окошко вертикально и поворачивает картинку на 90 градусов, как в зеркале: если после включения картинка повёрнута не в ту сторону, напишите в issue. Нужна комплектация с круговым обзором. На некоторых машинах с DiLink 4.0 прошивка не даёт приложениям доступ к камерам, там функция не работает.

Голосовой AI-агент

Полноценный русский голосовой помощник внутри BYDMate. Речь распознаётся прямо на головном устройстве, без интернета: нейросеть GigaAM v3 слушает и понимает по-русски. Простые команды исполняются мгновенно локальным разбором, всё остальное решает AI-агент: языковая модель с 32 инструментами, которая сама читает данные машины, управляет функциями кузова, строит маршруты, запускает сценарии и отвечает голосом.

Почему русский, и только русский

Штатный голосовой помощник BYD уже нативно работает с английским и китайским. Делать ещё один английский помощник бессмысленно. BYDMate закрывает то, чего в машине нет вообще: русский язык. Поэтому распознавание речи, разбор команд и голоса озвучки заточены именно под русский, английская версия агента не планируется.

Как включить

Настройки → Голос-агент: включите тумблер «Голосовой AI-агент». Что должно произойти: ниже появятся поля имени, характера и рода агента.
Задайте ключ языковой модели: Настройки → Интеграции → AI подключения. Рекомендуем OpenRouter (регистрация на openrouter.ai, платно, доли цента за вопрос) и быструю модель, например Gemini Flash. Есть бесплатный вариант z.ai с моделью glm-4.7-flash, но он отвечает заметно медленнее. Третий вариант: свой OpenAI-совместимый сервер. Что должно произойти: у подключения появится отметка, что ключ задан. Можно указать и два подключения: при сбое основного агент сам переключится на второе.
Вернитесь в Голос-агент, раздел «Агент», и нажмите «Тест модели». Что должно произойти: под кнопкой появится название модели, время ответа и короткая фраза от агента. Если кнопка серая, ключ не сохранён: проверьте его в Интеграциях. Кнопка «Чат с агентом (отладка)» рядом позволяет проверить ответы текстом ещё до микрофона.
В разделе «Распознавание речи» нажмите «Скачать (226 МБ)», лучше по Wi-Fi. Что должно произойти: пойдут проценты загрузки, в конце строка сменится на «Модель готова».
В разделе «Кнопка и микрофон» включите тумблер «Голосовые команды» и разрешите микрофон. Что должно произойти: ниже покажется текущая кнопка руля. На Leopard 3 она уже назначена, на других машинах нажмите «Назначить кнопку» и один раз нажмите кнопку на руле.
Нажмите кнопку руля и скажите «Сколько заряда?». Что должно произойти: появится пилюля «Слушаю», после фразы короткий сигнал, через секунду-две ответ.
По желанию озвучка: раздел «Ответы агента», включите тумблер и скачайте голос (обычный 18-21 МБ, либо улучшенный Марк или Софья 145 МБ на двоих). Что должно произойти: агент начнёт отвечать вслух, без озвучки ответ остаётся текстом на экране.

Как разговаривать

Нажмите голосовую кнопку на руле. На Leopard 3 она распознаётся из коробки, на других моделях любую кнопку можно обучить в настройках (перехват кнопки требует службы специальных возможностей, она включается автоматически).
На экране появляется пилюля-индикатор «Слушаю». Её можно перетащить в любое место экрана, позиция запоминается. В пилюле видны последние реплики: «Ты:» и «Агент:».
Говорите обычными фразами. Сессия непрерывная: после ответа агента можно сразу говорить дальше, кнопку повторно нажимать не нужно.
Сессия завершается сама после 30 секунд тишины, с отдельным звуковым сигналом. Ограничения на длительность разговора нет: пока идёт диалог, агент слушает. Короткие сигналы подтверждают приём команды и сообщают об ошибке.
Перебивание по имени. Если задать агенту имя (поле «Имя агента» в настройках), то во время его ответа достаточно произнести это имя: агент замолчит и снова слушает. Имя в начале фразы отбрасывается («Штурман, открой окна» понимается как «открой окна»). Важно: это не «горячее слово» как у Алисы, без нажатия кнопки агент микрофон не слушает. По умолчанию имя пустое и перебивание неактивно.

Что умеет агент

У агента 32 инструмента. Примеры фраз:

Машина и климат

«Сколько заряда?», «Какая температура за бортом?», «Какой запас хода?» (живое состояние машины)
«Открой окна», «Включи подогрев сиденья», «Поставь климат на 22» (полный каталог из 97 команд, см. ниже)
«Сделай музыку громче», «Потише» (громкость медиа)

Поездки, зарядки, статистика

«Покажи поездки за неделю», «Сколько я проехал за месяц?»
«Когда я последний раз заряжался?»
«Запиши зарядку на 30 киловатт-часов за 200 рублей» (ручная запись в журнал зарядок)
«Какой у меня средний расход?»

Навигация и места

«Поехали домой», «Поехали на работу», «Поехали на дачу» (сохранённые места). На «поехали» ассистент нажимает «Поехали» в Яндекс Навигаторе сам, на «построй маршрут домой» только строит маршрут
При включённом разделении экрана ассистент сначала свернёт его, построит маршрут и вернёт панели на место: иначе прошивка пересоздаёт Навигатор и маршрут теряется. Нужен включённый сервис специальных возможностей BYDMate
Скажите «в картах»: «поехали домой в картах», «найди заправку в яндекс картах» — маршрут, поиск и показ точки уйдут в Яндекс Карты, без этих слов маршрут идёт в навигатор, выбранный в настройке «Навигатор для маршрутов» (Настройки → Голос-агент → Агент), по умолчанию это Яндекс Навигатор, на выбор также 2ГИС, Яндекс Карты и Waze
«Найди зарядки рядом»
«Хватит ли заряда до Казани?», «Сколько ехать до аэропорта?»
«Запомни это место как дача», «Какие места сохранены?»
«Выведи навигацию на приборку», «Убери с приборки» (проекция Яндекс Навигатора)

Медиа и приложения

«Включи мою волну», «Включи джаз» (Яндекс Музыка)
«Включи на ютубе лекции по истории»
«Открой навигатор», «Открой камеры», «Открой регистратор», «Открой браузер» и другие приложения по русским именам

Автоматизация

«Запусти сценарий домой», «Какие у меня сценарии?»
«Выключи автоматизацию прогрева»
«Создай сценарий: когда приезжаю домой, открывай окна» (агент сам собирает правило из триггера и действий)

Интернет

«Какая погода?», «Какая погода в Москве завтра?»
«Поищи в интернете, когда выйдет обновление DiLink»

Управление машиной: каталог из 97 команд

Группа	Что доступно
Окна	все, передние, задние, водителя, пассажира, задние левое и правое; открыть, закрыть, наполовину, проветривание, для группы и для каждого окна по отдельности
Климат	включить, выключить, температура от 16 до 33
Подогрев сидений	водитель и пассажир, уровни 1-5 и выключение
Вентиляция сидений	водитель и пассажир, уровни 1-5 и выключение
Зеркала	обогрев вкл/выкл
Руль	подогрев вкл/выкл, на машинах с подогревом руля
Свет	салон, подсветка и другие режимы (6 команд)
Замки	запереть, отпереть
Люк и шторка	открыть, закрыть, промежуточные положения
Багажник	открыть, закрыть
Передний багажник	открыть, закрыть
Холодильник	охлаждение от -6 до +6, нагрев от 35 до 50, выключение
Аварийка	включить, выключить

Безопасность: открытие окон блокируется на скорости выше 120 км/ч, люка выше 80 км/ч, отпирание дверей выше 30 км/ч; передний багажник открывается только на стоящей машине.

Быстрые команды без агента и без интернета

Частые команды исполняются мгновенно, без языковой модели и без сети. Для этого в приложении есть закреплённый список русских фраз: окна и люк, подогрев и вентиляция сидений, подогрев руля, зеркала, климат, вентилятор, громкость, замки, багажник и свет.

Как это работает:

Фраза выполняется офлайн, только если сказана целиком и так, как в списке. Другая формулировка того же уходит агенту.
Вежливые слова не мешают: «пожалуйста», «можешь», «слушай», «спасибо» просто отбрасываются.
«A и B» выполняет обе команды, если каждая из них есть в списке: «открой окно водителя и закрой люк».
Окна и люк открываются на долю: «наполовину», «на 50 процентов», «чуть-чуть», «полностью», «на треть». Процент приводится к ближайшему поддерживаемому положению вниз, окно никогда не откроется шире названного.
Всё остальное уходит облачному AI-агенту, если он включён. Без агента такая фраза получает ответ «не понял», а фразы из списка продолжают работать.

Примеры фраз из списка. Полный список с вариантами формулировок: docs/VOICE_COMMANDS.md.

Фраза	Что произойдёт
«Открой окна»	все окна откроются полностью
«Открой окно на 50 процентов»	окно водителя наполовину
«Приоткрой окно водителя»	окно водителя на проветривание
«Режим проветривания»	все окна на проветривание, люк приподнимется
«Выключи режим проветривания»	окна и люк закроются
«Открой люк наполовину»	люк откроется наполовину
«Включи подогрев сиденья пассажира на второй уровень»	подогрев сиденья пассажира, уровень 2
«Включи подогрев руля»	подогрев руля
«Поставь температуру 22»	климат на 22 градуса
«Громкость 20»	громкость музыки 20
«Включи Яндекс Музыку», «Яндекс Музыка»	включает «Мою волну» в Яндекс Музыке
«Запри машину»	двери заперты

Английские офлайн-команды убраны, список только русский. Язык интерфейса на это не влияет: офлайн-команды и агент работают при любом языке приложения.

Ключи: что вводить, а что не обязательно

Ключ	Обязателен	Зачем
OpenRouter	Достаточно одного любого LLM-ключа; для скорости рекомендуется OpenRouter	Мозг агента. Быстрые модели (например, Gemini Flash) отвечают почти мгновенно, цена: доли цента за запрос
z.ai	Бесплатная альтернатива	Мозг агента, модель glm-4.7-flash, бесплатно, но отвечает заметно медленнее
Свой сервер	Альтернатива	Любой OpenAI-совместимый эндпоинт: URL, ключ, модель
Exa	Нет	Улучшенный веб-поиск. Без него «поищи в интернете» работает через нативный поиск LLM-провайдера
MiniMax	Нет	Только для онлайн-голоса MiniMax, на работу агента не влияет

Все ключи вводятся в приложении и хранятся локально, в коде и в репозитории секретов нет.

Голоса

Офлайн-голоса (работают без интернета, скачиваются по одному):

Голос	Род	Размер	Качество
Дмитрий (по умолчанию)	мужской	21 МБ	обычное
Алёна	женский	18 МБ	обычное
Руслан	мужской	21 МБ	обычное
Ирина	женский	21 МБ	обычное
Марк	мужской	145 МБ	улучшенное
Софья	женский	145 МБ	улучшенное

Марк и Софья (движок Supertonic) звучат заметно естественнее обычных, но весят больше и делят один архив: скачав любого, второго уже не докачиваете. Скорость и живость интонации настраиваются слайдерами, рядом кнопка «Прослушать пример».

Онлайн-голоса (опционально, звучат естественнее): Gemini и OpenAI через ключ OpenRouter, MiniMax через свой ключ (три способа подключения: официальный API, fal.run, replicate). Офлайн-подмены нет: если онлайн-голос не отвечает или падает, реплика остаётся текстом в пилюле-орбе, но не проговаривается.

Про громкость: ответы агента идут через голосовой канал BYD (тот же, что у штатных подсказок), его громкость регулируется системной настройкой голоса. Команда «сделай громче» меняет громкость музыки, а не голоса агента. Если агент кажется тихим или громким, крутите системную громкость голоса.

От чего зависит скорость ответа

Агент работает в три шага, и задержка копится на каждом.

Речь в текст. Целиком на устройстве, без сети. Скорость упирается в процессор головы.
Понимание фразы. Фразы из встроенного списка исполняются почти мгновенно. Всё остальное уходит в языковую модель: сколько она думает плюс пинг до провайдера. Это и есть основная задержка. Gemini Flash через OpenRouter отвечает за доли секунды, бесплатная glm-4.7-flash заметно медленнее.
Озвучка ответа. Офлайн-голоса лёгкие и быстрые, но время всё равно занимают. Онлайн-голоса медленнее: они тоже зависят от пинга.

Нужна максимальная скорость: выключите тумблер «Ответы агента». Озвучки не будет, реплика останется текстом на экране, а работать будут только первые два шага. Быстрые команды при этом исполняются вообще без интернета.

Характер агента

В настройках выбирается один из трёх характеров ответов (по умолчанию «Штурман») и род агента (мужской или женский), от этого зависят формулировки и устные реплики. Там же задаётся имя для перебивания.

Приватность

Звук с микрофона не покидает машину: распознавание речи полностью офлайн.
В облако (к LLM-провайдеру) уходит только текст: ваша фраза и данные, которые агент достал инструментами для ответа.
Голосовой журнал (последние 50 распознаваний с результатами, для самодиагностики) хранится только на головном устройстве и сохраняется между перезапусками. Он попадает в файл записи логов: что услышала магнитола, какой командой это стало и почему отказано. Экран журнала: Настройки → Голос-агент → «Журнал голоса», там видно, как фраза была распознана, куда ушла и чем закончилась.
Для проверки агента без микрофона есть текстовый чат (отладочный экран в настройках).

Отключение штатного помощника BYD

Внизу раздела «Голос-агент» есть тумблер, который отключает штатный голосовой помощник BYD, чтобы он не просыпался параллельно с агентом. Полностью обратимо, применяется после перезагрузки машины (и включение, и выключение). По умолчанию выключено.

Штатный помощник отключается в системе машины, поэтому перед удалением BYDMate выключите этот тумблер, иначе штатный помощник останется отключённым. Как вернуть штатного помощника, если BYDMate уже удалён: установите BYDMate снова, выключите тумблер и перезагрузите мультимедиа.

Требования

Место на диске: модель распознавания 226 МБ плюс голос озвучки (обычный 18-21 МБ, либо улучшенный Марк/Софья 145 МБ на двоих). Итого примерно от 245 до 370 МБ.
Интернет: нужен только AI-агенту (языковая модель), погоде, поиску и онлайн-голосам. Распознавание речи, быстрые команды и офлайн-голоса работают без сети.
Разрешения: микрофон (запрашивается при включении) и служба специальных возможностей для кнопки руля (включается автоматически).
Проверено на Leopard 3 (DiLink 5.0). Голосовая кнопка руля из коробки настроена под Leopard 3, на других моделях обучите свою кнопку в настройках.

Память о водителе

Скажите агенту, как вас зовут или что вы обычно предпочитаете, и он будет помнить это между разговорами. «Забудь …» убирает один факт. Список фактов и кнопка «Забыть всё»: Настройки → Голос-агент → Агент. Факты хранятся только на головном устройстве и уходят лишь в запрос к выбранной вами языковой модели.

Плавающий виджет

Компактный overlay 260×108 dp поверх других приложений — видно на карте, в медиа, в BYD-приложениях.

Что показано

Семь полей в 3 строки. Цвета: иконки серые, значения белые. Рамка и SOC% подсвечиваются цветом статуса (SOC или 12V — что хуже).

Верхняя строка (мелким, 13sp):

⏱ Длительность текущей поездки — N мин или X ч Y мин (напр. 47 мин, 1 ч 12 мин). Старт — момент включения зажигания, конец — выключение. Простои с включённой машиной (стоишь с кондиционером, пассажир вышел купить воды, светофор) входят в поездку — пока электрика жива, счётчик не сбрасывается
🚗 Температура в салоне — °C

Центральная строка (крупно, главные значения):

SOC % (18sp bold, цветной) — заряд тяговой батареи. Зелёный > 50%, жёлтый 20–50%, красный < 20%
~N км (28sp белым) — расчётный запас хода: SOC × ёмкость батареи ÷ baseline-расход × 100. Тильда подчёркивает что это оценка, не показания БК. Подробнее про то, как считается baseline-расход, ниже в разделе «Запас хода»
X.X ↓ (18sp, цветной по тренду) — расход текущей поездки, кВт·ч/100км, со стрелкой тренда (см. ниже)

Нижняя строка (мелким, 13sp):

🔋 Температура батареи — °C
⚡ 12V — напряжение бортовой сети, В. Норма 12.5–14.7 В, < 12.0 В = жёлтый, < 11.7 В = красный

Расход и стрелка тренда (правый блок)

Цифра справа — расход текущей поездки в кВт·ч/100км. Считается как энергия, потраченная с момента включения зажигания, делённая на пройденные с того же момента километры. По мере движения цифра сходится к тому значению, которое в итоге запишется в историю поездок: что видно в виджете в момент остановки, то и попадёт в карточку поездки.

Первые 2 километра виджет плавно переходит со среднего расхода прошлой поездки на расход текущей: до 300 м показывает прошлое значение, с 300 м до 2 км линейно подмешивает текущее, после 2 км показывает только текущее. Так не пугают резкие 50–60 кВт·ч/100км из холодного старта и разгона: пока поездка короткая, за основу берётся уже устоявшийся средний расход прошлой поездки, и только когда дистанция становится представительной, цифра уходит на собственный расход.

На стоянке (зажигание выключено) показывается средний расход прошлой завершённой поездки — то же значение, что было видно в её последний момент.

Запас хода ~N км считается по смеси: 50% веса берётся от последней завершённой поездки, 30% от предпоследней и 20% от той, что была до неё (короткие поездки до 3 км в расчёт не идут — это не репрезентативный пробег). Когда едешь длинную дорогу, к этой смеси добавляется ещё расход за последние 10 км текущей поездки: его доля растёт от нуля на первых трёх километрах до половины к 25 километрам. Так прогноз быстро подхватывает смену стиля (городской хвост перед трассой, обратно с трассы в город), но не дёргается на коротких заездах и стоянках с климатом.

Это автоматический расчёт. Если он вам не подходит, в Настройки → Авто и батарея → «Способ расчёта запаса хода» есть метод «Ручной»: своя таблица из 5 точек, температура батареи от +20 до -20 °C и расход при ней, опционально с запасом хода на 100% заряда.

Стрелка тренда появляется после 2 км пробега и сравнивает скользящее 25-километровое среднее с твоим обычным стилем (среднее по последним 10 поездкам):

↓ зелёная — едешь экономнее обычного
→ белая (стрелка прямая) — в пределах обычного
↑ жёлтая — расход выше обычного

Стрелка не дёргается от каждой остановки на светофоре — есть небольшая инерция: чтобы стрелка сменила цвет, расход должен заметно отличаться от обычного и держаться так минимум минуту.

Что такое «поездка» для этой цифры. Один цикл зажигания: включил → выключил. Стоянка с включённым кондиционером внутри поездки учитывается естественно — лишние кВт·ч попадают в общий знаменатель. Короткие блипы (светофор, переподключение) не раскалывают поездку на две. Если DiLink прибьёт приложение посреди трассы — после рестарта счёт продолжается с реального момента включения зажигания, а не с нуля.

Управление

Обычный тап — открыть BYDMate
Долгий тап (1.5 сек) — скрыть до следующего открытия BYDMate
Перетащить в корзину — выключить совсем
Включение, прозрачность, сброс позиции — в Настройки → Виджет

Разделение экрана

Два приложения на экране одновременно: одно занимает две трети, второе треть. Типичная пара - навигатор пошире, музыка или мессенджер поуже. Стороны меняются местами, приложения - на ходу, выбранная пара запоминается.

Включение

Откройте Настройки → Разделение экрана и включите тумблер «Разделение экрана 1/3 + 2/3».
Если под тумблером появилась надпись про перезагрузку - один раз перезагрузите головное устройство (долгое зажатие колёсика громкости). А если у вас уже включён режим проекции «Расширенный», перезагрузка не нужна: всё необходимое уже работает.

Пока функция выключена, приложение системных настроек машины не трогает. Выключение тумблера возвращает настройку к заводскому значению - если только оконный режим не нужен ещё и проекции «Расширенный»: тогда настройка вернётся к заводской, когда выключите и её.

Механизм разделения

В настройках, под тумблером, выбирается, чем делить экран: «Окна BYDMate» (по умолчанию) или «Родное разделение».

Окна BYDMate - те самые 1/3 и 2/3 с пилюлей управления, описанные ниже.
Родное разделение - делит экран сама прошивка машины. Этот вариант работает и там, где окна BYDMate недоступны (DiLink 5.1). Вид зависит от прошивки: где поддерживаются трети, открываются панели 1/3 и 2/3, на остальных экран делится пополам, а второе приложение выбирается системным окном.

На прошивках с новым интерфейсом UI7 выбор механизма не появляется: там разделение выполняет сама машина, панели 1/3 и 2/3 родные, перезагрузка головного устройства для включения не нужна.

Запуск

Три способа. Значок «?» рядом с заголовком секции в настройках напоминает о них прямо в машине.

С виджета (самый удобный). В настройках, в разделе «Тап по виджету», включите «Зонирование тапов», а в пункте «Действие левого тапа» выберите «Запускать разделение экрана». Теперь тап по левой трети виджета открывает разделение, повторный тап закрывает.
Из автоматизаций. В правилах есть три действия: «Разделение экрана», «Закрыть разделение экрана» и «Переключить разделение экрана». Можно, например, включать разделение при старте навигации.
Голосом. Скажите агенту «включи разделение экрана».

Первый запуск и выбор приложений

При первом запуске приложение спросит, что показывать: сначала выбирается приложение для широкой части (2/3), затем для узкой (1/3). Пара запоминается, следующий запуск открывает её сразу. Сменить приложения можно через пилюлю или в настройках; там же есть «Сбросить последнюю пару».

Пилюля управления

Пока разделение активно, внизу экрана висит маленькая пилюля. Тап по ней открывает меню: поменять стороны, поменять приложения, выбрать другое приложение для левой или правой панели, выход в обычный полный экран. Когда разделение закрывается, пилюля исчезает сама.

Как это уживается с остальным

Если поверх разворачивается что-то полноэкранное (задний ход, камеры, видео), разделение закрывается само. Вернуть его можно любым обычным способом - тапом по виджету или голосом.
Кнопка «Назад» из BYDMate возвращает к разделению.
Если запустить штатное разделение экрана DiLink, наше корректно завершится - два разделения одновременно не работают.

Зарядки

Вкладка Зарядки автоматически ведёт журнал реальных пополнений заряда: список зарядок по месяцам, статистика за период и за всё время, фильтры AC и DC. Не каждое подключение пистолета становится записью: запись создаётся только если SoC реально вырос. Если кто-то ткнул пистолет и вынул через минуту, в журнал ничего не попадёт.

Что засчитывается как зарядка

Запись пишется, если за время сессии у машины выросла либо ёмкость батареи, либо SoC. BYDMate пробует три источника данных по очереди и берёт первое пригодное значение:

Прирост ёмкости в кВт·ч, если бортовая система сообщила обновлённое значение.
Прирост SoC за активную сессию, переведённый в кВт·ч по текущей ёмкости батареи.
Грубая оценка по дельте SoC от полной номинальной ёмкости, если первые два варианта пустые.

Если BYDMate работает в момент зарядки, запись появляется сразу. Если подключение случилось до запуска приложения или машина уехала в глубокий сон, BYDMate догоняет запись на следующем старте, как только увидит, что SoC прыгнул вверх по сравнению с тем, что было до зарядки. Поэтому даже offline-зарядки в гараже попадают в журнал.

Как определяется AC или DC

Тип зарядки определяется по двум сигналам, по приоритету:

Тип разъёма от бортовой системы: gun-state 2 = AC, 3 или 4 = DC. На некоторых моделях BYD значение приходит не всегда, тогда работает следующий пункт.
Средняя мощность сессии: больше 15 кВт = DC, иначе AC. AC-зарядка физически не выдаёт больше 11 кВт, DC-станции стартуют от 22 кВт (CCS slow), поэтому порог 15 кВт уверенно разделяет два режима.

На вкладке Зарядки три фильтра: «Все», «AC», «DC».

Ручное добавление и редактирование

Если запись не появилась автоматически или цифры выглядят странно:

Кнопка + зарядка в шапке вкладки: добавить сессию вручную с указанием даты, длительности, кВт·ч, тарифа.
Долгое нажатие на запись: открывается меню «Изменить» / «Удалить». В режиме редактирования можно поправить любое поле уже сохранённой зарядки.

Функция в активном тестировании. На Leopard 3 пишется стабильно. На других моделях BYD автоматика может сработать неточно: например, бортовая система не сообщит мощность или тип разъёма, тогда AC и DC может определиться неправильно. В таких случаях правьте записи вручную и при возможности присылайте логи в Issues.

Тарифы и стоимость

Стоимость каждой зарядки и каждой поездки BYDMate считает сам. Чтобы цифры были честными, ему нужны две вещи: ваша цена киловатт-часа и дата, с которой эта цена действует.

Где задать тариф

Настройки → Авто и батарея → «Тарифы и периоды» → «Открыть». Откроется отдельное окно со списком периодов, настройки им не забиваются.

Период — это «с какой даты действует цена». У периода есть дата начала, цена дома (AC), цена на быстрых зарядках (DC), потери и правило расчёта поездок. Конца у периода нет: он действует до следующего периода или до сегодня, если следующего нет. Самый первый период покрывает всю историю до себя, поэтому старые поездки не остаются без цены.

Когда вы ставите тариф в первый раз (или обновляетесь со старой версии), BYDMate заводит один период «с начала истории» с вашими текущими цифрами. Пока вы не добавите второй период, всё работает как раньше.

Как поменять тариф задним числом

Цена выросла с 1 сентября, а вспомнили вы об этом 16-го? Ничего страшного.

Откройте «Тарифы и периоды» и нажмите «Добавить период».
В поле «Действует с» выберите 1 сентября.
Впишите новые цены и сохраните.

Всё, что произошло 1 сентября и позже, пересчитается автоматически: и зарядки, и поездки. Август останется по старой цене. Отдельной кнопки «пересчитать» нет и не нужно, пересчёт запускается сам при сохранении периода.

Так же работает и правка: если поменять цену в уже существующем периоде, пересчитается всё от его даты и до конца истории.

Потери на зарядке

В машину влилось 50 кВт·ч, а счётчик дома намотал 55. Разница уходит в зарядное устройство и нагрев: часть энергии до батареи просто не доезжает. Платите вы за 55, а BYDMate видит только 50, поэтому без поправки стоимость получается заниженной.

В каждом периоде есть два поля: потери AC и потери DC. По умолчанию 10% для домашней (AC) и 5% для быстрой (DC) зарядки — это типичные значения из замеров ADAC и исследований DLR: на медленной зарядке через бортовое зарядное устройство теряется порядка 10%, на быстрой постоянным током меньше, порядка 5%. Ток в машину идёт напрямую, поэтому и потерь меньше.

Стоимость считается так: сколько влилось в батарею, делим на (1 − потери) и умножаем на цену киловатт-часа. 50 кВт·ч при потерях 10% — это 55,6 кВт·ч оплаченных.

Как уточнить под себя. Запишите показания домашнего счётчика до и после зарядки, откройте карточку этой зарядки (долгое нажатие на запись → «Изменить») и впишите разницу в поле «Счётчик». Для этой зарядки BYDMate возьмёт вашу цифру вместо оценки. Когда таких зарядок наберётся несколько, в окне тарифов появится строка «Ваши потери по счётчику: AC …% , DC …%» — это средний процент по вашим замерам. Впишите его в поля потерь, и дальше все зарядки будут считаться по вашей реальной цифре.

Как считается стоимость поездки

В поездке нет чека, поэтому цену её киловатт-часов надо откуда-то взять. В периоде есть четыре правила на выбор:

Правило	Как считает	Кому подходит
Дом	По домашней цене периода	Заряжаетесь в основном дома. Это значение по умолчанию
DC	По цене быстрой зарядки периода	Дома не заряжаетесь вообще
Свой	По числу, которое вы вписали	Знаете свою среднюю цену и хотите зафиксировать её
По зарядкам	По фактической цене того, что залито в батарею	Заряжаетесь и дома, и на трассе, и хотите точности

Правило «По зарядкам» ведёт цену энергии в батарее: после каждой зарядки новая энергия смешивается с остатком, и цена становится средневзвешенной. Дешёвая ночная зарядка удешевляет киловатт-час, дорогая быстрая делает его дороже. Если перед поездкой зарядок ещё не было или последняя была больше 60 дней назад, BYDMate берёт домашнюю цену периода, чтобы поездка не осталась без стоимости.

Что не пересчитывается

Пересчёт никогда не трогает зарядки, где цену вы задали руками:

зарядка, добавленная кнопкой «+ зарядка» с указанием тарифа;
зарядка, у которой вы в карточке поправили тариф вручную;
зарядка, где вы вписали показание счётчика.

Это сделано специально: вы видели чек и счётчик, приложение нет. Такие записи остаются как есть при любой смене тарифов.

Как вернуть запись в общий расчёт. Откройте её карточку и нажмите «Считать по периоду». Показание счётчика и ручная пометка снимутся, стоимость пересчитается по тарифу и потерям периода, и дальше запись будет меняться вместе с остальными.

Сохранение конфигурации и Telegram-бот

Всё, что вы настроили и накопили, сохраняется одним архивом. Им можно вернуть данные после переустановки, перенести BYDMate на другую магнитолу или просто держать копию в Telegram.

Всё находится в Настройки → Сервис и данные → Данные → «Конфигурация».

Сохранить конфигурацию

В строке «Сохранить конфигурацию» нажмите «Сохранить».
В окне «Что сохранить» отметьте части:
- Таблицы: поездки, зарядки, статистика.
- Настройки машины и приложения: настройки, тарифы, автоматизации, места, виджет, голос.
- Ключи и токены: OpenRouter, ABRP, Telegram-бот и другие. По умолчанию не отмечены. Не отмечайте их, если отдаёте файл другому человеку.
Нажмите «Сохранить». Архив bydmate_backup_<дата>.zip появится в папке Download. Если подключён Telegram-бот, копия уйдёт и туда.
В окне «Сохранено» можно сразу нажать «Поделиться». В архиве история поездок, поэтому делитесь только с тем, кому доверяете.

Восстановить конфигурацию

В строке «Восстановить конфигурацию» нажмите «Выбрать файл». Откроется список архивов bydmate_backup_*.zip из папки Download, автоматические копии тоже там. Это свой список приложения, а не системный выбор файла, поэтому он работает и на прошивках, где системный выбор не даёт доступа к файлу.
Выберите архив.
В окне «Что восстановить» отметьте нужные части. Части, которых в архиве нет, выбрать нельзя. Неотмеченные части останутся как есть.
Нажмите «Восстановить». Выбранные данные заменятся содержимым архива, приложение перезапустится.

На чистой установке всё так же: поставьте BYDMate, положите архив в Download и восстановите его. Право показывать виджет поверх других приложений приложение вернёт само, если работает ADB. Что осталось сделать вручную, оно покажет в одном окне «После восстановления»: микрофон, контакты, модель распознавания речи, голос озвучки, перезагрузка магнитолы. Рядом с пунктами есть кнопки «Разрешить» и «Скачать».

Автосохранение

В строке «Автосохранение» выберите частоту: «Ежедневно», «Еженедельно» или «Ежемесячно». «Выкл» отключает автосохранение.
Чипами «Таблицы», «Настройки» и «Ключи» выберите, что попадёт в копию. По умолчанию таблицы и настройки, без ключей.

Копия делается при запуске машины, если с прошлой прошло больше выбранного срока. «Ежедневно» значит: при первом запуске машины, когда с прошлой копии прошли сутки. В Download хранятся 5 последних автоматических копий, более старые удаляются. Архивы, сохранённые кнопкой вручную, не трогаются.

Если подключён Telegram-бот, каждая копия приходит в ваш чат с ботом. Не получилось отправить из-за сети, приложение повторит отправку позже. Под строкой видно время последней копии и результат: отправлено в Telegram, сохранено локально или ошибка.

Как подключить Telegram-бот

Бот нужен свой: копии приходят только в ваш чат с ботом или в вашу группу, куда вы его добавили.

В Telegram откройте @BotFather, отправьте ему /newbot, придумайте имя и адрес бота. BotFather пришлёт токен: длинную строку вида 123456789:AA….
В BYDMate откройте Настройки → Сервис и данные → Данные, блок «Telegram-бот». Вставьте токен в поле «Токен бота» и нажмите «Проверить».
Приложение покажет короткий код из цифр. Откройте в Telegram чат со своим ботом и отправьте ему этот код. Код можно скопировать кнопкой «Скопировать код». Чтобы отчёты и копии приходили в общий чат, например всем, кто ездит на машине, добавьте бота в свою закрытую группу и отправьте там /start@имя_бота КОД.
Вернитесь в BYDMate и снова нажмите «Проверить». Бот пришлёт в чат сообщение «BYDMate подключён. Сюда будут приходить бэкапы.», а в блоке появится отметка «Подключён» с именем бота и чата.

Ошибки видны сразу под кнопкой: неверный токен, нет сети, код ещё не пришёл, файл больше 50 МБ и другие. Кнопка «Назад» на шаге с кодом возвращает к токену, «Отключить» забывает бота, и копии остаются только в Download.

Архив не зашифрован. Бот и чат должны быть только вашими. Если бот уже подключён к вебхуку или другой программе, Telegram не отдаст приложению сообщения с кодом: отключите вебхук.

Отчёт в Telegram при выключении машины

Тот же бот может присылать короткий отчёт каждый раз, когда вы выключаете машину. Удобно, чтобы видеть, где она стоит, сколько заряда осталось и всё ли закрыто.

Включается там же, в блоке «Telegram-бот»: переключатель «Отчёт при выключении машины». Ниже галочками выбираете, что попадёт в отчёт:

Место на карте: ссылка «Открыть на карте» в конце сообщения;
Заряд и Запас хода, как на Главной;
Пробег: общий пробег машины;
Поездка: километры, расход и время в пути последней поездки;
TRIP 1 и TRIP 2: счётчики с Главной, каждый отдельной галочкой. Счётчик, который ни разу не сбрасывали, идёт с пометкой «за всё время»;
Температура: снаружи и в салоне;
Что открыто: двери, окна, люк, багажник, капот. Если всё закрыто, так и написано;
Давление в шинах: все четыре колеса.

Отчёт уходит в первые секунды после выключения через мобильный интернет машины. Если связи нет, он придёт при следующем включении, с пометкой, когда данные записаны.

Тот же отчёт можно отправлять из автоматизации: действие «Отчёт в Telegram». В нём свой набор пунктов и, по желанию, свой текст под заголовком. Например, правило «въезд в зону Дом» может присылать заряд и что открыто.

Здоровье батареи (SoH)

SoH (State of Health) — это процент «здоровья» тяговой батареи, который рассчитывает сама бортовая система автомобиля по своим внутренним алгоритмам.

На BYD Leopard 3 (Fangchengbao Bao 3) BYDMate берёт это значение напрямую из бортовой системы и показывает в карточке батареи на Главной. Это реальный SoH от машины, а не оценка по разнице SoC: BYDMate просто читает то, что пишет себе сама машина.

На других моделях BYD доступ к этому значению пока не подтверждён, поэтому SoH там не отображается. Остальные ячейки карточки (температура батареи, 12V, разброс ячеек, сопротивление изоляции) работают на всех поддерживаемых моделях.

Тап по карточке открывает экран «Техника»: напряжение и ток тяговой батареи, остаток энергии батареи в кВт·ч по данным BMS, доступная мощность батареи, лимиты BMS на заряд и разряд, разброс ячеек, температуры моторов и инверторов, доля мощности перед/зад в процентах, климат, давление и температура шин, история SoH и пробега, число полных циклов заряда батареи с подписью, из какой суммы кВт·ч оно посчитано. У каждого параметра есть значок «?» с подсказкой простым языком. Если машина не отдаёт параметр, строка показывает «-», пустые карточки скрываются.

Если в вашей машине SoH доступен и вы хотите помочь добавить поддержку, заведите Issue с указанием модели и года выпуска.

SoH и автоматическая запись зарядок (Leopard 3)

SoH и автоматическая запись зарядок на Leopard 3 работают автоматически, отдельно ничего включать не нужно. BYDMate читает значения напрямую от бортовой системы автомобиля, как только активна беспроводная ADB-отладка.

Убедитесь, что ADB-отладка активна (см. раздел «Установка»).
SoH появится в карточке батареи на Главной, а зарядки начнут записываться автоматически с реальными значениями кВт·ч.

На Leopard 3 эти функции протестированы. На других моделях BYD доступ к этим данным не подтверждён, тогда SoH и точная мощность зарядок могут не появиться, но остальные функции BYDMate работают как обычно.

Если у вас не Leopard 3

BYDMate разрабатывается и тестируется на BYD Leopard 3 (Fangchengbao Bao 3). На других моделях BYD большинство функций тоже работает, но есть отличия. Перед первым запуском проверьте:

История поездок: на Leopard 3 (Fangchengbao Bao 3) BYDMate читает поездки из встроенной BMS-базы energydata. На моделях без этой базы (Song, Yuan и аналоги) поездки теперь записываются нативно, фоновым опросом параметров машины (источник NATIVE_POLLING), так что список больше не пустой. Расход в таких поездках считается по дельте SoC, поэтому он чуть грубее, чем на Leopard 3, где данные берутся из BMS.
Ёмкость батареи: по умолчанию 72.9 кВт·ч под Leopard 3. Зайдите в Настройки → Авто и батарея и поставьте свою ёмкость. Например, Atto 3 = 60.5 кВт·ч, Seal AWD = 82.5 кВт·ч, Han EV = 85.4 кВт·ч. Без этого расчёт запаса хода и стоимости поездок будет неточным.
SoH: подтверждён на Leopard 3 и на DiLink 3.0 (Yuan UP). На остальных моделях карточка «Здоровье батареи» работает без поля SoH.
Зарядки: алгоритм AC и DC проектировался под Leopard 3. На других моделях запись может появиться с задержкой или с неточной мощностью, особенно для DC. Используйте ручное добавление и редактирование, если автоматика промахнулась.
Автоматизация и плавающий виджет: работают одинаково на любой модели, потому что используют системный интерфейс машины.

Если что-то не работает или показывает странное, заведите Issue с указанием модели машины и версии прошивки DiLink - и приложите каталог параметров вашей машины: Настройки → Сервис и данные → «Сохранить каталог fid'ов». Файл fid-dump-….txt появится в папке Download. Внутри только технические идентификаторы параметров - без VIN, без геолокации, без личных данных.

Зачем это нужно. У разных моделей BYD наборы параметров различаются: команда, которая на Leopard 3 включает обдув сиденья, на Song может иметь другой номер или отсутствовать. Именно поэтому часть функций на других машинах не срабатывает. Каталог с вашей машины показывает, как параметры называются и нумеруются именно на вашей прошивке - и мы чиним по этим данным, а не вслепую.

Целевое устройство

Параметр	Значение
Платформа	DiLink 5.0 (Android 12, API 32)
Процессор	Snapdragon 780G
Экран	15.6" landscape, 1920x1200
GMS	Нет (AOSP без Google Play Services)
Протестировано	BYD Leopard 3 (Fangchengbao Bao 3)

Как работает

BYD energydata (BMS SQLite)  →  HistoryImporter    →  Room DB  →  Compose UI
autoservice (системный Binder) →  TrackingService   ↗     ↓
Android LocationManager     →  TripTracker (GPS)    ↗   LocalInsightEngine
autoservice (запись команд)  ←  AutomationEngine   ←  Rules (Room DB)

Данные	Источник
Расход, пробег, длительность	BYD energydata (BMS)
SOC, скорость, температуры	Системный сервис машины (autoservice Binder)
Напряжение ячеек, 12V, SoH	Системный сервис машины (autoservice Binder)
GPS координаты	Android LocationManager
AI-аналитика	Локальные правила на устройстве, без интернета
Управление авто	Системный сервис машины (запись команд)

Без OBD-адаптера и без стороннего D+. BYDMate читает данные и управляет машиной напрямую через системный сервис autoservice (тот же, что использует штатная система BYD) под shell-доступом по беспроводной ADB.

Данные и сеть

Функция	Куда уходит	Что уходит	Когда активно
Голосовой агент (LLM)	OpenRouter / z.ai / свой сервер	текст команды, состояние автомобиля (SOC, климат и т.п.), при навигационных запросах GPS-координаты	только после настройки провайдера
Веб-поиск агента	Exa / z.ai / OpenRouter	текст поискового запроса	ключ введён и агент вызвал инструмент
Погода (агент)	Open-Meteo	GPS-координаты или название места (геокодинг)	агент вызвал инструмент
Зарядные станции (агент)	Overpass (overpass-api.de / maps.mail.ru)	GPS-координаты	агент вызвал инструмент
Онлайн-голоса озвучки	MiniMax / fal.ai / Replicate / OpenRouter	текст озвучиваемого ответа	только если выбран онлайн-голос
Карта в деталях поездки	тайл-серверы OpenStreetMap (или Amap, если выбран в настройках)	координаты видимой области карты	при открытии карты поездки или редактора мест
Проверка обновлений	GitHub API	ничего (запрос списка релизов, сравнение версий локально)	автоматически
ABRP live-телеметрия	abetterrouteplanner.com	SOC, мощность, скорость, температуры, одометр, давление шин, статус зарядки, ёмкость батареи, SoH, кВт·ч текущей сессии зарядки, модель автомобиля (GPS намеренно не отправляется)	только после ввода токена
Копии конфигурации в Telegram	api.telegram.org, ваш бот	архив конфигурации выбранного состава и сообщение при подключении бота	только после подключения бота
Вебхук телеметрии	Настройки → Интеграции → Вебхук	тот же JSON, что в ABRP, POST на ваш URL раз в 1/8/30 с (движение/зарядка/стоянка); координаты только по отдельному тумблеру	выключен по умолчанию

Без введённых ключей наружу уходят только проверка обновлений (GitHub) и тайлы карты при просмотре маршрута поездки, а также скачивание голосовых моделей по явному запросу пользователя (github.com). API-ключи хранятся локально в базе приложения и никуда не передаются, кроме самого провайдера.

Установка

1. Активация ADB

Без ADB BYDMate работает как офлайн-журнал поездок: история из штатной базы, карта маршрута, сохранение конфигурации, AI-инсайты по уже накопленным данным.

Включённая ADB-отладка нужна для всего, что читает или пишет параметры машины: живые показатели в виджете и на дашборде (SOC, запас хода, температуры, 12V), SoH, автоматический журнал зарядок, автоматизация, вывод на приборку, разделение экрана, подсказки на HUD, камеры слепых зон, управление машиной голосом и запись логов.

Строка состояния ADB. На Главной и в Настройках строка состояния показывает, почему не работает управление машиной: ADB не включён, ADB выключился после перезагрузки, нет доступа к ADB или не запустился помощник. По нажатию открывается подсказка с действием. В мастере первого запуска есть шаг «ADB» с кнопкой «Проверить».

Эти фичи включаются автоматически, отдельный переключатель не нужен. При первом запуске BYDMate DiLink один раз покажет диалог «Allow ADB debugging» — нажмите Allow и поставьте галочку «Always allow from this computer», чтобы он не спрашивал заново.

DiLink 3 / 4 — ADB можно активировать самостоятельно: установите BydDevelopmentTools, зайдите в Настройки → Version Management, 10 раз тапните по тексту Reset to factory default, активируйте Debug Mode when USB is Connected и Wireless adb debug switch. На обновлённых прошивках DiLink 3/4 ADB может быть так же закрыт, как на DiLink 5 — тогда придётся идти по пути ниже.
DiLink 5.0 — ADB-отладка заблокирована и открывается только удалённо из Китая. Сделать это можно через продавцов на TaoBao (поиск по DiLink 5.0, ~40 ¥ внутри Китая / ~80 ¥ извне, оплата через AliPay). Продавец удалённо открывает инженерное меню по присланному QR-коду, после чего ADB включается штатно.

Пошаговая инструкция: PDF-гайд (русский) — приложен в репозитории.

ADB отключается после каждой перезагрузки

На прошивках DiLink с лета 2026 (сборки «2606») порт ADB закрывается при каждой перезагрузке головного устройства, и все функции управления машиной перестают работать до ручного включения ADB. Для таких машин в Настройках → Система машины есть тумблер «Восстанавливать ADB после перезагрузки» (по умолчанию выключен): приложение поднимает ADB заново через встроенную в Android беспроводную отладку. Рядом с тумблером есть значок «?» с подробным объяснением, а под ним строка состояния.

Что нужно знать:

Wi-Fi в машине должен быть включён и подключён к сети (домашней, к раздаче с телефона, любой). Без Wi-Fi Android не даёт включить беспроводную отладку, обойти это нельзя.
При первом включении на каждой новой сети на экране появится системный диалог «Allow wireless debugging on this network?». Когда тумблер восстановления включён, приложение подтверждает его само через свою службу специальных возможностей: на раздаче с телефона сеть меняется при каждом включении, и «Always allow on this network» там не помогает. Если служба специальных возможностей BYDMate выключена, отметьте «Always allow on this network» и нажмите ALLOW.
Один раз, пока ADB ещё работает, приложение выдаёт себе системное разрешение WRITE_SECURE_SETTINGS (одной командой через ADB). Без него включить беспроводную отладку нельзя: строка состояния покажет «Нужна активация».
После загрузки приложение само повторяет попытки, пока Wi-Fi подключён, и реагирует на разблокировку экрана. Обычно ADB возвращается через 10–30 секунд после того, как машина подключилась к Wi-Fi. Удобнее всего, если раздача с телефона уже включена к моменту запуска машины.
Если на вашей прошивке ADB и так переживает перезагрузку, включать тумблер не нужно: строка состояния покажет «Не требуется».
Проверено на DiLink 5.0 (Song L) с прошивкой августа 2026.

2. DiPlus (D+) больше не нужен

Начиная с версии 3.0.0 BYDMate работает напрямую с системой машины и не требует стороннего приложения D+ (迪加). Все данные читаются и команды отправляются через системный сервис автомобиля.

Если вы пользовались прежними версиями и устанавливали D+, после проверки работы BYDMate его можно удалить с DiLink.

3. Установка BYDMate

Скачайте BYDMate APK из Releases
Перенесите на DiLink: через USB-флешку, по сети, или через ADB (adb install BYDMate.apk)
Разрешите установку из неизвестных источников, если потребуется

4. Первый запуск

Откройте BYDMate — появится мастер настройки
Выдайте разрешения на локацию и хранилище. По мере включения функций приложение попросит ещё: микрофон для голосового агента, камеру для камер слепых зон, контакты для звонков по имени, показ поверх других приложений для виджета и уведомлений, доступ к статистике использования для определения активного приложения Постоянное уведомление BYDMate в шторке убрать нельзя (Android требует его для работы в фоне), но его можно сделать тихим: Настройки → Сервис и данные → «Тихое уведомление в шторке».
Укажите тарифы на электроэнергию (для расчёта стоимости поездок). Позже их можно поменять задним числом, см. раздел «Тарифы и стоимость»
В Автоматизации доступен вид действия "Охранный режим": включает или отключает охранный режим BYD (Centuri/Sentry) напрямую через системную настройку, минуя диалог подтверждения штатного приложения

5. Фоновая работа

Важно: отключите "Disable background Apps" для BYDMate, иначе DiLink будет убивать приложение:

DiLink > Settings > General > Disable background Apps > BYDMate = OFF

6. Настройка (опционально)

В Настройках можно изменить:

Ёмкость батареи — по умолчанию 72.9 кВт·ч (Leopard 3)
Тарифы и периоды — цена дома (AC) и на быстрых зарядках (DC), потери, правило расчёта поездок и валюта. Подробно в разделе «Тарифы и стоимость»
Пороги расхода — границы для цветовой индикации (зелёный/жёлтый/красный)

Система машины

В Настройки → Сервис и данные → Система машины два пункта, которые меняют поведение самой машины, а не приложения.

Колёсико громкости на руле. Тумблер, при котором нажатие ставит воспроизведение на паузу и продолжает его, а не переключает источник звука. Нужен после обновления прошивки, где нажатие стало менять источник. По умолчанию выключено.

Язык интерфейса машины. Только на прошивках UI7. Кнопка открывает скрытый штатный диалог BYD с полным списком языков, включая русский, украинский и польский. Язык меняет сама прошивка, приложение ничего не записывает. У части владельцев на русском перестаёт работать автопарковка, тогда верните English той же кнопкой.

AI Инсайты

Карточка на дашборде анализирует вашу статистику за последние 7 дней (сравнение с предыдущими 7) и показывает заголовок, краткий вывод, таблицу метрик и до 5 рекомендаций. Работает без интернета.

Всё считается прямо на устройстве по данным поездок и батареи. Обновляется сама раз в день, результат кэшируется. В развёрнутом окне карточки период переключается между неделей и месяцем.

Откуда берутся данные

Всё считается из локальной базы Room — без GPS, маршрутов и персональных идентификаторов:

Поездки — км, кВт·ч, средний расход, скорость, короткие поездки (< 5 км), лучшая/худшая по расходу, стоимость
Простой с мотором — кВт·ч и часы (idle_drains)
Ночной простой — сессии, начавшиеся в 22:00–06:00
Зарядки — AC/DC кВт·ч, число сессий, цена за кВт·ч, общая стоимость за неделю
12V — текущее напряжение и тренд за неделю (история до 7 дней)
Ячейки — разброс max−min в мВ из live-данных машины
Температура — средняя наружная по поездкам

Минимум для анализа: не менее 5 поездок за последние 7 дней. Иначе карточка покажет «Мало данных для анализа».

Как устроена карточка

Заголовок и summary — одно главное сообщение недели. Выбирается правилом с наивысшим приоритетом (см. ниже).
Dynamics — таблица «неделя к неделе»: расход, поездки, % коротких поездок, средняя дистанция, простой с мотором, ночной простой.
Рекомендации — до 5 bullets из подходящих правил, отсортированных по важности.

Логика движка — LocalInsightEngine.kt: детерминированные пороги + шаблоны строк (local_insight_* в strings.xml). Тексты локализованы на 6 языков (ru / en / zh / pt / pl / be).

Приоритет заголовка

Что важнее — то и в заголовке. Первое сработавшее правило с большим priority:

Приоритет	Условие	Пример заголовка
90	12V < 11.8 В	«12V критично низкий»
85	Разброс ячеек > 50 мВ	«Большой разброс банок»
80	Расход ↑ > 15% к прошлой неделе	«Расход ▲15% за неделю»
78	Ночной drain ≥ 4 кВт·ч и ≥ 35% простоя	«Ночной расход на стоянке»
70	Расход ↑ > 5%	«Расход ▲8% за неделю»
60	Расход ↓ > 5%	«Расход ▼10%»
10	Иначе	«Расход стабилен»

ABRP — Live телеметрия

BYDMate может отправлять живые показатели машины в A Better Route Planner (ABRP) через официальный Iternio Telemetry API. ABRP использует эти данные, чтобы план маршрута и оценка остатка хода обновлялись по реальному состоянию батареи, а не по средним табличным значениям.

Функция опциональная, выключена по умолчанию и включается вручную в Настройках.

Как получить токен

ABRP использует «Generic Live Data Token» — отдельный токен на каждую машину в гараже:

Откройте abetterrouteplanner.com и войдите в аккаунт.
Перейдите в гараж и откройте машину, на которой хотите видеть live-данные. Машина должна быть сохранена в гараж, иначе токен не появится.
Шестерёнка «Настройки автомобиля» → раздел «Данные» → кнопка «Подключить актуальные данные».
В списке провайдеров выберите «Generic» и нажмите «Привязать». Появится длинная строка-токен — это и есть User Token.

Если в списке нет «Generic»: смените код модели машины в гараже ABRP на любую популярную модель BYD (например, BYD Atto 3 или BYD Seal), сохраните, и Generic появится. После привязки токена код модели можно вернуть обратно.

Настройка в BYDMate

Настройки → Интеграции → раздел «ABRP — телеметрия».
Вставьте полученный токен в поле «Токен живых данных из ABRP».
Больше ничего настраивать не нужно: интервал отправки подбирается сам, секунда в движении, 8 секунд на зарядке, 30 секунд на стоянке. Полей «интервал» и «код модели» из старых версий больше нет.
Нажмите «Сохранить ABRP», затем включите переключатель «Живые данные → A Better Route Planner». Без сохранённого токена переключатель остаётся неактивным.
ABRP-приложение на DiLink (или браузер на телефоне) теперь будет видеть актуальный SOC, мощность, температуры, заряд.

Что отправляется

Только агрегированные показатели машины, без идентификаторов:

SOC — текущий процент заряда тяговой батареи
Speed — скорость, км/ч
Power — текущая мощность тяги; на зарядке — мощность зарядки по напряжению и току со знаком минус, как требует Iternio
Voltage / current — напряжение и ток тяговой батареи
HVAC setpoint — заданная температура климата
Battery / cabin / exterior temp — температуры батареи, салона и за бортом
Capacity — номинальная ёмкость батареи
Odometer — пробег, км
Tire pressures — давление в шинах (4 колеса)
is_charging / is_parked — флаги состояния
is_dcfc / kwh_charged — тип зарядной станции (DC vs AC) и количество кВт·ч в текущей сессии
soh — реальный SoH батареи (Leopard 3)

Что НЕ отправляется

GPS-координаты не передаются. ABRP запускается как отдельное приложение Android прямо на DiLink и читает геопозицию из ОС сам. Когда координаты приходили ещё и от BYDMate, машина на карте ABRP прыгала между двумя источниками, поэтому с версии 3.16 их отправка убрана совсем, вместе с настройкой. Для вебхука тумблер координат остался.
Не отправляются: VIN, идентификатор устройства, история поездок, маршруты, пользовательские настройки.

Как ABRP считает остаток хода

ABRP подбирает прогноз на основе модели машины из своей библиотеки + телеметрии: текущий SOC, температура батареи, скорость движения, ветер, профиль дороги, перепады высот. Свой собственный «расчётный остаток хода» BYDMate в ABRP не передаёт — у ABRP есть собственный, более точный расчёт под конкретный маршрут, в котором учитывается погода и рельеф.

Вебхук: те же данные на свой сервер

Тот же JSON, что уходит в ABRP, можно отправлять POST-запросом на свой адрес: Home Assistant, Node-RED, свой скрипт на VPS. Ничего не хранится в очереди: если сервер недоступен, точка теряется, следующая попытка через минуту.

Настройка

Настройки → Интеграции → раздел «Вебхук — телеметрия».
URL: только https://. Обычный http:// не пройдёт (Android блокирует незашифрованный трафик, разрешён он только для localhost). Если сервер без сертификата, поставьте перед ним Caddy или nginx с Let's Encrypt, либо туннель вроде Cloudflare Tunnel.
Секрет (необязательно): строка, которая уйдёт в заголовке Authorization: Bearer <секрет>. По нему сервер отличает вашу машину от чужих запросов.
«Отправлять координаты на вебхук»: по умолчанию выключено. Включайте только если сервер ваш: в JSON добавятся lat, lon, heading.
Нажмите «Сохранить вебхук», затем включите переключатель «Живые данные → свой сервер».

Что приходит

POST <ваш URL>, Content-Type: application/json, одна точка в теле:

{"utc":1756040000,"soc":67,"speed":52.0,"power":18.4,"batt_temp":29.0,"ext_temp":24.5,
 "capacity":72.9,"odometer":12345.6,"cabin_temp":22.0,
 "tire_pressure_fl":2.5,"tire_pressure_fr":2.5,"tire_pressure_rl":2.4,"tire_pressure_rr":2.4,
 "is_charging":0,"is_parked":0,"soh":98.5,"car_model":"byd:leopard3"}

Поля и единицы те же, что в Iternio Telemetry API: utc в секундах, power в кВт (как отдаёт машина), температуры в °C, давление шин в бар, odometer в км. Поля без данных (например, speed на стоянке или kwh_charged вне зарядки) просто отсутствуют. Ритм: раз в секунду в движении, раз в 8 секунд на зарядке, раз в 30 секунд на стоянке. Ответ сервера не разбирается, важен только статус 2xx; после ошибки следующая попытка через 60 секунд.

Вебхук работает независимо от ABRP: можно включить только его, только ABRP или оба.

Сборка из исходников

# Требуется: JDK 17, Android SDK 34
git clone https://github.com/AndyShaman/BYDMate.git
cd BYDMate
./gradlew assembleDebug

Стек технологий

Kotlin 2.1 + Jetpack Compose + Material 3
Room (SQLite) + Hilt (DI) + OkHttp
osmdroid (OpenStreetMap) + Coroutines/Flow
Min SDK 29 / Target SDK 29 / Compile SDK 34

Что делать при ошибках

Если что-то не работает, действуйте по шагам — в большинстве случаев проблема решается первым же пунктом, а если нет, вы поможете нам быстро её найти.

1. Перезагрузите головное устройство. Зажмите колёсико громкости и держите, пока экран не уйдёт в перезагрузку. Часть функций (например, разделение экрана) включает системный флаг, который применяется только при загрузке — без перезагрузки функция выглядит «сломанной», хотя всё в порядке.

2. Запишите логи. Настройки → раздел «Сервис и данные» → кнопка «Запись логов». Воспроизведите проблему (нажмите то, что не работает), затем нажмите «Остановить запись». Файл bydmate_logs_<дата>.txt появится в папке Download (запись останавливается сама через 2 часа, если забыли).

3. Сохраните каталог fid'ов. Настройки → раздел «Сервис и данные» → кнопка «Сохранить каталог fid'ов». Файл fid-dump-<дата>.txt появится в Download. У разных моделей BYD разные каталоги команд — по этому файлу мы адаптируем приложение под вашу машину.

4. Отправьте нам. Создайте задачу в GitHub Issues и приложите: модель машины и поколение DiLink, версию BYDMate, что нажимали и что ожидали увидеть, файлы из шагов 2–3.

Типовые случаи:

Не работает разделение экрана или проекция на приборку — перезагрузите головное устройство (шаг 1).
Команда выполняется, но машина не реагирует (окна, люк, климат) — скорее всего, у вашей модели другой каталог команд: пришлите логи и каталог fid'ов (шаги 2–4).
После обновления что-то сломалось — перезагрузите головное устройство; если не помогло, пришлите логи.
Кнопка «Тест модели» серая или в ответе ошибка — ключ языковой модели не сохранён или сервер не отвечает: проверьте его в Настройки → Интеграции → AI подключения.
Кнопка руля не реагирует — назначьте её заново (Настройки → Голос-агент → «Назначить кнопку») и проверьте, что службе специальных возможностей BYDMate выдано разрешение.
Агент отвечает текстом, а не голосом — включите тумблер «Озвучивать ответы агента» и скачайте голос (раздел «Ответы агента»).
Голос агента еле слышно — он идёт по системному каналу Voice, его громкость крутится отдельно от музыки: кнопками громкости во время ответа или в настройках звука машины.
«Тест модели» проходит, а в разговоре агент отказывает — пришлите логи в Issue и укажите, какое подключение и какая модель выбраны.

Благодарности

BYD Trip Info (org.jayb.bydapp) by jayb — оригинальное приложение для DiLink, вдохновение для BYDMate
DiPlus (迪加) by Van Design — приложение-мост к данным автомобиля, использовалось в ранних версиях BYDMate (с 3.0.0 больше не требуется)
Weather data by Open-Meteo.com
@klimuts - подсказал механизм auto_container для вывода навигатора на приборку
@RBGboost - реверс протокола SOME/IP заводского HUD и исходная реализация YandexHUD. Вывод подсказок Яндекс Навигатора на проекционный дисплей в BYDMate - его код и его заслуга. Поблагодарить можно в Telegram: @RBGboost
byd-turnsignal-cameraview by sunlixWhyNotAvailable — открытое исследование интерфейсов камер и окон DiLink, на котором основана функция камер слепых зон при поворотнике. Реализация в BYDMate написана с нуля, но его разбор сэкономил недели реверс-инжиниринга — спасибо!
danijar2000 — фикс проекции 2GIS на приборку (2GIS завершался при переносе на дисплей приборки)

Поддержать проект

Проект некоммерческий, делаю как хобби. Если захочется поблагодарить, реквизиты в SUPPORT.md. Если нет, всё равно спасибо за доверие.

Лицензия

PolyForm Noncommercial 1.0.0 — исходный код открыт, только некоммерческое использование. См. LICENSE для деталей.

English version: README.en.md

rukamori/ArchiveTune

🌸 The Cutest Music Player With Support Local File and Youtube Music for Android!

https://archivetune.koiiverse.cloud

ArchiveTune

Redefining the YouTube Music Experience on Android.
It’s high-performance, privacy-focused, and packed with features for people who really care about their experience.

Official Website • Features • Privacy • Download • Screenshots • Support

Warning

Forks are not supported in any way.
We do not provide support, maintenance, troubleshooting, or assistance for any forked version of this project. If you choose to use a fork, you do so at your own risk.

ArchiveTune isn’t just another generic YouTube Music wrapper. It’s a fully custom-built player made with kotlin and jetpack compose, because we think your music should stay private, look clean, and work exactly the way you expect.

Important

Geographic Availability: If YouTube Music is not supported in your region, a VPN or proxy set to a supported region is required for initial data fetching.

📸 Showcase

✨ Features

Playback Multiple account support with quick switching Ad-free playback with background listening Your playlists, liked songs, and subscriptions appear after sign-in Support local file and local song playback Fast startup and lightweight performance Built for a private, uninterrupted listening experience	Audio EBU R128 loudness normalization Tempo, pitch, and playback speed controls Crossfade between tracks System equalizer and spatial audio integration
Lyrics & Discovery Live synced lyrics Lyrics translation, AI Lyrics translation and romanization Music recognition for songs around you Listening statistics whenever you want them	Sync & Social Import playlist from spotify YouTube Music account integration Last.fm scrobbling ListenBrainz history sync Discord rich presence support
Interface Material 3 design language Album-art powered dynamic colors Up to 9 different player styles Up to 8 different player background styles Responsive layouts for different screen sizes Clean browsing, player, artist, album, and lyrics views	Customization Deep playback and interface settings Dynamic color theming options Gesture customization Animation and layout tuning Flexible controls to shape the app around your workflow

📥 Download Now

Stable Release

Obtainium	IzzyOnDroid

GitHub

OpenAPK	Unclouded

Development Build

GitHub Actions

Nightly Build

GitHub Releases

Warning

Notes: The trusted download source is listed above; we are not responsible for any risks you may encounter from downloading from other sources.

❓ Need Help or Have Questions?

Join Our Telegram Channels or Discord Servers for Support and Discussion.

🌍 Globalization

ArchiveTune belongs to everyone. Help us localize the experience for your region.

✨ Project Contributors

🛠️ Development & Engineering

Interested in building the project or contributing? ArchiveTune is built on a high-performance Kotlin stack. Read the Build & Contribution Guide →

Open-Source Acknowledgments

ArchiveTune is made possible by the work of many open-source projects and communities:

Metrolist by Mostafa Alagamy for the base framework.
SimpMusic by maxrave-dev for the lyrics API provider.
BetterLyrics for word-by-word lyrics, unison and artwork provider support.
Material Color Utilities
Read You and Seal for UI component inspiration.
Translators, beta testers, contributors, and community members who continue to support the project.

⚖️ Legal Disclaimer

ArchiveTune is an independent third-party client.

Not affiliated with Google LLC or YouTube.
Does not bypass YouTube's technical protections.
Users are encouraged to support artists by purchasing music via official channels.

⚖️ License, Copyright, and Trademark Notice

ArchiveTune is licensed under the GNU General Public License v3.0 (GPLv3).

You may copy, modify, and redistribute the source code, including commercially, provided that you comply with the GPLv3. This includes preserving applicable copyright and license notices, clearly identifying modified versions, and providing the corresponding source code when required.

The ArchiveTune™ name, logo, application icon, and official branding are not licensed under the GPLv3. Unofficial forks must not present themselves as official ArchiveTune releases or imply endorsement by the ArchiveTune maintainers.

See the LICENSE file for the complete GPLv3 terms.

If ArchiveTune elevated your music experience, please consider giving us a ⭐

andreknieriem/open-headunit

Headunit App for displaying Android Auto

https://headunit.andrerinas.com/

Open Headunit

Open Headunit is an Android app that allows you to turn your Android tablet or phone into an Android Auto receiver. This project is a revived version of the original headunit project by the great Michael Reid. The original project can be found here: https://github.com/mikereidis/headunit

NOTE!

Android Auto 17.4 and newer can prevent legacy wireless triggers from launching projection, including Self-Mode and automated startup via Wireless Helper. Rooted devices have a workaround: re-enable Android Auto's wireless startup receiver. Choose from the five options below according to your Android Auto version and setup:

USB Wireless Android Auto Dongle (Recommended): Hardware dongles provide seamless, hardware-level plug-and-play.
Native Mode: Direct Wi-Fi Direct or Headunit Hotspot handshake.
Headunit Server (Developer Mode): An option for wireless projection and Self-Mode without root. On the device running Android Auto, open its developer settings and tap "Start Headunit Server".
Wireless Helper: The legacy startup flow works with Android Auto up to 17.3; for 17.4+ on rooted devices, see option 5.
Root workaround (AA 17.4+): Re-enable WirelessStartupReceiver with one root command to restore the previous wireless startup flow, including Wireless Helper, without starting the developer headunit server. See the command and setup below.

Screenshots

How to use

Check out the Wiki for detailed documentation, setup guides and troubleshooting!

Wired USB Connection

Connect your Android device (phone) to the tablet running Open Headunit via USB cable.
Make sure that Android Auto is installed on your phone.
Set your phone to Host-Mode if nescessary and select Android Auto
Click the USB Button in Open Headunit, find your phone and click the right button to allow connection
Click on your phone in the list and wait for Android Auto to start

Wireless Connection Options

Choose from the five options below depending on your Android Auto version and setup:

1. USB Wireless Android Auto Dongle (Most Reliable)

A standard hardware USB Wireless Android Auto Dongle (plugged into the headunit) handles the entire wireless negotiation independently.
Provides seamless plug-and-play connection regardless of phone Android Auto version.

2. Native Mode (Wi-Fi Direct / Headunit Hotspot)

Directly communicates with Android Auto's native wireless protocol without helper apps.
Supports Wi-Fi Direct (P2P) or the Headunit Hotspot transport.
Configure under Open Headunit Settings -> Android Auto Mode -> Native Mode.

FYT external Bluetooth module transport (experimental)

On FYT units where the phone pairs for calls with a separate Bluetooth module (for example DUDUAUTO on DUDUOS), Native Mode can carry its Android Auto Bluetooth handshake through /dev/auto_serial, the relay the stock Car Link app (com.syu.carlink) uses, while calls remain on the module and the vehicle microphone/speakers. Tested so far only on DUDUOS with a BLINK module.

Requirements:

An FYT unit that exposes /dev/auto_serial (Car Link's external-module backend, sys.fyt.bluetooth_type above zero).
Nothing extra where the node is app-openable, as it is for the stock Car Link. Where it is not (node mode or SELinux), root access for Open Headunit, used as a fallback.
The stock com.syu.carlink package disabled, because two readers on the same terminal split protocol messages.
The phone paired with the module; pairing and phone priority remain managed by the module.

Setup:

Disable the stock client: adb shell pm disable-user --user 0 com.syu.carlink (prefix with su -c if the shell refuses).
In Open Headunit, select Native Mode and enable Connect through the FYT external Bluetooth module.
Keep the phone paired with the module and connect normally.

On a detected FYT module unit with this transport off, Native Mode refuses to start and names this setting, instead of listening on a radio the phone is not paired with. If the channel cannot be opened (Car Link still enabled or running, or the node not app-openable and root denied), the reason is shown on screen and retried with a growing delay.

Android Bluetooth driver selection, preferred-phone and wake-list controls are intentionally hidden on this route because Android cannot see or dial phones bonded to the external module. To roll back, turn this transport off and re-enable the stock client with adb shell pm enable com.syu.carlink (prefix with su -c if needed).

3. Headunit Server (No-Root Option for Self-Mode on AA 17.4+)

Starts the native Android Auto developer server directly on your phone or on the same device (Self-Mode).
Setup:
1. Open Android Auto settings on your phone (or tablet in Self-Mode).
2. Scroll down and tap Version 10 times to unlock Developer settings.
3. Tap the three-dot menu in the top right corner and choose Start headunit server.
4. In Open Headunit, tap the WiFi button to connect (or use Self-Mode).

4. Wireless Helper

Our companion app triggers the wireless connection automatically in the background.
Compatibility: Android Auto v17.3 and below, or v17.4+ with the root workaround in option 5.
Download: Wireless Helper on Google Play Store
Setup: Set Open Headunit Wireless Mode to Helper Mode, ensure both devices are in the same network or Wi-Fi Direct group, and start the service in the Wireless Helper app.

5. Root Workaround for Android Auto 17.4+

On the device running Android Auto (normally the phone), open a root shell, for example by running su in a terminal and granting root access. Then run:

pm enable --user 0 \
com.google.android.projection.gearhead/com.google.android.apps.auto.wireless.setup.receiver.WirelessStartupReceiver

Re-enabling this receiver restores the previous wireless startup flow on affected Android Auto versions. Keep using the same Wireless Helper / Helper Mode setup as before; the developer headunit server is not required for this workaround. Root is needed on the device running Android Auto, not on a separate head unit.

--user 0 targets the primary Android user. This is an internal Android Auto component: the workaround requires it to exist in the installed version, and future updates may change its name or behavior.

Connect Wirelessly via Intent (Power Users)

You can trigger a wireless connection attempt using an Android Intent. This is useful for automation tools like Tasker, MacroDroid, or via ADB.

URI Scheme: headunit://connect?ip=<PHONE_IP>

Example ADB Command:

adb shell am start -a android.intent.action.VIEW -d "headunit://connect?ip=192.168.1.25"

Known Issues

Google Maps in Portrait Mode: Touch interactions (searching, scrolling) within Google Maps may not work as expected when using Portrait Mode on some devices. Fix: Try reducing the Pixel density (DPI) setting to below 200 (e.g., 190) in the app settings. This often restores full functionality.
Wireless Connection Drops: If the connection drops frequently, disable "WiFi Assistant" or "Switch between networks" in your phone's WiFi settings to prevent it from killing the connection due to "no internet." Check battery saving options.
Self-mode on Android 10 (Q) and below: Google has disabled the automatic wireless projection startup for Android 10 and below in Android Auto versions 16.4 and higher. While Self-mode still works on newer Android versions, it is normally impossible to trigger projection on Android 10 and below directly with recent Google app updates. Workaround: You can still use Self-mode on these devices by starting the built-in Android Auto Headunit Server and connecting via Wi-Fi mode (loopback). See the Troubleshooting Guide for step-by-step instructions.
WiFi-Direct needs long to connect: A user finds that this is related to Google Assistant instead of Gemini for AA. If you use Gemini on newer AA versions it just runs smooth again. No idea why this happens.
Stuck on Android is starting Check your video codec in the settings and set it to h264 if you have a device which does not support h265. Some devices have a broken h265 decoder and this will cause the app to stuck on "Android is starting" and never start the projection.

Planned

more customization options for the UI and the app itself
Info/Help descriptions to the settings for better understanding

Changelog

v.3.5.0-beta4

Native AA: reconnect to a network that is still there, instead of rebuilding it every time
Native AA: wake the phone over the Bluetooth module on a cold start, and from the WiFi button
Native AA over hotspot: stop advertising an endpoint that moves, bring the hotspot back after a boot or ACC wake- #1014
Native AA: recover when the platform deletes the group mid-join, bring the hotspot back after sleep, log the Bluetooth link, and stop a QR crash below Android 4.4
Added: Option to use Open Headunit as a launcher, thanks to @amp3r1 for some improvements
External Bluetooth module: make the WiFi button work, find the module after a boot, and keep a Bluetooth auto-start from being lost behind the settings screen
Added: Simplified Chinese 🇨🇳, Indonesian 🇮🇩, Hindi 🇮🇳, Thai 🇹🇭, European Portuguese 🇵🇹
Connection: one attempt at a time, hold auto-connect behind settings and the pill's X, and fix the dongle's TLS handshake- #1015
Request low-latency Wi-Fi during wireless projection, thanks to @emotionbug
Add on-demand "Check for Updates" button
Add FYT BLINK/DUDUAUTO module transport for Native AA thanks to @dohun0310
Added: BSSID recovery via IPv6 EUI-64
Mic: isolate capture sessions and bound uplink flow control, thanks to @emotionbug
Audio: stabilize playback and AAC recovery with opt-in AAudio, thanks to @emotionbug
WPP: retain active control connections and isolate listener generations, thanks to @emotionbug
Added: Apps drawer, thanks to @amp3r1
Navigation: stop the road name from sticking after the road changes
Self Mode: release the dummy VPN once the session is up, and start none for Android Auto 17.4 and later
Wireless: hold every automatic bring-up while the unit is asleep, and replay it once when the screen comes on
WiFi Direct: stand the station down again when the platform rejoins it mid-session
Native AA: ride out a ZLink daemon restart at cold start, and confirm a restarted hotspot stays up
Video: no codec on a dying surface, and a picture after a screen-off return in Texture mode
Automation: restore the three dropped automation commands, and stop Headunit Server connects preempting each other
Fix: crash when the USB service is missing, thanks to @muayyad-alsadi - #1057
Added: Performance overlay with its own settings screen, choose which lines it shows
Added: Root workaround for Android Auto 17.4+ wireless startup in the README, thanks to @mixalbl4-127

v.3.4.0

USB: connect non-Pixel phones without fighting a fast-reverting dongle
Feat/automation command surface
Video-Fit and ultrawide touch enhancements with dynamic scaling and rework all the options, thanks to @o-jardenass and @Sesam17
Several enhancements for native mode, thanks to @o-jardenass
Added darkmode for splashscreen
Added ADB-Server to disable/close OEM apps like Zlink, Autokit etc. to reduce conflicts with OpenHU
Added Support for BYD Steering wheel keys, thanks to @nicoruy
Added floating Exit Button, thanks to @Sesan17
Added Log to clipboard, thanks to @peter9811
Native for External BT's + Connection Status pill + AAC improvements to @o-jardenass
Moved Ui-Scale to theming
Native AA: say when the unit's WiFi radio is off instead of retrying in silence
Fix: Endless Loop in Permission Requests.
Give Video its own transport thread
Stop old Android promising what it cannot do
Measure and size the audio sink

v.3.3.1

Added: Option to auto-resume media playback on quick reconnect if music was playing before disconnect
Fixed: Errors shown in playconsole
Big Improvements to native mode. Huge Thanks to @o-jcardenass for this!

v.3.3.0

Begin for theming of the App.
Refactor WiFi-Code from AapService into their own classes for better maintenance, thanks to @MrEAlderson
Refactor Self-Mode and USB-Mode from AapService into their own classes for better maintenance, thanks to @MrEAlderson
Refactor Audio and Video Code from AapService into their own classes for better maintenance, thanks to @o-jcardenass
USB-Blacklist Filter to prevent the app from asking for non Android phones
Added: Option to disable the clock, thanks to @MrEAlderson
Added: French translation 🇫🇷 thanks to @phiDu-fr
Fix/session lifecycle and video concealment
Video: pace the transport thread instead of shedding reference frames
UI: a destroyed activity stops listening, and a recycled row keeps its subtitle
Fix Android 4 Problems
Fix Orientation issues
Several Native Mode fixes and enhancements
Mic: fix the uplink, and let the phone keep the microphone
Fix: Close keyboard that stays open on older Android versions to prevent layout issues
Per-channel audio stream selection, thanks to @nicoruy
Added Android Auto 17.4 Notice for users, who don't know why their wireless setup broke
Clean Up Dark Mode and Theming Option confusions
Fix: Projection dies when a Bluetooth keyboard connects or disconnects

v.3.2.6

Fix settings UI crash and dpi input on older Android devices
Fix video artifacts
Fixing wireless stack where failures stay broken until restart
Bringing back old style USB List
Fix broken theme after import: Reapply Theme selection after Settings import
Make HUD Mode for apply for the whole app

v.3.2.5

Fix black screen after backgrounding, and the washed-out picture a dropped frame leaves
Fix headunit server socket leak
Car GPS: deliver the head unit's fix when the phone asks, and keep it flowing

v.3.2.4

Fix: Video and audio never catch up after a wireless link stall, thanks to @o-jcardenass
Fix: Native AA wake poke takes down the head unit's own hands-free link, thanks to @o-jcardenass
Stop the setup wizard from overwriting the reported manufacturer, thanks to @o-jcardenass
Added: Let the Bluetooth side keep the media buttons, thanks to @o-jcardenass

v.3.2.3

Adding custom log location (App folder or Download folder)
additional fixing for the fps/freeze problems. Thanks to @o-jcardenass and @andrecuellar for helping
Fix/hotspot unreadable config
NativeAA: show when a P2P group that lands on channel 12 or 13

v.3.2.2

Fixing location jumping, especially on lower speeds
Fixing screen flicker again in video decoder
Fix/video throughput telemetry and keyframe lockout, thanks to @o-jcardenass
Fix Steering Wheel Buttons not working anymore
added new native mode without WiFi-Direct creation, thanks to @o-jcardenass

v.3.2.1

Fixing new welcome screen reappears, thanks to @andrecuellar
Fixing screen flicker every 10s thanks to @o-jcardenass
Fixing HW decoding on kitkat thanks to @o-jcardenass
Fixing 2 Fatal errors shown in play console
fix: move mic timestamp inside encrypted payload (byte 4), thanks to @bruno303
making native mode work better and on more devices, thanks to @o-jcardenass

v.3.2.0

Don't grab audio focus on connect in dynamic mode, thanks to @bnayahu
Acquire transient audio focus while AA audio plays, thanks to @bnayahu
Add GitHub Actions CI (build + unit tests), thanks to @bnayahu
Fix picture stuck if used within DUDU's PiP, thanks to @MrEAlderson
Fix(wifi): use public API for frequency, thanks to @DerTeufel
Added pixel aspect ratio setting, thanks to @axel92b
Added more audio features to gain audio focus and work with dsp headunits as setting
Added display over other apps permission for better compatibility with some headunits, espacially with self mode
Fix transport get stucked on multiple reconnects, thanks to @notathf
Add car keys support for FYT headunits, thanks to @MrEAlderson
Added Option to flip projection horizontal for Headup-Displays
Recover automatically from post-first-frame video display stalls, thanks to @andrecuellar
Settings and Onboarding Wizard redesign for better usability, thanks to @andrecuellar
Fixing mulitiple WiFi-Direct and Native AA connection issues, thanks to @o-jcardenass, @andrecuellar and @notathf
Various fixes PR, thanks to @MrEAlderson
Selfmode on AA 17.4 now connects to the headunit dev server or opens the AA settings to start it
Rename the app to Open Headunit because of confusion with Headunit Reloaded (HUR)

v.3.1.1

Reduce pressure on sensor events like night and gps and start/stop these events in onConnected, onDisconnect and onDestroy
Merged ffmpeg PR #625 by @mmwtl. This added ffmpeg software decoder for h265, which old devives could benefit a lot. Thank you!
Wi-Fi Direct changes. Prevent duplicate start, graceful resets, cleaned up stale groups
Remove Automatic Play Integrity Checks, so Playstore won't check the license and link to the playstore in headunits
Added manual bssid for native Mode. This should help for users where the bssid is hidden for the app, thanks to @rakshan-kumr
Added immediately network scan with wifi connection, thanks to @MrEAlderson for the PR

v.3.1.0

Added libusb as alternative to the native usb stack for better compatibility with some devices
Fixed Layout in Portrait Mode in nearly square devices
Added Scale Slider for loading screen media

v.3.0.1

Fixed: App Exit on Disconnect
Enhanced: USB Workflow. This will hopefully eliminate some random usb disconnects
Fixed keyboard input on Android < 6 Devices
Enhanced WiFi Direct-Mode
Enhanced File Selector for some devices
Fixed some fatal errors, showing in play console

v.3.0.0

Added: Custom loading screen (image/GIF/video), thanks to @andrecuellar
Added: Settings-Reset Button, if you mess up something in the settings, you can now reset them to default
Removed: Old deprecated ssl library written in C-Code for better maintenance, stability and smaller file sizes
Added: Direct Logging to file without logcat, thanks to @Anton111111
try to fix connection lost on carrier lost again
keep usb disconnection for 8s alive, for maybe restarts of usb dongles
Implement car headlight signal mode (ILL+) for night theme management, thanks to @minhtuanact
Added settings export and import functionality with backup options, thanks to @JanRi3D
Added whitelist to usb connection for not interrupting with iPhones and other usb devices
Added QR Code for easy connection with wireless helper
Fixed: BT auto-connect dragging phone into wireless flow during USB session, thanks to @andrecuellar
Persist Auto-Optimize wizard settings synchronously, thanks to @andrecuellar
Added ability to swipe with two fingers from the right side to switch fullscreen mode and Normal (all bars) mode, thanks to @Anton111111
Improved: usb button auto connect, thanks to @bezprobeloff
Catched an fatal error listed in the play console
Fixed: Audio Stutter on some devices since 2.1.1
Fixed: USB device list duplicates and Android Auto projection launch on Android 10+, thanks to @jeancarloscc
Enhanced: Google Nearby. It was buggy with 2 FPS video
Fixed: Navigation Button mapping now working

v.2.3.1

Fixed a connection lost on for example borders
Binding socket to wifi network if available to prevent connection drops on carrier lost
Added Static Audio Focus Toggle to prevent audio focus loss on some devices
Fixing samsung routines and modes
Fixing wrong orientation on start if holding the phone wrong. Now uses the orientation from settings
Try to fix usb errors with AAwireless Dongles
Added Audio Mixer to mix different audio tracks, thanks to @jeffdapaz for the idea
Added Autostart on BT for multiple devices
Fixed Microphone input source was wrong mapped
Added Vietnamese translation 🇻🇳 thanks to @minhtuanact
Merged PR #549 - implement back key routing and add keymap for back key, thanks to @JanRi3D

v.2.3.0

Added some new buttons for keymap
Fixed 3 Fatal errors
Fixed video decoder settings for allwinner devices
Added new navigation intents
Included PR #456
Added new "Autostart on WiFi" Setting #324
Fixed empty bssid on native AA. Should now work on more devices
Fixed a new fatal with media sessions
Readded fullscreen overlays system icons #351
Remap Enter (66) to Dpad Center (23) for Rotary Knob #459
Debounce multiple key events if key event is the same in 100ms #465
Moved Mic settings to own fragment and added 3 new options for the new mic enhancement from version 2.2.2, which defaults to off for better compatibility
Merged PR #481 - Apply MediaTek 60fps and audio optimizations, thanks to @mrkontrast-coder
Some rewrite of the AudioTrackWrapper, to enhance stability and minimize stutters
Merged PR #490 - Add UI scale settings, thanks to @Anton11111
Merged PR #502 - Navigation Broadcast Updates. Thanks to @Bastel2020

v.2.2.2

Fixed: Exit on disconnect now stops the carmode too
Fixed: Exit intent not closing the app
Fixed: Orientation not working great on app switch, if you have "auto or sensor" enabled
Again: Steering Wheel and Keymapping got some changes, maybe this will work on more devices
Extend mic debugging and add NoiseSuppressor, AutomaticGainControl and AcousticEchoCanceler for better voice quality
Fixed an issue where the Android USB system prompt wouldn't appear for phones. The prompt is now enabled by default and can be separately disabled for USB thumb drives. It calls "Listen for USB Devices" setting and it decouples the system USB prompt from the Auto-Start behavior. This will bring back the old functionality for all and can be disabled for those who are annoyed of the popup for non Android Auto devices
Fixed: Rescale and UpdateUI if the useable area differs from the one negiotated. This happens on devices which lie about their navbars.
Fixed: Fatal Crash on devices below lollipop on disconnection
Fixed: Auto-Night mode over 3 hours of in the UK and other countries, thanks to @BinarySimple17
Add separate audio streams setting and update related functionality thanks to @Anton111111
Enhanced: When audio sink is off, the app no longer tries to get media focus at all

v.2.2.1

Fixed a fatal error in UBS conncetions since 2.2.0. This is important so releasing this version while not fixing all planned issues
Google Nearby Connection is now auto connecting if auto connect is enabled
UI: Added Error Message for Android 10 and below for selfmode
New Approach for scaling and touch to prevent offset
Fixing App appears multiple times in App-Drawer
Fixing Routines and intents not working

v.2.2.0

Added: Native AA. 🎉 Warning! This will only work on a limited amount of headunits! Most Android devices do not support connecting 2 Android devices via Bluetooth which is essential for this to work.
Added: Google Nearby Support as connection method. Needs Wireless Helper 1.6.0 or later
Added: Pip-Support
Added: 4K in select
Try to fix connection problems on WiFi
Added: Intent and routine for starting the app directly to self mode
Added: Force Scale Option for older devices on surface view
Added: New Immersive Fullscreen with avoided notch area. This should fix problems for eg. Pixel Phones
Enhanced: Video Decoder Error Handling
Added: 2 new WiFi-Options for a WiFi-Direct. Thanks to @andrecuellar
Added Japanese language 🇯🇵 thanks to @mattyann87
Enhanced: Media Session Announcement. Thanks to @irwanrhmn
New App-Icon without text for better visibility
Fixed: USB modal appearing for non-Android Auto devices thanks to @andrecuellar
Added: Create configurable audio queue and audio buffer in settings thanks to @irwanrhmn

v.2.1.1

Fixed: Layout crash on Android 4.2
Added: Enable Hotspot option. Note: This will not work on every device. Especially after Android 13!
Added: Fake VPN Handler for new Android Auto in offline mode. It is no longer possible to send a network to AA, so we need this hack, if your device is offline
Enhanced: Audio-Focus is now more aggressive to hopefully fix the audio is not coming from my tablet/headunit errors
Added: Auto-Boot Functionality. Thanks to @andrecuellar
Attention: Needed to split Github and Playstore Release. Google does not allow using Fake VPN for offline selfmode. This is now not included in the playstore release!

v.2.1.0

Fixed: Exit Intent not working. Thanks to benyjr
Added: Rotary Support
Fixed: Crash in Android < 5
Fixed: Double Button fire and enter/knob click as dpad center mapping
Enhanced: Android Auto start for selfmode now tries all methods always and catches errors
Fixed: Auto start, connection lost overlay, toasts and API17 Bluetooth crash. thanks to @andrecuellar
Added: Exit App on disconnect feature/setting thanks to @Tilak-03 and @andrecuellar
Enhanced: Wi-Fi Setting redirect is gone. Now only a toast message
Fixed: styling errors

v.2.0.2

Fixed: 60FPS never applied
Fixed: SSL Handshake fix for truncated messages
Added: dark mode and xtreme dark mode setting for the app itself thanks to @andrecuellar!
Removed: App category="maps" so nav buttons recognize the app again
Fixed: Multiple Button Events and double/tripple skips
Fixed: USB Permission Request thanks to @Bastel2020
Added: Setting for Disable stretch to fit. This will fix wrong rendering on some devices @thanks to tsabaia
Fixed: Touch screen accuracy when not in full screen mode for older devices
Fixed: Big Icon-Button on main screen when the dpi is small and the screen is wide

v.2.0.1

Fixed: Multiple volume sliders appearing on modern devices (Pixel 9 fix)
Added: Support for Media Button emulation (SWC improvement for MacroDroid etc.)
Added: App shortcut and deep link for full app exit (headunit://exit)
Added: Improved Wi-Fi Direct reliability with recursive discovery and ping handoff
Added: Romanian translation 🇷🇴, thanks to @LeeWiu
Merged PR #189: Adding navigation message handling, thanks to @Bastel2020
Merged PR #215: Fix USB reconnect race and stale dongle data after AA exit, thanks to @andrecuellar
Merged PR #205: Fix wireless dongle disconnect on network changes, thanks to @andrecuellar
Merged PR #216: Add Bluetooth SCO microphone support, thanks to tgigli

v.2.0.0

Added Wi-Fi Direct (P2P): Support. Connect your phone to the headunit without a shared network or hotspot. The headunit now automatically becomes visible as a P2P peer.
Refactored Connection Core: Complete rewrite of the internal connection handling using the new CommManager. Improved stability, faster handshakes, and better coroutine integration.
Enhanced Fullscreen Logic: Choose between "Immersive" (hide all), "Status Only" (keep navigation bars), or "None". Improved compatibility for devices where buttons were previously obscured.
Added Auto-Optimization Wizard: Automatically recommends the best Resolution, DPI, and Codec for your specific hardware.
Added Early MediaSession Initialization: Fixes audio routing issues where the phone would sometimes play sound through its own speakers instead of the headunit.
Added New Logging System: Integrated log level control and file capture for easier debugging.
IMPORTANT Fixing Android Auto 16.4 intents for selfmode. In Wireless Helper too. Please update to 1.2.0

v.1.15.1

New Feature: Added Auto-Optimization Wizard to automatically find the best Resolution, DPI, and Codec settings for your hardware.
Bugfix: Fixed Self Mode failing to start in offline/hotspot scenarios (Network ID 0 fix).
Bugfix: Improved Audio Routing. The phone is now more likely to route audio to the headunit immediately upon connection by using an early-initialized MediaSession with remote playback metadata.
Bugfix: Fixed GPS Speed calculation. Speeds were previously doubled due to an incorrect unit conversion (knots instead of mm/s).
UI: Improved Settings readability on small screens by allowing multi-line descriptions.

v.1.15.0

Added arabic language thanks to A5H0
Added new intent for setting day/night mode for maps
Added new window flags for older devices to finally fix fullscreen issues
Added new intents to make the headunit recognize the app as navigation app
Added LegacyOptimizer which will handle things directly and faster for single core cpus. Should improve the performance on Android 4.1 - 4.4 Devices
Fixed BT Permission Bug
Changed the Twilight-Calculator for better switch to day/night on auto mode to prevent to bright display
Added more mediasession logic to gain audio focus and audio routing
Merged Retry Button on connect screen, thanks to @andrecuellar
Merged auto connect usb feature, thanks to @andrecuellar

v.1.14.3

Automation: Added App Shortcuts for Samsung Modes & Routines support.
Navigation: Officially registered as a navigation provider (compatible with NAV buttons).
Stability: Fixed rare app freezes by improving internal data handling and memory hygiene.
Compatibility: Improved hardware support for Amazon Fire Tablets and GPS-less devices.

v.1.14.2

Bugfix: Notification and Exit Button do not close the app
Improvement: Removed old legacy Invisible Bluetooth Setting to prevent Bluetooth from start on the whole time

v.1.14.1

Improvement: Integrated USB Auto-Connect into "Auto-Connect Last Session". App now behaves like a native headunit and connects automatically on startup or USB plug-in.
New Feature: Added USB Soft-Reset logic. Automatic recovery from USB "stalls" without needing to replug the cable.
Major Improvement: Audio focus and routing overhaul. Added MediaSession support and immediate focus response to phone. Fixes issues where background apps on the tablet would block Android Auto audio.
Improvement: Robust Task Switching. Leaving the app via Home button or clicking the Launcher icon no longer breaks the connection. Music continues in background, and clicking the icon/notification correctly returns to the projection.
New Feature: Enhanced Key Debugger ("Key-Sniffer"). Prominent display of all key events, including special characters (ö, ü, ß) and proprietary steering wheel intents (MTC, FYT).
New Feature: Official Navigation App Registration. OpenHU is now recognized as a navigation provider (geo:, google.navigation:, android.intent.action.NAVIGATE). Compatible with hardware "NAV" buttons.
Bugfix: Removed redundant "Already connected" and "Reconnection required" alerts for a smoother user experience.
Localization: All new strings translated into 10 languages.

v.1.14.0

Added Separate volume setting #91
Added Auto-Start on Bluetooth Option
Merged PR #134 - Fixing Connection on Mediathek Headunits
Merged PR #131 - Fixes SystemUI on < Android 6 Devices
Merged PR #127 - Fixing Audio Truncation

v.1.13.3

Fixed Screen Issues on Android 4 with header and navigations #114
Fixed Night-Mode Bug #116
Merged several PR for better Language Handling with a new language selector. Thanks to @andrecuellar

v.1.13.2

Fixed margins now working for devices prior Android 5 Lollipop
Fixing warnings
Fixing broken colors on mixed daynight values
Fixed a bug where a message is bigger than thought after about 20 minutes and connections closes

v.1.13.1

Fixed Custom Insets Dialog with a Scrollview
Fixed 4 app crashes listed in play console
Fixed 2 warnings in play console for edge-to-edge display
Fixed a race condition in ssl read/write
Preventing disconnect if just one package was broken/corrupt in ssl transfer

v.1.13.0

Improvement: USB stability overhaul (implemented 16KB internal buffer)
New Feature: Custom Insets (Margins) setting with live preview
Fixed: Video decoder blackscreen on some AI-Boxes (H.264 NAL padding)
Fixed: UI focus issues in Settings causing system bars to reappear
Fixed: Native SIGABRT crashes during reconnection
Cleaned up Debug settings

v.1.12.0

Major Improvement: Wireless Connectivity overhaul (Socket Reuse, better Handshake)
New Feature: Wireless Mode Switch (Manual, Auto-Scan, Wireless Helper Support)
Added: Support for Wireless Helper companion app
Fixed: Android 15 (16KB page size) compatibility for native libraries

v.1.11.1

Improvement: 1440p and h265 are now checked both. Some old devices have more than 1080p but no h265 support and android auto crashes with Error 11
Fixed bug in Kitkat Devices on search for wireless devices
Merged PR #94 - Fixed blurry icon. Thanks to @nicoruy
Merged PR #95 - Make Settings own View to apply directly. Thanks to @nicoruy

v.1.11.0

New Feature: Advanced Night Mode (Light Sensor, Screen Brightness, separate thresholds, manual time)
Improvement: Audio Stuttering fixed (Optimized ACK handling)
Improvement: USB Reconnection stability (Added "Reconnection Required" dialog for stuck sessions)
Improvement: WiFi Discovery (Added Multi-Interface Scan and NSD/mDNS support)
New Feature: Enhanced Service Notification (Reduced noise, added Exit button)
Added: Spanish translation 🇪🇸 thanks to @andrecuellar
Added: Ukraine translation 🇺🇦 thanks to welshi32
Bugfix: Non-Fullscreen View was stretched, touch could be off
Bugfix: Wifi with Headunit Server now works with hotspot

v.1.10.4

Added: Dutch translation 🇳🇱 thanks to safariking
Several black screen and connection error enhancements
Bugfix: Crash in Background if not started as foreground service

v.1.10.3

Bugfix: Force Software Decoder wasn't getting always the sw decoder
Added: Russian translation 🇷🇺 thanks to @prostozema
Enhancement: Fixing small issues in the video-decoder which should help lower spec devices to render properly (but act a little bit slower perhaps)

v.1.10.2

Bugfix - Button Mapping ignored #71
New Feature: Screen-Orientation Feature to lock to a certain orientation (Landscape/Portrait) #69 thanks to @JanRi3D
Enhancement: SSL will now attempt multiple times and not break instantly thanks to @MicaelJarniac
Added: Chinese(Traditional) translation 🇹🇼 thanks to @GazCore
Added: Czech translation 🇨🇿 thanks to @teodortomas #75
Fixed brazilian portuguese folder name

v.1.10.1

Bugfix: Added missing 3 Byte startcode which stops some devices to start the projection
Added PR #68 - Fix Wifi Direct detection thanks to @rakshan-kumr
Added PR #67 - Brazilian Portuguese translation 🇧🇷 thanks to @MicaelJarniac
Added PR #66 - Add conscrypt to fix error 7 on lower Android versions 🚀, thanks to @JanRi3D
The old jni files and c code can maybe be removed when PR #66 is performing great. So we can get rid of that again 😃

v.1.10.0

New Feature: Portrait Mode Support (Dashboard & Projection) with smart resolution scaling Known Bug is, that map is unresponsive to touch. That is in all HU apps
New Feature: Redesigned Keymap Screen (easier configuration)
New Feature: Right Hand side driving setting (#63)
New Feature: Auto-Connect last session (Thanks to @JanRi3D) (#21)
New Feature: Auto-Selfmode if enabled in settings
New Feature: Allow sideloaded apps (#57)
Localization: Added German Translation 🇩🇪 Other translations are highly appreciated
Improvement: TextureView is now the default renderer (better compatibility for most devices)
Improvement: Fixed Dashboard layout rotation
Rewrite: Completly Rewrite the Video-Decoder as it was undebuggable. Removed the async mode and more

v.1.9.0

New Feature: GLES20 Video Renderer (Fixes black screen/artifacts/scaling on older Head Units)
New Feature: In-App Log Export (Save to file/Share) for easier debugging
Improvement: Audio Sink Logic fixed (System Audio always advertised) -> Fixes black screen when Audio Sink is disabled
Improvement: Video Decoder optimized for legacy devices (Buffer size adjustments, Overflow handling)
Hopefully Fix: Audio Stuttering resolved (Buffer/Queue logic reverted to stable state)
Fix: Video Fragmentation on some devices (Support for split frames/Offset 2 headers)
Fix: Crash on Android 5.1 (NoSuchMethodError)
Fix: Audio-Sink disable not working
UI: Consistent Dialog Theme (Teal/Rounded) and improved list buttons
Compatibility: Verified support for Android 4.1+ (minSdk 16)
Compatibility: Bring back native SSL Support (JNI) for better performance on older devices (Toggle in Debug Settings)

v.1.8.1

Fixed Fullscreen/Non-Fullscreen layout issues (black bars, overlapping)

v.1.8.0

Added Audio Sink Setting (Enable/Disable routing audio to HU)
Added AAC Audio Support Setting (Experimental)
Fixed audio stuttering issues by reverting buffering logic to v.1.4.1 defaults
Restored robust video decoder logic (SPS Parsing) to fix black screen/crashes on Mediatek devices
Fixed visual glitches on navigation bar and fullscreen transitions
Improved list item UI with better click feedback
Fixed SSL decryption crash (ArrayIndexOutOfBoundsException)

v.1.7.0

Added WiFi Network Discovery (Port Scan) with Auto-Connect
Added Intent Support (headunit://connect?ip=...) for automation
Added Wifi-Launcher Support with new setting
Updated README

v.1.6.3

Added mandatory Safety Disclaimer on first start
Improved audio stability and fixed stuttering issues
Enhanced full-screen stability with transparent system bars
Fixed WiFi disconnection synchronization issues (ByeBye request)
General UI and stability improvements

v.1.6.2

Fixed critical screen flickering during startup and fullscreen transitions
Resolved video decoder freezing issues on tablets and older devices
Improved system bar handling for a more stable projection experience

v.1.6.1

Added "About" page with version info, changelog, and license
Added "Force Legacy Decoder" (synchronous mode) setting to fix issues on some devices (e.g., Mediatek)
Improved surface handling to prevent crashes on decoder reconfiguration
Fixed "Unsaved changes" dialog in settings
Updated UI with consistent back arrows and theming
Fixed black screen issues on some devices by optimizing decoder initialization

v.1.6.0

Fixed the selfmode not working outside the wifi bug
Redesign of App, Look and feel with modern Material 3
Better Settings
Huge Android Auto Protocol Updates
Clicking Exit in Android Auto now closes the projection

v.1.5.0

Complete Rewrite of the Video decoder for better Video-Performance
Updated Android-Auto Protocol with the latest available codecs (h265 for example)
Added 1440p Video-Option(Note this only works with h265!)
Added FPS-Setting
Added Codec-Setting
Added Force to Use Software decoder Setting
Merged the Android Native SSL Library and get rid of the old jni files

v.1.4.1

Fixing Touch-Events for devices with higher resolutions
Removing file-log and logging is only enabled if debug is on

v.1.4.0

Added Selfmode
Better Close App

v.1.3.0

Changed the Settings Layout Look and feel
Added DPI Option
Added full screen option
Fixing Keymap Changes and button recognition

v.1.2.1 - Resolution enhancement

Just a minor enhancement for the resolution. Not yet perfect in my opinion but better than before
The is the last release for this year. Happy Holidays to all and a happy new year

v.1.2.0 - Bugfix Release

Added Exit button to app
Added resolution settings back for better compatibility with different screen sizes
Added Option for which texture to use. Some devices perform better on SurfaceView, some on TextureView
Fixed keymapping
Fixed a lot of color issues
Fixed a bug where the app crashed on startup on some devices
Fixed Layout on wider screens
Some rewrite, and small bugfixes

v1.1.0 - New Design

Changed the basic design to a modern look and bigger buttons
Hopefully fixed audio-stutters with audio thread and some logs
Removed some deprecations

v1.0.0 - Initial Revived Release

Updated dependencies to latest versions.
Improved compatibility with newer Android versions.
Added Multitouch-Support
Some sort of wireless support with Headunit-Server on Phone

Contributing

Creating release apk needs a keystore file. You can create your own keystore file using the following command in root folder: keytool -genkey -v -keystore headunit-release-key.jks -alias headunit-revived -keyalg RSA -keysize 2048 -validity 10000

After that you need to set the env variables depending on your OS: MAC: open ~/.zshrc or ~/.bashrc

sudo nano ~/.zshrc or sudo nano ~/.bashrc export HEADUNIT_KEYSTORE_PASSWORD="YOUR_KEYSTORE_PASSWORD" export HEADUNIT_KEY_PASSWORD="YOUR_KEY_PASSWORD"

Original Headunit

Headunit for Android Auto (tm)

A new car or a $600+ headunit is NOT required to enjoy the integration and distraction reduced environment of Android Auto.

This headunit app can turn a Android 4.1+ tablet supporting USB Host mode into a basic Android Auto compatible headunit.

Android, Google Play, Google Maps, Google Play Music and Android Auto are trademarks of Google Inc.

ankidroid/Anki-Android

AnkiDroid: Anki flashcards on Android. Your secret trick to achieve superhuman information retention.

AnkiDroid

A semi-official port of the open source Anki spaced repetition flashcard system to Android. Memorize anything with AnkiDroid!

Features

Night mode
Whiteboard
Progress widget
Detailed statistics
Syncing with AnkiWeb
Write answers (optional)
Text-to-speech integration
More than 10,000 premade decks
Spaced repetition (AI-optimized FSRS algorithm)
Supported contents: text, images, sounds, MathJax
Add cards by intent from other applications like dictionaries

Install

Signing certificate fingerprint to verify the APK:

SHA-256: 2071534f0f4b5e54ae952dd275d70da6e3459ee69909d2ab1b4843c4c5b21a45 
SHA-1: f24e06a3657b190a12671100402df32d7b9b3d36

Wiki

View Wiki

Help

Check the user manual and the wiki for usage instructions. See the help page for how to submit a bug report or contact a project member, etc.

Contribute

You can contribute to AnkiDroid by beta testing, translating, or submitting code. See the contribution wiki page for more info.

Join Us On

Credits

Code Contributors

Thanks to these awesome code contributors who keep this project going

Backers

A big thank you to each of our backers 🙏

Your generous donations mean the world to us, and we can't express our gratitude enough. Your support fuels our mission and helps us make a real difference

Translators

Thanks to our 1400 translators, for allowing us to be available, partially or totally, in 99 languages as of July 2022.

License

GPL-3.0 License
AGPL-3.0 License for some part of the back-end
LGPL-3.0 License for the AnkiDroid API

Тема	Когда срабатывает
Ночной простой	Ночью ушло ≥ 0.3 кВт·ч с мотором
DC дороже AC	Оба типа зарядки ≥ 3 кВт·ч, DC на 15%+ дороже
Много DC	≥ 2 DC-сессий, DC > AC×1.5
Короткие поездки	≥ 40% поездок короче 5 км
Простой с мотором	≥ 2 кВт·ч на стоянке
12V низкий / падает	11.8–12.4 В или тренд вниз за неделю
Разброс ячеек	31–50 мВ
Зима + рост расхода	≤ 5°C и расход вырос
Лучшая / худшая поездка	Разброс ≥ 5 кВт·ч/100
Снижение расхода	↓ > 5% к прошлой неделе
Трасса	Средняя скорость ≥ 75 км/ч
Высокий / низкий расход	≥ 28 или ≤ 16 кВт·ч/100
Рост пробега / поездок	+20% к прошлой неделе
Жара + кондиционер	≥ 25°C, расход ≥ 22
Смешанная зарядка	AC и DC в одну неделю
Стоимость	Руб/100 км или зарядки за неделю
Хорошие привычки	Мало ночного или дневного простоя, 12V/баланс в норме

GitHub Kotlin Monthly Trending Repositories

ExTV/Podroid

Podroid

What you get

Quick start

Build

Contributing

Related projects

Credits

License

YuKongA/ghostlock-app

GhostLock-App

Documentation

Quick Start

Command-Line Debugging

Offset Extraction

MediaTek

Preflight

On-device analysis

Importing offsets without rebuilding the app

Credits & License

tiann/KernelSU

KernelSU

Features

Compatibility state

Usage

Translation

Discussion

Security

License

Credits

gkd-kit/gkd

gkd

免责声明

安装

截图

订阅

选择器

开发

衍生

捐赠

KernelSU-Next/KernelSU-Next

KernelSU Next

🚀 Features

✅ Compatibility

📦 Installation

🏅 Contribution

📜 License

💸 Donations

🙏 Credits

open-ani/animeko

主要功能

浏览来自 Bangumi 的番剧信息以及社区评价

丰富的检索方式：新番时间表、标签搜索

云同步追番进度

聚合数据源

离线缓存

精美界面

更多个性设置

下载

技术总览

参与开发

FAQ

资源来源是什么?

弹幕来源是什么?

thejaustin/ShizukuPlus

Shizuku+

⬇️ Download

✨ Shizuku+ Core Features

⚙️ Modular Control

🔌 Third-Party App Compatibility

☑️ Requirements

📃 License

Upstream Projects

Open Source Libraries

Acknowledgments

maxrave-dev/SimpMusic

SimpMusic

Download

Nightly Build