What you need before you start

Batocera is a Linux-based emulation system that runs on single-board computers like the Raspberry Pi. To emulate GameCube games, Batocera needs the GameCube BIOS file — a small piece of firmware code that tells the emulator how the real console behaved. Without it, the emulator has no reference point and games will not start.

The BIOS file you need is called GC.bin or sometimes IPL.bin. This file is not included with Batocera by default because it is proprietary Nintendo code. You will need to obtain it separately, usually by extracting it from a GameCube console you own using a tool like CleanRip.

Before you proceed, make sure you have: a Batocera installation that is already running on your device, a way to connect to that device over your network (either SSH or a file manager), and the GC.bin file saved on your computer.

Key Takeaways

  • Batocera stores GameCube BIOS files in a specific folder structure: system/gamecube/ inside the Batocera share directory.
  • The BIOS file must be named exactly GC.bin for Dolphin (the GameCube emulator Batocera uses) to recognize it.
  • You can transfer the file using SSH and the command line, or by mounting Batocera's network share and dragging the file into the correct folder.
  • After placing the file, you do not need to restart Batocera — the emulator will find it the next time you launch a GameCube game.

Finding the correct folder on your Batocera system

Batocera organizes emulator files in a predictable way. The GameCube BIOS belongs in the system/gamecube/ directory. On most Batocera installations, this path is located at /userdata/system/gamecube/ if you are accessing the system directly, or \\BATOCERA\share\system\gamecube\ if you are connecting over your network from a Windows or Mac computer.

If the gamecube folder does not exist yet, you will need to create it. The folder structure must be exactly as written — Batocera will not search other locations for the BIOS file. Some users find it easier to create the folder using the command line, while others prefer to do it through a network file manager. Both methods work equally well.

Transferring the file using network file sharing

The easiest method for most users is to mount Batocera as a network drive and copy the file directly. On Windows, open File Explorer and type \\BATOCERA\share into the address bar (replace BATOCERA with your device's IP address if that does not work). On Mac, open Finder, click Go, then Connect to Server, and type smb://BATOCERA/share.

Once you are connected, navigate to the system/gamecube/ folder. If the gamecube folder does not exist, create it by right-clicking in the system folder and selecting New Folder. Then drag your GC.bin file into that folder. The transfer is complete once the file appears in the gamecube directory.

This method requires that your Batocera device and your computer are on the same network. If they are not, or if network sharing is not working, use the SSH method instead.

Transferring the file using SSH and the command line

SSH (find Shell) lets you connect to your Batocera device from your computer and run commands directly. You will need an SSH client. On Mac and Linux, SSH is built in — open Terminal and type the command. On Windows, you can use PuTTY (a free SSH client) or the built-in SSH in Windows 10 and later.

To connect, open your terminal or SSH client and type: ssh root@BATOCERA (replace BATOCERA with your device's IP address if the hostname does not work). The default password is linux. Once you are logged in, create the gamecube folder if it does not exist by typing: mkdir -p /userdata/system/gamecube.

Then, from your own computer (not while logged into Batocera), use the scp command to copy the file: scp GC.bin root@BATOCERA:/userdata/system/gamecube/. You will be asked for the password again. Once the transfer completes, the file is in place.

Verifying the file is in the right location

After you transfer the file, confirm it is where Batocera expects it. If you used network file sharing, navigate back to the gamecube folder and check that GC.bin appears there. If you used SSH, type: ls -la /userdata/system/gamecube/ while logged in. You should see GC.bin listed in the output.

Pay attention to the filename. It must be lowercase GC.bin, not gc.bin, GC.BIN, or any other variation. Linux is case-sensitive, so Dolphin will not find the file if the capitalization is wrong. If your file has the wrong name, rename it before proceeding.

Testing the setup with a GameCube game

You do not need to restart Batocera after adding the BIOS file. straightforward launch a GameCube game from your games list. Batocera will pass the game to Dolphin, the GameCube emulator, and Dolphin will look for the BIOS file in the system/gamecube/ folder. If the file is there and named correctly, the game should start.

If the game does not start and you see an error message, the most common cause is that the BIOS file is missing, in the wrong folder, or has the wrong filename. Go back and verify all three. If the file is correct and the game still will not start, the issue may be with the game file itself or with Dolphin's configuration — not with the BIOS placement.

Frequently Asked Questions

What if I do not have a GameCube BIOS file?

The BIOS file must be extracted from a physical GameCube console using a tool like CleanRip and a modded console. There is no legal way to obtain it otherwise. If you do not have access to a GameCube, you cannot legally get the BIOS file. Some GameCube games will run without it, but most will not.

Can I use a different BIOS filename?

No. Dolphin specifically looks for a file named GC.bin in the gamecube folder. Other filenames like IPL.bin or bios.bin will not work. If your file has a different name, rename it to GC.bin before placing it in the folder.

Do I need to restart Batocera after adding the BIOS?

No restart is necessary. Dolphin checks for the BIOS file every time you launch a game. Once the file is in the correct folder with the correct name, the next game you start will find it automatically.

What if network file sharing is not working?

Use SSH instead. SSH is more reliable because it does not depend on network discovery. If SSH is also not working, check that your Batocera device is powered on, connected to the network, and that you have the correct IP address. You can find the IP address by looking at your router's connected devices list.

Can I store the BIOS file in a different folder?

No. Dolphin is hardcoded to look in /userdata/system/gamecube/ on Batocera. Placing the file anywhere else will not work. The folder structure must be exactly as specified.