Guide

Azahar Setup Guide: 3DS Emulation on Handhelds in 2026

Cole StubblefieldBy Cole Stubblefield 2026-05-31 Updated 2026-09-07
Azahar Setup Guide: 3DS Emulation on Handhelds in 2026 — Emulator Setup guide for retro handhelds | Held Games

Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate, we earn from qualifying purchases at no extra cost to you. Learn more.

2026-05-31 · Setup guide

Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate, we earn from qualifying purchases at no extra cost to you. Learn more.

The Nintendo 3DS has one of the best libraries of any handheld, and 3DS emulation has come a long way. After the original Citra project shut down, the community carried the work forward. Azahar is the modern, actively developed 3DS emulator that most people now use.

This guide covers Azahar on handhelds. We look at the best devices, including the standout option for true dual screen play, plus the install steps, the system files you need, and the settings that matter. We only ever cover playing games you legally own.

What 3DS Emulation Needs

The 3DS has the same two screen design challenge as the DS, plus more graphical horsepower to emulate. A few things matter:

  • Two screens worth of display. The 3DS used a top screen and a bottom touchscreen. You need a layout that shows both, or a device with two physical screens.
  • A capable GPU. 3DS games upscale beautifully, and the higher you push internal resolution, the more GPU you want.
  • Touch input. The bottom screen is a touchscreen. A device with its own touchscreen makes this effortless.

The good news is that 3DS emulation upscaled on a modern handheld can look better than the original hardware ever did.

Best Handhelds for 3DS Emulation

This is the one category where a special device exists.

  • AYN Thor. The Thor has two physical AMOLED screens, which makes it the definitive 3DS device. The top game screen and the bottom touchscreen work exactly as the original hardware intended.
  • AYN Odin 3 and Odin 2 Portal Pro. Powerful single screen devices that upscale 3DS beautifully, with the two screens stacked or arranged on one panel.
  • Retroid Pocket 6. A strong, affordable single screen option with a touchscreen for the bottom panel.
  • Steam Deck and PC. Excellent for 3DS, with lots of GPU headroom for high resolution upscaling.

For the full hardware breakdown, see our best handhelds for DS and 3DS emulation guide.

Installing Azahar

On Android Handhelds

  1. Download the latest Azahar build from the official project page or its official GitHub releases.
  2. Install the APK, allowing installs from unknown sources if needed.
  3. Launch Azahar once so it sets up its folders.
  4. Add the system files and your games (next sections).

On Steam Deck and PC

Azahar runs on Windows, Linux, and macOS. On the Steam Deck, the easiest path is through a front end. Both our RetroDECK setup guide and EmuDeck setup guide cover managing it. RetroDECK added Azahar in a recent update.

System Files and Your Games

This is the part to do correctly, and it is similar to other Nintendo systems.

3DS emulation needs encryption keys and system files that come from a 3DS console. The only legal source is a 3DS that you own. You dump the keys and your games from your own console using homebrew tools such as GodMode9. We do not link to or describe ROM download sites, and we do not cover obtaining games or keys you do not own.

Once you have dumped your own games, they will be in a 3DS game format that Azahar can open. Point Azahar at the folder, and your titles appear in the library.

A simple rule. If it did not come off a console you own, this guide does not cover it.

Settings That Matter

A few settings make a big difference on handhelds.

  • Internal resolution. Push this up for sharp, clean visuals. Higher settings look great but cost GPU power. Start at 2x and climb if your device keeps full speed.
  • Screen layout. On single screen devices, choose a stacked or side by side layout. On the AYN Thor, assign the top screen to the top panel and the bottom screen to the touchscreen.
  • Touchscreen input. If your device has a touchscreen, enable direct touch for the bottom screen. If it does not, map the touch cursor to the right analog stick.
  • Shader and accuracy options. Leave these at sensible defaults unless a specific game needs a change.

Picking an internal resolution that actually fits your screen

This is where most people leave quality on the table, and the maths are simple.

The 3DS top screen is 400x240. The bottom screen is 320x240. Those are small numbers, which is why 3DS games clean up so well when you scale them.

Multiply by whole numbers and every original pixel becomes an even block, so the image stays sharp with no shimmer. 2x gives you 800x480. 3x gives you 1200x720. 4x gives you 1600x960.

On a 1080p handheld, 3x is the sweet spot for most people. It is a clean multiple, it fits comfortably inside a 1080p panel, and it costs far less GPU time than 4x. Going to 4x on a 1080p screen means the image gets scaled back down again, which throws away the sharpness you just paid for.

Our integer scaling explainer covers why whole number multiples matter more than raw resolution.

Screen layouts, and which one to use

This is the 3DS specific decision, and it is worth understanding the trade before you pick.

