SimonSchubert/omalauncher
Agentic Android launcher: build your own apps and widgets with AI agents, Omarchy themes, Arch Linux without root
Omalauncher – 融合自定义 UI 与可选 Linux 应用的 Android 启动器
它是什么
Omalauncher 是一款 Android 主屏幕替代品,模仿 Omarchy 桌面环境的视觉风格。它还可以使用 proot 在手机内运行完整的 Arch Linux ARM 用户空间,因此每个 Linux 程序都会显示为独立的 Android 任务(可在最近任务视图中滑走的卡片)。
核心功能
| 功能 | 你获得的内容 |
|---|---|
| Omarchy 风格主题 | 所有 22 个官方 Omarchy 主题以及社区制作的主题。主题同时影响 Android 启动器 UI 和打开的 Linux 窗口。 |
| 用 OWL 编写的小部件 | OWL 是一种用于定义主屏幕小部件的微型声明式语言。小部件可以直接在手机上编辑,并通过一个小部件商店分发。 |
| 可选的 Arch Linux ARM | 可以安装预打包的 Arch Linux ARM rootfs(或推送你自己的)。你可以获得 pacman、AUR 访问、终端、文件管理器,以及 Mali GPU 上的可选 GPU 加速。 |
| 编码代理栏 | 底部栏接受文本或语音,将提示发送给 AI 编码助手(Claude Code、Codex、Copilot 等),并在终端窗口中打开响应。 |
| 无账户、广告或跟踪 | 应用完全离线运行;只有语音转文本由 Android 内置识别器执行。 |
| 触控友好的 Linux 窗口 | 点击 = 左键单击,长按 = 右键单击,拖动 = 滚动。支持触控的应用(例如 foot、GTK)可原生工作。 |
| 键盘快捷键 | Super+Enter 打开终端,Super+Space/Super+A 聚焦栏,Super+1..9 切换主页等。 |
工作原理
- Proot 沙箱 – Linux rootfs 在
proot(用户空间 chroot)下运行,因此无需 root 权限。 - Wayland 合成器 – Omalauncher 本身充当合成器;每个 Linux 窗口渲染到自己的 Android activity 中,在最近任务中提供熟悉的“卡片”UI。
- JNI 桥接 – Kotlin/Compose UI 与处理 proot 集成和 GPU 加速的原生 C++ 代码(JNI 层)通信。
- OWL 小部件引擎 – 小部件由
owl命令行工具(用 Kotlin 编写)编译,并由启动器显示。
开始使用
- 从 Google Play 安装(需要运行 Android 10+ 的 arm64 设备)。
- 即使没有 Linux 端,启动器也能工作——你仍然可以获得主题和 Android 小部件。
- 要添加 Linux 系统,将预构建的
ArchLinuxARM-aarch64-latest.tar.gz推送到应用的数据文件夹(或让应用下载)。 - 使用底部栏启动应用或与编码代理对话;所选代理保存在
~/.config/omalauncher/agent下。
开发与构建
# 获取应用使用的预构建 proot 二进制文件
./scripts/fetch-proto.sh
# 在已连接的设备上构建并安装调试版本
./gradlew :app:installDebug
# (可选)跳过 830 MiB Linux rootfs 下载,自行推送
adb push ArchLinuxARM-aarch64-latest.tar.gz \
/sdcard/Android/data/dev.omalauncher/files/
- 单元测试位于
:owl:test和:app:testDebugUnitTest。 owl语言编译器可以使用./gradlew :owl:owlJar构建。- 架构和发布说明位于
docs/ARCHITECTURE.md和docs/RELEASING.md。
项目结构
app/– Android 应用(Kotlin、Jetpack Compose、JNI 桥接)。owl/– OWL 小部件语言实现和 CLI 工具。art/– 图标和主题的 SVG 资源。store/– Play Store 列表资源。fastlane/– Play Store 上传自动化。scripts/– 获取 proot、生成截图等辅助工具。
许可证
代码和艺术作品根据 MIT 许可证 发布。第三方组件(proot、talloc、libandroid-shmem、编码代理徽标、Omarchy 资源)拥有自己的许可证,如 THIRD_PARTY.md 中所列。该项目是独立的,与 Omarchy、Arch Linux 或它可以启动的 AI 编码服务没有官方关联。
Omalauncher 是自定义 Android 启动器和便携式 Linux 环境的巧妙融合,面向想要主题化 UI 并能在手机上运行桌面级 Linux 应用而无需 root 的高级用户。
相关
- 项目
- 项目
- 项目
- 项目