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 切换主页等。

工作原理

  1. Proot 沙箱 – Linux rootfs 在 proot(用户空间 chroot)下运行,因此无需 root 权限。
  2. Wayland 合成器 – Omalauncher 本身充当合成器;每个 Linux 窗口渲染到自己的 Android activity 中,在最近任务中提供熟悉的“卡片”UI。
  3. JNI 桥接 – Kotlin/Compose UI 与处理 proot 集成和 GPU 加速的原生 C++ 代码(JNI 层)通信。
  4. 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 的高级用户。

相关

  • 项目
  • 项目
  • 项目
  • 项目