LayoutBest forThe trade
Large screen (top big, bottom small corner)Most action and adventure gamesBottom screen is small, fine when it is just a map
Stacked (top over bottom)Games with real bottom screen interactionBoth screens shrink to fit
Side by sideWide screens, and games you touch oftenWastes vertical space on a 16:9 panel
Separate windows or dual panelTwo screen devices onlyNeeds hardware like the Thor
Single screen (top only)Games that barely use the bottomYou lose the map and menus

For most libraries, the large screen layout is the right default. Games that genuinely need the bottom screen, and inventory heavy RPGs in particular, are the ones worth switching to stacked for.

Performance: What Actually Runs

3DS emulation is more demanding than DS emulation, and the load varies a lot by game.

TierWhat to expectTypical hardware
2D and simple 3D gamesFull speed with room to upscaleAlmost any modern Android handheld
Mainstream 3D gamesFull speed at 2x to 3xSnapdragon 8 Gen 2 class and up
The heavy endNeeds tuning, sometimes native resolutionFlagship Android or a PC handheld

The games that ask the most are the ones that pushed the original hardware hardest. Large 3D environments, heavy particle effects and games that already dipped below their target frame rate on a real 3DS are the ones to expect trouble from. If a game ran at 30fps on the console, emulating it at 60 is not something the emulator can simply hand you.

If a game struggles, drop internal resolution first. It is almost always the biggest single cost, and going from 3x to 2x frees up far more headroom than any other single setting.

Common Problems and Fixes

These come up constantly, and most have quick answers.

Stuttering for the first few minutes, then smoothing out. That is shader compilation. The emulator builds shaders the first time it meets them, and caches them afterward. Play through an area once and it settles. Do not judge performance on a first run.

Audio crackling or stretching. Usually a symptom rather than a cause. The audio stretches because the emulator is not hitting full speed. Fix the frame rate and the audio follows. Our audio crackle guide covers the general principle, and it applies here.

Games will not appear in the library. Azahar only scans the folders you point it at. Check the directory is added, and check your files are in a format it recognises rather than sitting inside an archive. Our ROMs not showing up guide walks through the usual causes.

Black screen on launch. Almost always missing system files. 3DS emulation needs the keys and system data from a console you own, and without them many titles will not boot at all.

Touch controls feel wrong on a single screen device. If the device has a touchscreen, use direct touch. If it does not, map the pointer to the right stick and slow the sensitivity down. Stick driven pointers feel bad at default speeds.

The device gets hot and slows down after twenty minutes. That is thermal throttling rather than an emulator problem. 3DS emulation is a sustained load, and thin handhelds throttle. Lower the internal resolution a step and it usually stabilises.

Saves and Backups

Azahar stores saves in its data folders. Back them up before app updates or device moves. Our save state management guide and how to back up saves across firmware updates cover safe habits.

Frequently Asked Questions

What is Azahar?

Azahar is the modern, actively developed 3DS emulator that the community built after the original Citra project ended. It runs on Android, Windows, Linux, and macOS.

What is the best handheld for 3DS emulation?

The AYN Thor, because it has two physical screens. Powerful single screen devices like the AYN Odin 3 and Retroid Pocket 6 are also excellent.

Do I need system files for 3DS emulation?

Yes. You need encryption keys and system files dumped from a 3DS you own, along with your own dumped games. We only cover playing games you own.

Can I play 3DS games at higher resolution?

Yes. Raising the internal resolution makes 3DS games look sharper than the original hardware. Higher settings need more GPU power. On a 1080p handheld, 3x is the sweet spot, because it is a clean whole number multiple that fits inside the panel without being scaled back down.

Is Azahar the same as Citra?

No, but it is the successor. The original Citra project shut down, and Azahar is the actively developed emulator the community continued the work in. If you are following an old Citra guide, most of the concepts carry over but the builds and download locations do not.

Why is 3DS emulation stuttering at first and then fine?

That is shader compilation. The emulator compiles shaders the first time it encounters them and caches them afterward, so the first run through an area is choppy and every run after it is smooth. Do not judge performance on a first playthrough.

Which screen layout should I use?

Large screen is the right default for most games, with the top screen big and the bottom tucked in a corner. Switch to stacked for games that genuinely use the bottom screen, such as inventory heavy RPGs.

Why does my device slow down after twenty minutes?

Thermal throttling rather than an emulator fault. 3DS emulation is a sustained load and thin handhelds heat up. Dropping the internal resolution one step usually stabilises it.

Can I use Azahar without a 3DS console?

Not legitimately. Azahar needs encryption keys and system files that come from 3DS hardware, and your games need to be dumped from cartridges or your own digital library. We only cover playing games you already own.

Related reading