diff --git a/README.md b/README.md index e4399d442..52b349c60 100644 --- a/README.md +++ b/README.md @@ -8,12 +8,11 @@ --- -Box64 enables running x86_64 Linux programs, including games, on non-x86_64 Linux systems such as Arm (64-bit little-endian host system required). +**Check out our game compatibility list at [https://box86.org/app/](https://box86.org/app/), please help us [improve it](https://github.com/ptitSeb/box86-compatibility-list/issues)!** -Check out Box64 in action on YouTube: -- [MicroLinux](https://www.youtube.com/channel/UCwFQAEj1lp3out4n7BeBatQ) -- [Pi Labs](https://www.youtube.com/channel/UCgfQjdc5RceRlTGfuthBs7g) -- [The Byteman](https://www.youtube.com/channel/UCEr8lpIJ3B5Ctc5BvcOHSnA) +--- + +Box64 enables running x86_64 Linux programs, including games, on non-x86_64 Linux systems such as Arm (64-bit little-endian host system required). Box64 leverages native system libraries (libc, libm, SDL, OpenGL), offering ease of integration and surprising performance in many applications. For performance benchmarks, check [this analysis](https://box86.org/index.php/2021/06/game-performances/). @@ -25,7 +24,7 @@ _Logo and icon by @grayduck - Thank you!_ --- -## 📖 Usage +## Usage - `$ box64 ./program [args]` to run Linux x86_64 programs. - `$ box64 -k` to kill all the emulated processes. @@ -36,7 +35,7 @@ Box64 also offers environment variables and rcfile to control its behavior. For --- -## 🚀 Compiling and Installation +## Compiling and Installation - [Compilation Instructions](https://github.com/ptitSeb/box64/blob/main/docs/COMPILE.md) - [Bundle x86 Libraries](https://github.com/ptitSeb/box64/blob/main/docs/BUNDLE-X86-LIBS.md) @@ -44,24 +43,24 @@ Box64 also offers environment variables and rcfile to control its behavior. For --- -## 🔄 Version History +## Version History See the [Changelog](docs/CHANGELOG.md) for version updates. --- -## 🖥️ Platform Compatibility Notes +## Platform Compatibility Notes Box64 requires 64-bit libraries on the host system, as it directly translates x86_64 function calls. For 32-bit binaries, use Box86 or Box32. **Notes** -1. Box32 mode is in the making, which aims to support 32-bit binaries on Box64, you can enable it at build time, but do not expect everything to work. There is actually a few things that work, many that don't. It's a known issue, no need to create tickets about it for now. -2. Some installers may default to x86 on 64-bit host OSes, causing compatibility issues. Workaround: Use a fake `uname` that returns "x86_64" for `-m`. +1. Box32 is still experimental. +2. Some shell scripts (such as the GOG game installer) may rely on `uname -m` to determine the current architecture. Please run them as `box64 script.sh` to allow Box64 to take over. --- -## ⚙️ Configuration +## Configuration Box64 has configuration files located in `/etc/box64.box64rc` and `~/.box64rc`, both formatted as `.ini` files. If you don’t want to use the default `/etc/box64.box64rc` file, copy it to `~/.box64rc` to ensure compatibility. @@ -71,7 +70,7 @@ For more information, check [Usage Documentation](docs/USAGE.md). --- -## 📄 Additional Platform-Specific Notes +## Additional Platform-Specific Notes ### Unity Game Emulation @@ -79,10 +78,6 @@ For more information, check [Usage Documentation](docs/USAGE.md). - **Tip for Pi4 and Pi5 Users**: Set `MESA_GL_VERSION_OVERRIDE=3.2` with `BOX64_DYNAREC_STRONGMEM=1` to prevent freezes and enable strong memory mode. - **Using Panfrost**: For better compatibility on ARM, enable `PAN_MESA_DEBUG=gl3` to force higher OpenGL profiles. This can help if a game starts but quits unexpectedly before showing any content. -### GTK Programs - -Box64 wraps GTK libraries, supporting both gtk2 and gtk3. - ### Steam See [Steam Documentation](docs/STEAM.md). @@ -95,10 +90,6 @@ Box64 supports Wine64 and Proton. For 32-bit components, Box86 is required. Syst For more information, check [Wine Documentation](docs/WINE.md). -### Vulkan - -Box64 wraps Vulkan libraries. - ---- Final word ---- diff --git a/README_CN.md b/README_CN.md index ef605a582..f0068891c 100644 --- a/README_CN.md +++ b/README_CN.md @@ -8,12 +8,11 @@ --- -Box64 可以在非 x86_64 Linux 主机系统（比如 Arm）上运行 x86_64 Linux 程序（比如游戏），目前仅支持 64 位小端主机系统。 +**请查看我们的游戏兼容性列表：[https://box86.org/app/](https://box86.org/app/)，并请帮助我们[改进它](https://github.com/ptitSeb/box86-compatibility-list/issues)！** -在 YouTube 上查看 Box64 的运行效果: -- [MicroLinux](https://www.youtube.com/channel/UCwFQAEj1lp3out4n7BeBatQ) -- [Pi Labs](https://www.youtube.com/channel/UCgfQjdc5RceRlTGfuthBs7g) -- [The Byteman](https://www.youtube.com/channel/UCEr8lpIJ3B5Ctc5BvcOHSnA) +--- + +Box64 可以在非 x86_64 Linux 主机系统（比如 Arm）上运行 x86_64 Linux 程序（比如游戏），目前仅支持 64 位小端主机系统。 Box64 可以使用本机原生的系统库（libc、libm、SDL、OpenGL），有着易于集成的特性和令人惊讶的性能。如需性能基准测试，请查看[此分析](https://box86.org/index.php/2021/06/game-performances/)。 @@ -25,7 +24,7 @@ _Logo 由 @grayduck 制作，感谢！_ --- -## 📖 使用方法 +## 使用方法 - `$ box64 ./program [args]` 运行 Linux x86_64 程序。 - `$ box64 -k` 杀死所有模拟的进程。 @@ -36,31 +35,31 @@ Box64 还提供了环境变量和 Rc 文件来控制其行为。有关详细信 --- -## 🚀 编译和安装 +## 编译和安装 - [编译说明](https://github.com/ptitSeb/box64/blob/main/docs/COMPILE.md) - [安装 Wine](https://github.com/ptitSeb/box64/blob/main/docs/WINE.md) --- -## 🔄 版本历史 +## 版本历史 请参阅[变更日志](docs/CHANGELOG.md)了解版本更新说明。 --- -## 🖥️ 平台兼容性说明 +## 平台兼容性说明 Box64 直接转换 x86_64 函数调用到本机原生库，因此需要主机系统上的 64 位库。对于 32 位二进制文​​件，请使用 Box86 或 Box32。 **注意事项** -1. Box32 模式正在制作中，旨在支持 Box64 上运行 32 位二进制文​​件，敬请期待！ -2. 某些安装程序可能会将 64 位的主机操作系统判定为 x86 导致兼容性问题。解决方法：使用假的 `uname` ，并使它在运行参数为 `-m` 时返回 `x86_64`。 +1. Box32 仍然是实验性质。 +2. 某些 Shell 脚本（比如 GOG 游戏安装脚本）可能会依赖 `uname -m` 判断当前架构，请使用 `box64 script.sh` 的方式运行以便让 Box64 接管。 --- -## ⚙️ 配置 +## 配置 Box64 的配置文件位于 `/etc/box64.box64rc` 和 `~/.box64rc`，均为 `.ini` 格式的文件。如果您不想使用默认的 `/etc/box64.box64rc` 文件，请将其复制到 `~/.box64rc` 以确保兼容性。 @@ -70,17 +69,13 @@ Box64 的配置文件位于 `/etc/box64.box64rc` 和 `~/.box64rc`，均为 `.ini --- -## 📄 特定平台的其他说明 +## 特定平台的其他说明 ### Unity 游戏 - 许多 Unity 游戏需要 OpenGL 3+，这对 ARM/RISC-V SBC 来说可能具有挑战性。 - **对 Pi4 和 Pi5 用户的提示**：设置 `MESA_GL_VERSION_OVERRIDE=3.2` 和 `BOX64_DYNAREC_STRONGMEM=1` 以防止卡死并启用强内存模式。 - **Panfrost**：为了在 ARM 上实现更好的兼容性，启用 `PAN_MESA_DEBUG=gl3` 以强制更高的 OpenGL Profile。如果游戏可以启动但在显示任何内容之前意外退出，这个设置可能会有所帮助。 -### GTK 程序 - -Box64 包装了 GTK 库，支持 gtk2 和 gtk3。 - ### Steam Box64 支持 Linux Steam 和 Windows Steam，更多细节请参考[Steam 文档](docs/STEAM.md)。 @@ -95,10 +90,6 @@ Box64 支持 Wine64 和 Proton。对于 32 位组件，需要 Box86。配备 Box 有关更多信息，请参阅 [Wine 使用说明](docs/WINE.md)。 -### Vulkan - -Box64 包装了 Vulkan 库。 - ---- 结语 diff --git a/README_UK.md b/README_UK.md index c998a09fe..f5c6a9210 100644 --- a/README_UK.md +++ b/README_UK.md @@ -1,3 +1,5 @@ +> Внимание: Этот документ устарел. Пожалуйста, помогите нам его перевести. + ![Official logo](docs/img/Box64Logo.png "Official Logo") Емулятор простіра користувача x86_64 із родзинкою @@ -10,8 +12,6 @@ Box64 дозволяє запускати x86_64 Linux програми (наприклад, ігри) на системах Linux відмінних від x86_64, наприклад ARM (хост-система має мати 64-розрядний порядок редагування). -Ви можете знайти багато відео про Box64 в YouTube каналах [MicroLinux](https://www.youtube.com/channel/UCwFQAEj1lp3out4n7BeBatQ), [Pi Labs](https://www.youtube.com/channel/UCgfQjdc5RceRlTGfuthBs7g) або [The Byteman](https://www.youtube.com/channel/UCEr8lpIJ3B5Ctc5BvcOHSnA) - Оскільки Box64 використовує рідні версії деяких «системних» бібліотек, таких як libc, libm, SDL і OpenGL, його легко інтегрувати та використовувати з більшістю програм, а продуктивність у багатьох випадках може бути напрочуд високою. Подивіться на цей стендовий аналіз для прикладу [тут](https://box86.org/index.php/2021/06/game-performances/). Box64 інтегрується з DynaRec (динамічний рекомпілятор) для платформ ARM64 і RV64 забезпечуючи підвищення швидкості в 5-10 разів, ніж використання лише інтерпретатора. Деякі високорівневі відомості про те, як працює DynaRec, можна знайти [тут](https://box86.org/2021/07/inner-workings-a-high%e2%80%91level-view-of-box86-and-a-low%e2%80%91level-view-of-the-dynarec/).