Tess's Android Wayland Compositor
摘要
Tess的Android Wayland合成器(tawc)能够在无需root权限的情况下,在Android设备上运行命令行和图形界面的Linux程序,其特性包括硬件加速、XWayland支持以及与Android系统的深度集成。
查看缓存全文
缓存时间: 2026/08/15 21:38
wmww/tawc 来源:https://github.com/wmww/tawc
Tess 的 Android Wayland 合成器
tawc 无需 root 权限即可在 Android 上运行命令行和图形 Linux 程序。图形应用通过手机原生图形栈获得硬件加速。该项目由 tawcroot(PRoot 的高性能替代方案)、Wayland 合成器以及整合界面组成。本项目由智能体构建,主要使用 Claude Code 和最新的 Anthropic 模型。
功能特性
- 应用内嵌入 Termux 组件,提供熟悉的终端界面(无需安装 Termux 应用本身)
- 图形应用安装后可通过 tawc 启动菜单运行
- Linux 应用可添加至手机主屏幕,并在应用切换器中与 Android 应用并列显示
- 内置 XWayland 支持,为 X11 应用提供硬件加速
- 内置任务管理器可查看和终止 Linux 进程
- 通过
ando命令和存储绑定,Linux 程序可选择与 Android 数据交互
顶层设计架构
- 下载并解压标准 Linux 发行版(如 Arch Linux ARM 或 Debian)
- 通过
tawcroot在发行版 rootfs“内部”运行 Linux 程序(包括原生包管理器) tawcroot模拟 chroot 等系统调用以突破无 root Android 环境限制(类似 PRoot 但因单进程设计而更高效)- 基于 Smithay 的 Wayland 合成器提供 Android 集成功能(如传递标准 Android 键盘输入)
libhybris允许基于 glibc 的 Linux 程序加载标准 Android 图形驱动- 上游版
libhybris无法在原生 Android 上运行,而我们的分支版本(https://github.com/wmww/libhybris)已解决此问题
局限性
- 仅在 Android 自身机制外对 Linux 应用进行有限沙盒隔离,由于单进程设计,tawcroot 可被逃逸
- 不支持桌面级 GL,仅提供手机支持的图形 API(通常为 GLES 和 Vulkan)
- (相关)尚未针对游戏进行测试或优化
- 性能优于同类方案,但未达原生水平
- 目前仅提供 arm64 官方构建版本。可为 x86 构建,但我们的 libhybris 技术方案依赖 arm 架构
- 要求 Android 10 以上版本
更多技术细节请参阅 AGENTS.md。
贡献指南
建议优先提交 Issue 而非 PR。欢迎提交错误报告和功能请求,但无法保证特定时间的处理进度。若 Issue 中包含 LLM 生成内容,请明确标注(最好注明使用的 LLM),并始终附带人工撰写的描述。请提供应用版本、手机型号、Android 版本及发行版信息(如适用)。
简言之,良好示例:
Issue 标题:程序 foo 崩溃
在 Pixel 10(运行原生 Android 17)上使用 tawc v1 的 Arch 系统
通过 pacman 安装的 foo v1.2 启动即崩溃。询问 Fable 问题时得到如下回答:
不良示例:
PR 标题:[CLAUDESLOP]
[CLAUDESLOP] 代码:
未解释的 CLAUDESLOP
开源许可
deps/ 目录外的所有代码采用 MIT 许可协议(LICENSE.MIT)。因包含 vendored 依赖中的 GPLv3 代码(termux-shared 的 extra-keys 组件),项目整体采用 GPLv3 协议(LICENSE)。应用内捆绑的所有组件归属信息可通过 设置 → 关于 → 许可证 查看。
相似文章
在Minecraft中作为模组实现的Wayland合成器
一个在游戏内实现了功能完整的Wayland合成器的Minecraft模组,允许用户在Minecraft世界中运行和管理应用程序。仅支持Linux。
《我的世界》中的 Wayland 合成器
一个在《我的世界》中实现完整 Wayland 合成器的模组,允许用户在游戏内启动和管理 Firefox、GIMP、VLC 等窗口。仅限 Linux。
fht-compositor: 一个动态平铺的Wayland合成器
fht-compositor是一个受dwm和xmonad启发的动态平铺Wayland合成器,提供自动窗口布局和以键盘为中心的工作流程。
Xfwl4 的首个预览版发布
Brian Tarricone 宣布推出 xfwl4 的首个预览版,这是 Xfce 的 Wayland 合成器,经过了六个月的工作,详细说明了已知缺失的功能和未来计划。
crynta/terax-ai
Terax 是一个轻量级、开源、终端优先的 AI 原生开发工作空间,基于 Tauri 2、Rust 和 React 构建,具备智能 AI 侧边栏、代码编辑器、文件浏览器、源代码管理和网页预览功能。