ITADN
N3oRay/proton-autogen
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

🧩 Proton-Autogen

Linux Python GitHub release License Build Debian Package Downloads

Proton-autogen 自动为 Windows 游戏和应用创建并配置 Proton 环境,应用优化设置以实现最佳兼容性。 Proton-autogen 是一个轻量级的 Proton/Wine 编排层,允许 Linux 用户从 .exe 文件运行 Windows 应用程序,而无需手动管理 Steam 快捷方式或 Wine 前缀。

通过 Proton 运行 Windows 可执行文件,零 Steam 配置。

🎬 快速演示

Proton-Autogen Demo Proton-Autogen Demo

🚀 概述

Proton-Autogen 自动检测可用的 Proton 安装,配置所需的运行时环境,并使用 Proton 启动 Windows 应用程序,支持 Wine 回退。

无需手动创建 Steam 快捷方式或配置前缀。

只需:

  • 右键点击一个 .exe
  • 选择 使用 Proton-Autogen 打开
  • 启动应用程序

✨ 功能

  • ▶ 通过 Proton 直接运行 Windows .exe 文件
  • 🧠 自动检测 Proton
  • 🚀 支持 Proton-CachyOS、GE-Proton 和自定义 Proton 构建
  • 🍷 Wine 回退支持
  • 📦 前缀管理
  • 🖱️ 文件管理器集成:Nemo、Nautilus、Dolphin
  • 🎮 游戏/应用程序配置文件
  • 🖥️ GTK4 图形界面
  • 🛠️ 诊断工具
  • ⚙️ CLI 和高级选项
  • 🔧 轻量级且依赖最少

在此查看生成的配置文件示例:配置文件输出示例


📸 截图

Screenshot

集成

右键单击任意 Windows 可执行文件,然后选择:

Open with Proton-Autogen

🧪 用法

终端

proton-autogen game.exe

图形界面:

proton-autogen --ux

🛠️ 故障排除

如果应用程序无法启动,请生成诊断报告:

proton-autogen --diag

示例输出:

在此处查看完整的示例输出:示例输出


📦 下载

最新版本可在 GitHub 上获取:

  • Debian / Ubuntu: .deb 软件包
  • 源码安装:install.sh
  • Arch Linux / CachyOS: AUR(即将推出)

📦 安装与更新

Ubuntu / Linux Mint / Pop!_OS(推荐)

推荐的安装方式是官方 Proton-Autogen PPA:

对于 Arch Linux 和 CachyOS,计划提供原生软件包。 在此之前,可使用手动安装程序。

推荐安装方式(Ubuntu / Linux Mint / Pop!_OS)

sudo add-apt-repository ppa:n3oray/proton-autogen
sudo apt update
sudo apt install proton-autogen

基于 Debian / Ubuntu 的发行版(.deb 软件包)

从 GitHub 下载最新的 .deb 版本:

sudo apt install ./proton-autogen_*.deb

手动构建 Debian 软件包

git clone https://github.com/N3oRay/proton-autogen.git
cd proton-autogen
dpkg-buildpackage -b -us -uc
sudo apt install ../proton-autogen_*.deb

请参阅手动安装指南:

安装指南

运行安装程序之前请审查安装程序

less install.sh

(手动安装)

git clone https://github.com/N3oRay/proton-autogen.git
cd proton-autogen
chmod +x install.sh
./install.sh

配置

配置是完全自动的。

cat ~/.config/proton-autogen.conf
ls ~/.config/proton-autogen/games

这将安装:

  • /usr/bin/proton-autogen
  • 与 Nemo (Cinnamon)、Nautilus (GNOME) 和 Dolphin (KDE Plasma) 集成。

⚠️ 要求

必需

  • Python 3.x
  • 可用的 Proton 安装

支持的位置:

~/.steam/root/compatibilitytools.d
~/.steam/debian-installation/compatibilitytools.d
~/.local/share/Steam/compatibilitytools.d

可选

  • GameMode
  • MangoHud
  • GameScope
  • Proton-CachyOS
  • GE-Proton
  • ProtonUp-Qt
sudo apt install gamemode mangohud

🧠 工作原理

  1. 检测可用的 Proton 安装
  2. 优先使用 GE-Proton(如果可用)
  3. 通过 Proton 启动可执行文件
  4. 如果 Proton 运行时工具不可用,则回退到 Wine
  5. 可选启用 GameMode

无需创建 Steam 快捷方式。


🗑️ 卸载

移除软件包

sudo apt remove proton-autogen

完整清理

sudo apt purge proton-autogen

手动清理

chmod +x ./uninstall.sh
./uninstall.sh

卸载脚本仅删除 Proton-Autogen 文件和配置。 它不会删除 Steam、Proton 版本或现有的 Wine 前缀。

重启 Nemo:

nemo -q

重启 Nautilus:

nautilus -q

🚧 已知限制

  • 并非所有 Windows 应用程序都能在 Proton 下运行
  • 某些启动器需要额外配置
  • Proton 兼容性取决于所选的 Proton 版本
  • 某些应用程序可能仍需进行 Wine 调整

🛣️ 路线图

核心功能

  • 按应用配置
  • 高级前缀控制(Steam compatdata 集成)
  • 配置文件支持
  • 游戏 / 安装程序自动检测
  • GUI 前端

游戏集成

  • Lutris 配置导出
  • Lutris 配置导入
  • Bottles 配置导入/导出
  • Sensors 和 MangoHud 支持
  • Gamescope 集成

自动化

  • ProtonDB 集成
  • 自动安装依赖项(.NET、VC++、DirectX...)
  • 静默模式

🤝 贡献

欢迎提交 Bug 报告、功能请求和贡献。

请使用 GitHub Issues 进行讨论和报告。

💡 理念

Linux 游戏功能强大,但往往碎片化。

Proton-Autogen 旨在通过将 Proton 转变为一个透明的执行层,而非一个需要手动配置的工具,来减少摩擦。

目标很简单:

右键 → 运行 Windows 应用程序 → 它就能正常工作。


👤 作者

N3oray

Screenshot

GitHub: @N3oRay


📜 许可证

本项目采用 MIT 许可证。

详见 LICENSE 文件。

📈 项目活跃度

由 Linux 用户积极维护和使用,定期发布版本并持续改进。
📦 Clones             ████████████████████  2,091
👥 Unique cloners     ████████              509
👀 Views              ██████                393
🌍 Unique visitors    ██                    157
Ubuntu PPA
📥 Downloads █████████████████████  252
Launchpad 下载量代表 PPA 软件包下载量,而非独立用户数。