How to Install Games on RetroPie via Wi-Fi: 4 Working Methods + Troubleshooting

Installing games on RetroPie through Wi-Fi — the most convenient way to expand your retro game collection without constantly connecting flash drives or memory cards. This is especially relevant for miniature devices like Raspberry Pi Zero 2 W, where physical access to ports is limited. However, many users encounter problems: Samba it doesn't connect, then FTP If a permissions error occurs, the games don't appear in the menu after copying. This article will discuss All current methods for transferring ROMs over a wireless network - from the classical Samba to alternative protocols like SCP, as well as typical mistakes and their solutions.

It is important to understand that the transfer method depends on your operating system (Windows, macOS, Linux) and model. Raspberry PiFor example, on Pi 5 With gigabit Wi-Fi, games copy almost instantly, and on Zero W Network optimization may be required. We'll cover general instructions, but take into account the nuances for different versions. RetroPie 4.8+ And Raspberry Pi OS Bullseye/Bookworm.

1. Preparing RetroPie to receive games over Wi-Fi

Before transferring ROMs, you need to configure the network and activate the corresponding services on RetroPieWithout this, none of the protocols (Samba, FTP, SSH) will not be available.

First, check your Wi-Fi connection:

1. In the main menu RetroPie select RetroPie → WiFi.
2. If the network is not listed, click Connect to WiFi network and enter your access point details.
3. Once connected, write down the local IP address of the device (displayed in the menu WiFi or through the command hostname -I in the terminal).

Next, activate file transfer services:

• 📂 Samba — a protocol for exchanging files over a local network (analogous to "Network Neighborhood" in Windows). Included in RetroPie → RetroPie Setup → Configuration / tools → samba → Enable Samba Shares.
• 🔌 FTP — an alternative to Samba, often more stable on weaker devices. Activated via RetroPie Setup → Configuration / tools → ftphost → Enable FTP Host.
• 🔐 SSH — a secure protocol for file transfer (used for SCP). Included in RetroPie Setup → Configuration / tools → ssh → Enable SSH.

