Tess's Android Wayland Compositor

Hacker News Top 工具

摘要

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)。应用内捆绑的所有组件归属信息可通过 设置 → 关于 → 许可证 查看。

相似文章

《我的世界》中的 Wayland 合成器

Hacker News Top

一个在《我的世界》中实现完整 Wayland 合成器的模组,允许用户在游戏内启动和管理 Firefox、GIMP、VLC 等窗口。仅限 Linux。

Xfwl4 的首个预览版发布

Lobsters Hottest

Brian Tarricone 宣布推出 xfwl4 的首个预览版,这是 Xfce 的 Wayland 合成器,经过了六个月的工作,详细说明了已知缺失的功能和未来计划。

crynta/terax-ai

GitHub Trending (daily)

Terax 是一个轻量级、开源、终端优先的 AI 原生开发工作空间,基于 Tauri 2、Rust 和 React 构建,具备智能 AI 侧边栏、代码编辑器、文件浏览器、源代码管理和网页预览功能。