Frequently asked questions
Short answers to what people ask most. If yours isn't here, the Discord is the quickest place to ask.
Getting started
What do I need to play?
An Android device with an Adreno (Snapdragon) or Mali GPU running Android 12 or newer, plus your own games, prod.keys and firmware dumped from a Nintendo Switch you own. Lemon does not include or provide any of them.
Which devices does it run on?
Lemon is made for Adreno GPUs and, since 1.1, Mali GPUs too. Other GPUs (PowerVR, Xclipse…) are not tuned or tested. It is an Android app only; there is no version for iOS, Windows or Linux. See the next questions about Mali and about which build to download.
Can I use Lemon on a phone with a Mali or MediaTek chip?
Yes, since Lemon 1.1, in both Lemon and Lemon Lite. Mali GPUs (including Arm Immortalis, found in many MediaTek chips) cannot read the BCn compressed textures many games use, so Lemon now converts them to ASTC (and, since 1.2, BC4 and BC5 to EAC) on the GPU, with far less memory. Lemon Lite's driver downloader also offers experimental PanVK drivers made for the Mali-G720 and the Mali-G52; each GPU only sees its own.
Mali support is newer than Adreno's, so some games may still behave differently. When you report something in the Discord, say the phone and GPU model; the device overlay (Enable Device Overlay, with Show Device Model, Show GPU Model and Show Driver Version) displays them. PowerVR and Xclipse GPUs are still not supported.
Which one do I download: Lemon, Lemon Lite or Lemon Lite & Spoofed?
All three are the same emulator, built from the same code:
- Lemon: the full version, for recent high-end phones and handhelds. It includes the Lemon-Ade driver for the Adreno 830.
- Lemon Lite: lighter defaults (0.75x resolution, Fast GPU mode, asynchronous shaders on) for Adreno 6xx and 7xx and for Mali GPUs, without the bundled driver, and with the experimental PanVK drivers for Mali in its driver downloader. You can change any of those settings.
- Lemon Lite & Spoofed: Lite under another package name, so phones that give extra performance to known benchmark apps may run it faster. Experimental: it depends on the phone.
They install side by side, each with its own data. Lite can import your keys, firmware, games and saves from Lemon in the migration screen.
How do I install the keys and the firmware?
The first-run setup walks you through it: Install prod.keys and Install firmware. The firmware has to be a ZIP file. You can do the same later from the settings.
Keys and firmware must come from your own console and should be from the same version. Games from newer firmware need newer keys.
How do I add my games?
Use Add game folder and pick the folder where your games are. Lemon scans it and fills the library. It reads NSP and XCI files and also compressed .nsz and .xcz files directly.
If the list stays empty, check that you selected the right folder and that the keys are installed.
How do I install game updates and DLC?
Use Install game content and choose the update or DLC files. Installing base games this way is not allowed, to avoid conflicts; base games just go in your games folder.
If an installation fails, make sure the files are valid and that prod.keys is installed.
Can I bring my saves from another emulator?
Yes. If you come from Eden, Citron or yuzu, Lemon can import your saves (and your keys and firmware, if it has none) without opening the other emulator. You'll find it in the first-run setup and at the top of the settings.
Playing
The game stutters the first time I play it. Is that normal?
Yes. The first time a game shows a new effect, Lemon has to prepare it (this is called compiling shaders), and that can cause a brief hitch. Lemon keeps what it prepares, so the same effect should not stutter again. Keep Disk shader cache turned on so it is remembered between sessions.
A game runs slowly. What can I try?
In order, from the least to the most invasive:
- Lower the Resolution in Settings → Graphics. It is the setting with the biggest effect.
- Set GPU Mode to Fast for that game only, from its properties. Accurate is the default in Lemon since 1.2; Fast is quicker, but a few effects, such as some particles, can look wrong.
- Turn on Force maximum clocks in Settings → Graphics → Advanced graphics (Adreno only). The phone may get warmer.
- Close other apps running in the background.
- Try another graphics driver for that game, from its properties.
The settings guide explains what each option does.
My log says the available VRAM is only 4 GiB. Can Lemon use more?
On a phone the GPU shares the device's RAM, so Lemon decides how much of it to reserve for graphics. By default it keeps that to 4 GiB to leave room for the system and the game itself, which is why a 16 GB phone still shows 4 GiB. That is intended, not a fault.
If a game with very heavy textures stutters, open Settings → Graphics → Advanced graphics → VRAM Usage Mode and choose Aggressive, which raises the limit to 6 GiB. It may help, but it also leaves less memory for Android, so on phones with less RAM the system may close Lemon in the background. We suggest it only for devices with 16 GB, and trying it on one game first.
How do I use a physical controller?
Connect it by Bluetooth or cable as you would to any Android device. Lemon detects it. If the buttons are not where they should be, open the controller settings and use Auto-map a controller, or assign each button by hand. You can hide the on-screen controls automatically when a controller is in use (Hide Overlay on Controller Input).
How do I move or resize the on-screen controls?
Open the in-game menu and choose Edit overlay. Drag a button to move it and long-press to resize it. When you finish, Lemon asks whether the layout is for this game only or for all of them.
How do I get rid of the black bars on the sides?
In Settings → Graphics → Aspect ratio, choose Fill the screen (called Stretch to window in 1.0.1). You can also find it by searching "aspect" in Settings. Switch games draw a 16:9 picture and most phones are wider, so the picture gets slightly stretched. For true widescreen without stretching, install the game's widescreen (ultrawide) mod as an add-on: it shows more of the scene on the sides instead of stretching it.
Does motion control (gyro) work?
Yes, Lemon uses your device's gyroscope and accelerometer. From version 1.0 they follow every screen rotation, so they also work on foldables and tablets held in landscape.
How do I use Quick Save and Quick Load?
From the in-game menu, Quick save state stores the exact moment you are in and Quick load state brings you back to it, even after dying or moving on in the game (from Lemon 1.0.1). It is experimental: if the game did something since the save that Lemon cannot undo yet, the load tells you and changes nothing. The state is only kept while the app stays open, so keep using the game's own save as well.
How do I add cheat codes?
Open Cheats from the game's page or from the in-game menu. It shows the game's build ID, the version the codes have to be made for. Then:
- Download (since Lemon 1.3) gets the codes for that build from switch-cheats-db, a database updated every day from gbatemp and NX-60FPS-RES-GFX-Cheats; all credit goes to the authors of the codes. Gameplay cheats and 60 FPS/resolution/graphics cheats go in their own folders. Downloading again updates them and keeps the ones you turned on. Only the game's ID is sent, to GitHub.
- Add cheats lets you paste a cheat list made for that build ID, or use Import file for a
.txt. Lemon reads the Atmosphère format; titles without brackets work too.
New cheats start off: turn on the ones you want, even while you play. The cheat engine runs at most 1024 instructions of all the active cheats together, so Lemon will not let you turn on more than fit. Cheats installed as mods (a cheats folder) appear in the same list, and each folder has a Delete button.
A cheat made for another version of the game can do nothing, or make it misbehave or crash.
How do I set up gamepad hotkeys?
Since Lemon 1.3, in Settings → Controls → Hotkeys, with a controller connected:
- Tap Hotkey Enable and press the button you will hold for every hotkey, such as Select.
- Tap an action (Quick Save, Quick Load, the performance or device overlays, pause, exit), hold the buttons for it together and let go. Pick buttons the game does not need together.
In a game, hold Hotkey Enable with those buttons. A quick tap of Hotkey Enable on its own still reaches the game, and so does holding it alone. Exit takes a second press within two seconds, unless you turn off Confirm on Exit?.
Can I keep more than one quick save?
Yes, since Lemon 1.4. Each Quick Save goes into a new slot and Quick Load loads the newest. Quick saves to keep goes from 1 to 4 (2 by default), and each save takes 1 to 2 GB.
Load save, in the in-game menu or as a hotkey, lists the saves of this session with a picture. Loading an older one deletes the newer ones, and Lemon asks first. Saves don't carry over to the next time you start the game.
How do I make an on-screen button stay pressed or repeat?
Since Lemon 1.4, open the overlay editor from the in-game menu and tap the button. Under When pressed, choose:
- Toggle: a tap holds it down and the next tap lets it go. Useful for a run button you would otherwise have to hold.
- Turbo: it repeats while your finger is on it.
Keeping the layout for one game keeps these choices for that game. Button slide, in the overlay's options, lets a finger move between buttons without lifting it.
Can I move updates and DLC to a microSD card?
Yes, since Lemon 1.4, together with the rest of the emulated NAND. In Settings → Content and data → Custom Paths → NAND Directory, pick a folder on the card and accept the copy. Lemon checks the free space, copies the firmware, updates, DLC and saves, and then asks whether to delete the old copy to free up the space.
Close the game first. A card formatted as FAT32 can't hold files over 4 GB, so use exFAT. A slow card can make loading times longer.
How does the Lemon Cheater work?
It finds a number in the game's memory so you can change it (lives, coins, health…). Open it from the in-game menu, then:
- Pick Integer for whole numbers or Float for decimals.
- Type the value you see on screen and press New search.
- Change the value in the game, type the new one and press Refine. Repeat until few results remain.
- Tap a result to write a new value. The padlock keeps it fixed.
If you do not know the value, use Blind search and then Increased, Decreased or Unchanged. Freezing the wrong address can make a game misbehave or crash.
What is Lemon FG? Does Lemon use Lossless Scaling?
Lemon FG is Lemon's own frame generation, written for Lemon: it adds computer-made pictures between the real ones so motion looks smoother. It is built in, needs nothing else and contains no Lossless Scaling code. Turn it on in Settings → Graphics → Frame generation, or for one game from its properties. It costs some graphics power and can add a little delay to the controls.
The Engine option can also use Lossless Scaling instead, but only with your own copy of Lossless.dll, from the Lossless Scaling you bought; Lemon does not include or download it. The FPS counter says which one is running: Lemon FG or LSFG.
Does multiplayer work?
Lemon can host and join multiplayer rooms (ad-hoc play and lobbies). To use public lobbies you set a username and a web token in the system settings. Nintendo's own online services are not part of the project.
Fixing problems
Something doesn't work and it should. What is the simplest fix?
Put the settings back to the defaults of a fresh install. Open Settings and press the red Reset all settings card at the bottom. Most odd behaviour after trying many options comes from a setting that was changed and forgotten, and this removes all of them in one step.
Your games, saves, keys and firmware are not touched, and your game folders and storage locations are kept. A box in the confirmation lets you also delete the custom settings of every game, which is the full clean slate. Then try the game again. If it works, change one option at a time so you can see which one caused the problem. If it still fails, tell us in the Discord.
To start over for just one game, open that game's settings and use Reset this game's settings.
A game crashes on start or shows a black screen
Try these, in this order:
- Check that
prod.keysand the firmware are installed and match each other. A game made for newer firmware may need newer keys. - Check that the game file is complete and not damaged. A new dump is the best proof.
- Try another graphics driver for that game, from its properties. Lemon already falls back to the system driver by itself when a game fails to start with the bundled Lemon-Ade driver.
- If it keeps happening, tell us in the Discord with the game name, your device and the build number from About.
A game stays stuck loading, over and over
Force Lemon to close and open it again. Open your phone's Settings (not Lemon's), go to Apps → Lemon (or Lemon Lite) and press Force stop. Swiping Lemon away from the recent apps doesn't always close it completely. Then start the game again.
If it keeps happening with the same game, tell us in the Discord with the game name, your device and the build number from About.
A game says keys or firmware are missing
Install prod.keys and the firmware (see "How do I install the keys and the firmware?"). Newer games need newer firmware and keys than older ones. Without keys, Lemon can't open most commercial games.
A game gets stuck on the Mii screen, "searching for Miis"
Check that your keys and your firmware come from the same version. Keys are sometimes published with the wrong version label (for example, keys for firmware 22.x labeled as 23), and then the Mii data cannot be read. Try a matching keys and firmware pair.
Textures flicker or blink in some games
Since Lemon 1.1 the game waits for the GPU before it reuses what was drawn, which fixed the flickering most games showed (Garfield, Dragon Ball and others). Lemon 1.2 makes that wait lighter, and Lemon uses the Accurate GPU mode by default, which also fixes a few effects such as some particles.
Lemon Lite and Lemon Lite & Spoofed use Fast by default, to save performance. If a game flickers or shows wrong effects there, set Settings → Graphics → GPU Mode to Accurate for that game only, from its properties.
A game runs slower since Lemon 1.2
Lemon 1.2 uses the Accurate GPU mode by default (Lemon Lite keeps Fast). The optimizations in this version pay for most of its cost, but a heavy game can still lose a few frames per second. If a game looks fine for you in Fast, set GPU Mode to Fast for that game only, from its properties.
The GPU Fence Behavior option from 1.1 is gone: Lemon now always uses one lighter wait for the GPU, which avoids the flickering and most of the slowdown it caused, with nothing to set.
Tears of the Kingdom: the grass disappears after a while
Update to Lemon 1.2: the grass stays without touching any option. Lemon 1.1 only kept it with Use reactive flushing turned on for the game; that option no longer exists.
Colored lines or streaks cover the screen (Luigi's Mansion 3 and others)
Thin purple, red and green lines scattered over the picture come from the resolution scaler in some games. There are two ways around it:
- Keep your resolution and turn on the fix: open Settings → Graphics → Game fixes (Graphics → Hacks before 1.1) and enable Enable Legacy Rescale Pass (available from Lemon 1.0.1; earlier versions don't show it). It makes the shader compiler handle scaling in an older, simpler way. You can set it for one game only from its properties. (Thanks, Elegant Demise!)
- Or set Resolution to 1X (Native): the lines come from scaling, so they don't appear without it. The picture is less sharp.
It fixed Luigi's Mansion 3 for the people who reported it. It is a workaround, so it may not fix every game with this symptom. If it doesn't, tell us in the Discord with the game and your phone model.
The game crashes during video cutscenes
In Settings → Graphics → Advanced graphics, change NVDEC Emulation to CPU. That is what the app itself recommends if a game crashes on cinematics.
There is no sound
Open Settings → Console, under Audio. Check that Volume is not at zero and that Output engine is not set to Null (that option turns the sound off). Auto is the safe choice; if there are problems, try another engine.
Where are my save files and how do I back them up?
Open the game's properties and use Save data: from there you can manage, import, export or delete that game's saves. Export a copy before you uninstall the app, change device or delete data, because uninstalling Lemon removes its data too.
How do I report a bug?
The fastest way is the Discord. Written reports can also be sent from the GitHub form. Either way, tell us:
- Device and GPU, for example AYN Odin 3, Adreno 830.
- Android version.
- Lemon version: tap the build number in About to copy it.
- Game and, if you have one, its update version.
- What happens and what you expected.
- Steps to reproduce it.
- Logs and screenshots: use Settings → Help → Share logs: send the emulator log, and the GPU or crash log if the app closed.
Before you send it, try Reset all settings: it solves many problems on its own.
About the project
How do updates work?
On launch, Lemon checks its own server for a newer release and offers to download and install it. If the server can't be reached, it checks the GitHub mirror instead. You can turn this off in Settings → Lemon, and you can also check by hand from About.
Where should I download Lemon from?
Only from git.lemon-emu.org, this website, or the GitHub mirror. Be careful with other sites that offer "Lemon APK" files: we can't vouch for them.
What is Lemon-Ade?
It is a graphics driver for Adreno GPUs, based on the open-source Turnip driver and adjusted for Lemon. It comes inside the app and is chosen automatically on the Adreno 830, with an automatic fallback to the system driver if a game fails to start with it. You can also install other drivers from the driver manager.
Is Lemon free? Is it legal?
Lemon is free software under the GNU GPL v3 or later; the source code is public. Emulation itself is legal, but you must use your own games, keys and firmware, dumped from a console you own. We don't provide them and we don't help to get them.
Can I contribute to the project?
Lemon is a small project and is not actively looking for outside code contributions, but feedback and bug reports are very welcome in the Discord. If you want to support it, there is a Ko-fi and a Buy me a coffee page.
Known issues
FIFA: some players' faces show odd colors
In FIFA 23, the faces of some players can show up in a wrong color (red or blue, for instance). It varies from one run to the next. We are investigating it. Player indicators, shadows, lines and text are not affected.
Quick Save / Quick Load is experimental
It is verified on demanding games, including loading after dying, but other games may do something it cannot undo yet: then the load tells you and changes nothing. The state is lost when the app closes. Don't rely on it as a replacement for the game's own save.