⚠️ Attention: After activating services Be sure to restart RetroPie (team sudo reboot (in the terminal or through the menu). Without a reboot, the changes will not be applied, and you will not be able to connect!

If you use Raspberry Pi 4/5 with Gigabit Wi-Fi (standard 802.11ac), it is recommended to fix the IP address in the router settings. This will prevent connection problems when changing the address. On older models (Pi 3B+ and below) it is better to give preference FTP or SCP - they are less demanding on network stability.

2. Method 1: Transferring games via Samba (for Windows)

Samba — the easiest way for users Windows, as it is integrated into the system as "Network Neighborhood". After activating the service on RetroPie Folders with ROMs become available as network drives.

Connection instructions:

1. Click Win + R, enter IP-ADDRESS-RETROPIE (For example, \\192.168.1.100) and press Enter.
2. Enter your login and password:
   • Login: pi
   • Password: raspberry (if you haven't changed it)

The folder will open retropieGo to . roms, then to the folder of the desired console (for example, nes, snes).

Just drag and drop the ROM files into the folder.

If Windows asks for credentials multiple times or gives an error 0x80070035 ("Network path not found"), please check:

• 🔄 Correctness of the IP address (check it on RetroPie team hostname -I).
• 🔒 Windows Firewall settings (the port must be allowed for Samba) 445/TCP).
• 📡 Ensure your Wi-Fi connection is stable (try connecting via cable if the error persists).

⚠️ Attention: IN Windows 11 support SMB1 (old version of the Samba protocol) is disabled by default. If the connection does not work, enable it. SMB1.0 V Control Panel → Programs → Turn Windows features on or offHowever, this is not safe - it is better to use FTP or SCP.

Make sure RetroPie and your PC are on the same network|Check RetroPie's IP address|Enable Samba in the settings|Restart RetroPie after making changes|Open port 445 in Windows Firewall-->

3. Method 2: Downloading games via FTP (universal for all OS)

FTP (File Transfer Protocol) is a more reliable method than Samba, especially on weak devices like Raspberry Pi Zero WIt works on all operating systems and does not require additional firewall settings.

To connect via FTP use any client:

• 🪟 Windows: FileZilla, WinSCP, or built-in Conductor (enter ftp://IP-ADDRESS-RETROPIE in the address bar).
• 🍎 macOS: Cyberduck or ForkLift.
• 🐧 Linux: gFTP, nautilus (enter ftp://IP-ADDRESS-RETROPIE in the file manager).

Connection parameters:

• Host: IP address of your RetroPie (For example, 192.168.1.100).
• Port: 22 (if FTP works via SSH) or 21 (standard FTP).
• Login: pi
• Password: raspberry (or your current password).

Once connected, go to /home/pi/RetroPie/roms/ and download the files to the folder for the desired console. If there is no folder for the console (for example, megadrive), create it manually - RetroPie automatically recognizes it the next time you launch it.

⚠️ Attention: If the FTP connection is interrupted while transferring large files (for example, images) PlayStation 1), reduce the packet size in the client settings (in FileZilla: Edit → Settings → Connection → FTP → Limit simultaneous connections). For Pi Zero W optimal value 2.

4. Method 3: Secure transfer via SCP/SSH (for advanced users)

SCP (Secure Copy Protocol) is the most reliable and secure way to transfer files, as the data is encrypted. It requires access via SSH, which is already activated in RetroPie (see section 1).

For use SCP You need a command line or terminal:

• 🪟 Windows: use PowerShell or PuTTY (team pscp).
• 🍎 macOS/Linux: Built-in terminal (command scp).

Example command for loading ROM on RetroPie:

scp /path/to/file/game.zip pi@192.168.1.100:/home/pi/RetroPie/roms/snes/

Where:

• /path/to/file/game.zip — local path to the ROM on your PC.
• pi@192.168.1.100 — connection credentials (replace IP with the current one).
• /home/pi/RetroPie/roms/snes/ — target folder on RetroPie (in the example for SNES).

To transfer multiple files, use the flag -r (recursively):

scp -r /path/to/folder/with/games/ pi@192.168.1.100:/home/pi/RetroPie/roms/psx/

SCP automatically preserves file permissions, which is especially important for ROMs with multiple files (such as games for Sega CD or PlayStation With .cue And .bin). If the game does not start after the transfer, check the permissions using the command:

chmod 644 /home/pi/RetroPie/roms/console/filename.zip

5. Method 4: Using a USB drive (an alternative for unstable Wi-Fi)

If your Wi-Fi network is unstable or RetroPie installed on a device without a network adapter (for example, Raspberry Pi Pico with custom firmware), you can use USB drive as an intermediate storage.

Algorithm of actions:

1. Connect the flash drive to RetroPie (ports USB 2.0 or 3.0).
2. In the main menu, select RetroPie → USB ROM Service.
3. Follow the instructions on the screen: RetroPie will automatically create a folder retropie-mount on a flash drive.
4. Copy the ROMs to the corresponding console folders on the flash drive (for example, retropie-mount/roms/nes/).
5. Connect the flash drive back to RetroPie and wait until copying is complete (indicator on the screen).

This method works even without an internet connection and does not require setting up network protocols. However, it is slower than transferring via Wi-Fi, and is only suitable for one-time downloads of large numbers of games.

⚠️ Attention: Not all flash drive file systems are supported. RetroPie by default. To be on the safe side, format the drive in FAT32 (cluster size - 32 KB). If you use exFAT or NTFS, install additional packages on RetroPie:

sudo apt-get install exfat-fuse exfat-utils ntfs-3g

6. Common mistakes and their solutions

Even with proper setup, problems can arise. Let's look at the most common ones:

Error: Games do not appear in the menu after copying

Reasons and solutions:

• 📁 Invalid folder: Make sure the ROM is copied to the correct directory (eg. /home/pi/RetroPie/roms/snes/, and not just in /roms/).
• 🔄 The list of games has not been updated: In the main menu RetroPie select Update Gamelists (in the section RetroPie).
• 🔧 Emulator missing: Some consoles (eg. Sega 32X or Atari Jaguar) require additional packages. Install them via RetroPie Setup → Manage packages.

Error: Unable to connect via Samba/FTP

Check:

• 🔌 Service status: On RetroPie run the commands:

  sudo service smbd status # for Samba
  sudo service proftpd status # for FTP

  If the service is not active, start it:

  sudo service smbd start
  sudo service proftpd start

• 🛡️ Router firewall: Some routers block local traffic. Disable it. AP Isolation in the Wi-Fi settings.
• 🔑 User password: If you have changed your password for pi, use a new one. You can reset it with the command passwd.

Error: Slow file transfer

Speed ​​optimization:

• 📶 Wi-Fi channel: Switch the router to a channel 5 GHz (if supported) or select a less crowded channel 2.4 GHz (For example, 1 or 11).
• 🔌 Protocol: For large files (>100 MB) use SCP instead of FTP.
• 🖥️ PC limitation: Disable your antivirus software during the transfer process—some programs scan every file, slowing down the process.

How to speed up transfer speed on Raspberry Pi Zero W?

On Pi Zero W due to a weak Wi-Fi adapter (802.11n, 150 Mbps) the speed rarely exceeds 2-3 MB/s. To speed up the process:

1. Connect via cable (via USB-OTG adapter).

2. Archive games in .zip before transferring (one large file is copied faster than hundreds of small ones).

3. Use rsync instead of SCP to transfer only modified files:

rsync -avz --progress /path/to/games/ pi@192.168.1.100:/home/pi/RetroPie/roms/psx/

7. Optimizing game storage: folder structure and file formats

To ensure that games are displayed correctly in RetroPie, it's important not only to transfer them correctly but also to organize their storage. Here are the key rules:

Folder structure:

• 📂 Each console has its own folder in /home/pi/RetroPie/roms/ (For example, nes/, genesis/, psx/).
• 🔖 Folder names must match internal identifiers RetroPieThe full list can be found in the file /etc/emulationstation/es_systems.cfg.
• 🗑️ Don't create nested folders inside roms/console/ - emulators won't see them.

Supported file formats:

Console	Recommended format	Notes
NES / SNES	.zip, .nes, .smc	For multi-file ROMs (e.g. with a chip SA-1) use .zip
Sega Genesis/Mega Drive	.zip, .md, .gen	Format .bin requires a header file .cue
PlayStation 1	.pbp (optimal), .bin + .cue	.pbp takes up less space and loads faster
Game Boy / GBA	.gba, .gbc, .zip	For Pokemon games with a save battery, use .sav-files

If you use .zip- archives, make sure they don't contain nested folders. For example, the correct structure is:

super_mario_bros.zip
├── super_mario_bros.nes

Incorrect:

super_mario_bros.zip
├── folder/
│   └── super_mario_bros.nes

8. FAQ: Frequently asked questions about installing games on RetroPie

Is it possible to stream games via Wi-Fi from a phone (Android/iOS)?

Yes, but with restrictions:

• 📱 Android: Use FX File Explorer or Solid Explorer to connect via FTP/Samba.
• 🍏 iOS: Apps like FileExplorer or FTPManager support FTP/SFTP, But Samba only available through third-party solutions (eg. Documents by Readdle).

For iPhone manual configuration may be required SFTP (port 22) due to iOS limitations.

How to transfer games to RetroPie via the cloud (Google Drive, Dropbox)?

Direct download from the cloud to RetroPie no, but you can:

1. Download files to your PC/phone from the cloud.
2. Pass them on RetroPie By FTP/Samba (see sections above).

To set up automatic synchronization, please rclone on RetroPie:

sudo apt install rclone
rclone config # configure the connection to your cloud
rclone copy google:ROMs/ /home/pi/RetroPie/roms/ --progress

Why don't games launch after copying?

Common causes:

• 🔧 Missing BIOS: Some consoles (eg. PlayStation 1, Sega Saturn) require BIOS files. Download them and place them in /home/pi/RetroPie/BIOS/.
• 📛 Incorrect format: For example, for N64 needed .z64 or .v64, and not .n64.
• 🔄 The emulator is not updated: Launch Update RetroPie-Setup script on the menu RetroPie Setup.

Check the emulator logs: /dev/shm/runcommand.log.

How to transfer games to RetroPie from Mac without additional software?

On macOS You can connect via Samba or SFTP without third-party software:

1. Samba: IN Finder click Cmd + K, enter smb://IP-ADDRESS-RETROPIE and log in (login pi, password raspberry).
2. SFTP: IN Terminal use:

   sftp pi@192.168.1.100
   put -r /path/to/games/ /home/pi/RetroPie/roms/snes/

Is it possible to install games on RetroPie via Bluetooth?

Technically possible, but highly not recommended:

• 🐢 Bluetooth transmission speed (~1-2 Mbps) is 10-50 times lower than Wi-Fi.
• 🔋 High battery consumption on your mobile device.
• 🔌 Additional configuration required obexftp or bluetooth-file-transfer on RetroPie.

Use Bluetooth only to transfer small files (such as saves) .sav).