mirror of
https://github.com/ptitSeb/box64.git
synced 2026-11-07 09:26:11 -10:00
Updated README (#3418)
* Updated README * Remove youtube channels * compat list
This commit is contained in:
Yang Liu authored and GitHub committed
1 parent
47e2b974fc
commit
22f31e73bf
3 files changed
+26
-44
No files matched your search
@@ -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
|
||||
----
|
||||
|
||||
+12
-21
@@ -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 库。
|
||||
|
||||
----
|
||||
|
||||
结语
|
||||
|
||||
+2
-2
@@ -1,3 +1,5 @@
|
||||
> Внимание: Этот документ устарел. Пожалуйста, помогите нам его перевести.
|
||||
|
||||
|
||||
|
||||
Емулятор простіра користувача 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/).
|
||||
|
||||
Reference in new issue
Block a user