subscribe
1. Update your system and install build tools:
sudo apt update && sudo apt upgrade -y
sudo apt install git build-essential cmake binfmt-support cmake-curses-gui -y
Phase 2: Downloading and Compiling
Now we’ll grab the latest code and bake it specifically for your hardware.
1. Clone the Box64 repository:
cd ~
git clone https://github.com/ptitSeb/box64
cd box64
2. Configure the build for the Switch (Tegra X1): We include -DTEGRAX1=1 for performance and -DBOX32=ON so you don't run into errors with 32-bit games.
mkdir build && cd build
cmake .. -DTEGRAX1=1 -DBOX32=ON -DBOX32_BINFMT=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo
3. Compile it: This uses all 4 of the Switch's CPU cores. It will take a few minutes—time to grab a snack!
make -j4
Phase 3: System Installation
Now we tell the Switch to actually use this new "translator" whenever it sees a PC file.
1. Install Box64 to your system files:
sudo make install
2. Restart the binary format service: This is the "handshake" that lets the Switch know, "Hey, if you see a PC app, send it to Box64."
sudo systemctl restart systemd-binfmt
3. Verify the installation: Check if it's working by asking for the version:
box64 -v
If you see a version number (like Box64 v0.3.x), you are officially ready to run PC apps!
Phase 4: Setting up the Library Path (For Steam)
Steam is picky about where its "helper files" (libraries) are. To make sure Box64 plays nice with your Steam installation, you should add the following line to the very end of your ~/.bashrc file. This tells the system to always check your Steam folder for the files it needs.
echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:~/.local/share/Steam/ubuntu12_32' >> ~/.bashrc
source ~/.bashrc