CrackerCat / Box64Droid

Running x86_64 applications on Android

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Box64Droid

Box64Droid is a project with scripts that automate installing on Android preconfigured rootfs with Box64, Box86, Wine GE 8-12, DXVK, D8VK installed. Originally was fork of Box4Droid with Box64. Still in beta stage, can't launch all games in the world in 4K 60 FPS, note it when you trying launch AAA games. Project site available here

Installation instructons

Install Termux and Termux-x11, then in Termux run Box64Droid install command: curl -o install https://raw.githubusercontent.com/Ilya114/Box64Droid/main/scripts/install && chmod +x install && ./install

After the installation is completed, type box64droid --start, starting script will start Termux-X11 and show start menu.

You also can use Input Bridge, install 0.1.9 apk then just run app in Android and in Wine from start menu

System requirements

  • Adreno 610+ (Another supporting by VirGL but much games don't working)
  • Android 12+ (non-root, VirGL version), Android 10+ (root version)
  • 64-bit Android
  • You also need at ~4,0 (for root version), 4,4 (for non-root version) and ~3,3 GB (for VirGL version) free space for the installation without problems.
  • If you want get more FPS and stability, use root version (you need root rights on your device)

Configuring

You can choose to use environment variables, there are 3 files, DXVK_D8VK.conf, Box64Droid.conf and DXVK_D8VK.conf. These files are created and found in the /sdcard/Box64Droid/ folder after the first Box64Droid run.

The Box64Droid.conf file is with rootfs, Box86, Box64 and Wine configuration. You can use the Box86 and Box64 environment variables, see all of them here and here. You can add as many variables as you like.

The DXVK_D8VK_HUD.conf file is for you to use the environment variables referring to DXVK_HUD.

The DXVK_D8VK.conf file is for you to use the environment variables referring to dxvk.

Known issues

  • Error when updating Termux packages. Clear Termux data will help.
  • Android 12+ can kill Termux, you may get [Process completed (signal 9) - press Enter], to fix run this command in adb shell: adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"
  • "Control" menu in Wine (in Wine Proton 8.0-2 working fine) shows nothing. You can just open control using "Run"
  • Box64Droid can exit after start. This is a TFM issue, no have idea why and how to fix.
  • Winetricks runs a long of time when Proton installed (non-root version)

If you have another problems you can ask me in:

News about project publising in Telegram channel.

Instructions how to mount SD-card external HDD/SSD (chroot version)

If you want mount sdcard or external HDD (SSD), you need to add mountpoint maually. For SD-card go to /storage and see (sudo ls) folder example 8D3E-2B7K. For external drives go to /mnt/media_rw and see folder like C3G3H6B8A56212H7. Type nano $PREFIX/bin/box64droid and add mount command before sudo chroot login ... line: sudo mount --bind /mnt/media_rw/drivename (or /storage/sdcardname) $ROOTFSPATH/needfolder. You need to create needfolder yourself in ~/ubuntu folder by using sudo mkdir foldername

Things to note

Some issues/instabilities can happen when using Box86 and Box64 in proot environment, so it's not recommended to use Box86 and Box64 in proot as debug/testing environment, there are better options for that.

Applications and scripts which using in Box64Droid

Thanks to:

  • Herick75 - for Mesa Turnip patches which make possible compile it
  • Inguna87 - for start chroot fix for MIUI and Oxygen
  • Alfhashut - inspired me to try VirGL again and trying help me with him

About

Running x86_64 applications on Android

License:GNU General Public License v3.0


Languages

Language:Shell 100.0%