How to Set Up RetroArch on Apple TV

What RetroArch is and what you need before starting

RetroArch is an emulator that lets you play classic video games from older gaming systems on your Apple TV. It runs games from systems like the Nintendo Entertainment System (NES), Super Nintendo (SNES), Sega Genesis, and dozens of others. RetroArch itself is free software, but you will need to provide your own game files — either ones you own or ones you have created yourself.

Before you begin, you will need an Apple TV (4th generation or newer), a computer to read files, and a way to transfer those files to your Apple TV. Most people use either a USB drive or a network connection. You will also need a compatible controller — the Apple TV remote works, but a Bluetooth game controller like an Xbox or PlayStation controller is much more practical for gaming.

RetroArch is not available in the Apple App Store. You will install it using a method called sideloading, which means transferring the app directly to your Apple TV rather than downloading it through Apple's official store. This process is legal and straightforward, but it does require a few extra steps compared to a normal app installation.

Key Takeaways

RetroArch must be sideloaded onto your Apple TV using Xcode on a Mac or a third-party tool like AltStore on Windows, since it is not available in the App Store.
You will need an Apple TV 4th generation or newer, a compatible controller, and your own game files to use RetroArch.
The sideloading process takes 20 to 30 minutes the first time and requires an Apple ID with developer settings enabled.
Once installed, you configure RetroArch by pointing it to the folder where your game files are stored, then launch games directly from the app.
RetroArch updates regularly, and you will need to resideload the app every few months or when a major update is released.

Preparing your Apple ID and Apple TV for sideloading

Sideloading requires your Apple TV to be in developer mode. Start by going to Settings on your Apple TV, then navigate to Apps > Developer. Toggle Developer Mode on. Your Apple TV will restart, and you may see a warning — this is normal and expected.

Next, note your Apple TV's name and the Apple ID you use on it. You will need both during the sideloading process. If you do not know your Apple TV's name, go to Settings > AirPlay and HomeKit and look for the device name listed there. Make sure your Apple TV and the computer you are using are on the same Wi-Fi network.

Sideloading RetroArch on a Mac using Xcode

If you have a Mac, the most straightforward method is using Xcode, Apple's free development tool. read Xcode from the Mac App Store, then read the RetroArch tvOS build from the official RetroArch website (retroarch.com). Look for the file labeled "tvOS" — it will be a .ipa file.

Open Xcode and go to Window > Devices and Simulators. Select your Apple TV from the list on the left. Drag the RetroArch .ipa file into the "Installed Apps" section. Xcode will ask for your Apple ID credentials — enter them when prompted. The installation will take a few minutes. Once it finishes, RetroArch will appear on your Apple TV's home screen.

Sideloading RetroArch on Windows using AltStore

Windows users can use AltStore, a third-party sideloading tool. read AltStore from altstore.io and install it on your Windows computer. You will also need to read the RetroArch tvOS .ipa file from retroarch.com.

Open AltStore and sign in with your Apple ID. Connect your Apple TV to the same Wi-Fi network as your computer. In AltStore, click the plus icon and select the RetroArch .ipa file you downloaded. AltStore will handle the rest, transferring the app to your Apple TV over the network. This process takes 5 to 10 minutes. When it finishes, RetroArch will be on your Apple TV's home screen.

Setting up game files and configuring RetroArch

RetroArch needs to know where your game files are stored. The easiest method is to use a USB drive. Copy your game files into a folder on the USB drive — organize them by system if you have many games (for example, a "NES" folder, a "SNES" folder, and so on). Plug the USB drive into your Apple TV.

Launch RetroArch on your Apple TV. Go to Settings > File Browser and navigate to your USB drive. Point RetroArch to the folder containing your games. Once you have done this, RetroArch will scan the folder and display all the games it recognizes. You can now select a game and press play to start it.

If you prefer not to use a USB drive, you can transfer game files over your home network using a computer. This is slower but does not require a physical drive. RetroArch has a built-in file manager that can browse network shares — consult the RetroArch documentation for network setup instructions specific to your setup.

Choosing and configuring a controller

The Apple TV remote can navigate RetroArch's menus, but it is not ideal for playing games. A Bluetooth game controller is much more practical. RetroArch works with most standard controllers, including Xbox controllers, PlayStation controllers, and dedicated retro-style controllers designed for emulation.

Pair your controller to your Apple TV first by going to Settings > Remotes and Devices > Bluetooth. Once paired, launch RetroArch and go to Settings > Input > Port 1 Controls. RetroArch will ask you to press each button on your controller to map it. Follow the on-screen prompts and press each button when asked. Once mapping is complete, your controller will work with all games you play in RetroArch.

Updating RetroArch and troubleshooting common issues

RetroArch releases updates regularly. Because you sideloaded the app rather than installing it from the App Store, you will not receive automatic updates. Check the RetroArch website every few months for new releases. When an update is available, read the new .ipa file and repeat the sideloading process using Xcode or AltStore. The new version will replace the old one on your Apple TV.

If RetroArch crashes when you try to launch a game, the most common cause is that the game file is corrupted or in an unsupported format. Try a different game to confirm RetroArch itself is working. If a specific game consistently crashes, try downloading a different version of that game file. If RetroArch will not launch at all, try removing it and sideloading it again — sometimes the installation becomes corrupted, and a fresh install fixes the problem.

If your controller does not respond in games, go back to Settings > Input and check that your controller is still mapped. Occasionally a controller will unpair from your Apple TV — if this happens, pair it again and re-map it in RetroArch. If you are having network issues transferring files, make sure your Apple TV and computer are on the same Wi-Fi network and that your router is not blocking the connection between them.

Frequently Asked Questions

Do I need a Mac to sideload RetroArch?

No. You can use a Mac with Xcode, or a Windows computer with AltStore. Both methods work equally well. If you have neither, you can also use a Linux computer with command-line tools, though that method is more technical.

Will RetroArch work with the Apple TV remote?

Yes, but it is not practical for gaming. The remote can navigate menus and launch games, but playing games with it is difficult because it lacks a traditional game controller layout. A Bluetooth game controller is strongly recommended.

Where do I get game files for RetroArch?

You can use game files you own or have created yourself. RetroArch does not include any games — you must provide them. Many classic games are available through official re-releases or collections, and you can also find ROM files online through various sources.

What happens if I unplug my USB drive while playing a game?

The game will likely crash. Always keep your USB drive plugged in while using RetroArch. If you want to move game files around, do so before launching RetroArch, not while games are running.

Can I use RetroArch on older Apple TV models?

RetroArch requires Apple TV 4th generation or newer. If you have an older model, you will not be able to sideload or run RetroArch. Check your Apple TV's model in Settings > About if you are unsure which version you have.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.