
The whole setup in one paragraph: install the Winlator APK from the official GitHub releases, create one container per game, and copy your game files into the folder that maps to the container's D: drive. Then open the container and double-tap the game's EXE. Done right, your first game runs within about half an hour.
The rest of this guide walks through each step in order: the APK install, your first container, where game files go, mounting ISOs, opening EXE files, launching your first program, and getting controls working. (If you do not have the APK yet, the download guide covers getting the real file from GitHub.) Take the steps in order. Every one builds on the last, and skipping ahead is how people end up debugging three problems at once.
Step 1: Install the APK
- Download the APK from the official source linked below. Never from a mirror or a random "official site."
- Open the downloaded file. Android will ask you to allow your browser to install unknown apps. Grant it. This is a one-time, per-app permission, and it is completely normal for sideloading.
- Confirm the install. Play Protect may show its generic "unknown app" caution. That is Android being careful with all sideloaded apps, not a judgment on Winlator.
- Open Winlator from your app drawer. The first launch takes a little while as it extracts its runtime files. Give it a minute.
The official source:
the official GitHub releases pageIf anything about the download source feels uncertain, stop here and read the download safety and verification guide. Installing the wrong file first and fixing it later wastes more time than checking now.
Step 2: Understand containers before you touch anything
Winlator organizes everything into containers. A container is a self-contained Windows-like environment: its own virtual C: drive, its own registry, and its own settings for resolution, graphics driver, DX wrapper, CPU cores, and Wine configuration. Think of each container as a separate little PC.
The golden rule: one game, one container. It is tempting to install five games into one container to save time. Do not. Different games want different settings, and when something breaks you want to delete one container and start over without touching your other working games.
On the main screen you will see your container list (empty at first) and a button to create a new one. That is where we are headed.
Step 3: Create your first container
- Tap the + (create container) button.
- Give it a name you will recognize later. The game's name is the obvious choice.
- Now the settings. For your very first container, keep it simple: use the defaults as a starting point and adjust only what is suggested for your hardware:
- Resolution: start with 1280x720 or your phone's native resolution. Higher resolutions cost performance; you can raise it later once the game runs.
- Graphics driver: if your phone has a Snapdragon chip (Adreno GPU), try the Turnip driver first. Community experience favors it for most games. Other GPUs use their respective driver options.
- DX wrapper: DXVK is the usual starting point for DirectX 9 to 11 games. VKD3D is for DirectX 12 titles. WineD3D is the older fallback.
- CPU cores: give the container most of your phone's cores, but leave at least one or two free for Android itself. On an 8-core phone, 6 is a common starting value.
- Save the container.
Do not overthink these on day one. The point of the first container is to prove the pipeline works; fine-tuning comes after you have seen a game actually launch. The settings and performance guide goes deep on tuning once you are past this stage.
What starter settings suit your phone tier?
You do not need perfect settings on day one. You need sane starting points. Pick your tier, set these, and only tune after you have seen a game actually launch. These are starting defaults, not measured results:
| Flagship Snapdragon (Adreno GPU) | Mid-range chip | Entry-level / Mali GPU | |
|---|---|---|---|
| Resolution | 1280x720 to start | 1280x720 | 960x540 or lower |
| Graphics driver | Turnip (Adreno) | Turnip if available, otherwise system | System / default driver |
| DX wrapper | DXVK | DXVK | WineD3D (lighter; suits older games) |
| CPU cores | Most cores, leave 1 to 2 for Android | Most cores, leave 2 for Android | Half the cores; light games only |
| Realistic target | Best shot at demanding titles | Older and mid-tier games | 2D games, classics, light indies |
Two rules for everything after this: change one setting at a time when troubleshooting, and judge performance only after the first few minutes. Shader compilation makes the early minutes stuttery on any phone.
Step 4: Launch the container and look around
Tap your new container to launch it. You will see a Windows-style desktop: a taskbar, a desktop, a file explorer. Take a minute to get oriented. This is not a video of Windows. It is a working environment. You can open the file explorer, browse drives, and run programs.
Notice the drives. C: is the container's internal system drive. D: is the shared drive: the bridge between Winlator and your phone's storage, and it is where your game files go. Remember this: D: drive is where your games live.
Step 5: Put your game files in the right place (D: drive)
On your phone's actual storage, Winlator exposes a folder (inside the Winlator data directory, usually reachable through your file manager) that maps to the container's D: drive. The practical workflow:
- On your phone, open your file manager and find the Winlator shared folder for your container (often under the app's storage as the D: drive mapping; check the container's drive settings if you are unsure which folder it points to).
- Copy your game folder there: the full game directory, exactly as it would sit on a PC, with its EXE, data folders, DLLs, everything.
- Inside Winlator's file explorer, open the D: drive. Your game folder should be sitting there.
Where do game files come from? Your own library: games you own on disc that you have copied over, DRM-free installers you have bought, or game folders copied from your PC. GOG installers work well: run the installer EXE inside the container and install to the D: drive. If your library lives on Steam, the Steam setup guide covers running the Windows Steam client inside a container. Winlator ships with no games and cannot fetch them for you.
How do you handle ISO files?
Many older PC games come as ISO disc images. Winlator can work with these:
- Copy the ISO file to the D: drive folder on your phone.
- Inside the container, the ISO needs to be mounted as a virtual disc drive. If your Winlator version includes ISO mounting in the container settings or drive options, enable it there and point it at the ISO.
- Alternatively, extract the ISO on your PC first (any archive tool opens ISOs) and copy the extracted game folder to D:. This sidesteps mounting entirely and works just as well.
- Once mounted or extracted, run the installer or the game's EXE from the virtual drive.
For games with multiple discs, mount or extract each disc in turn during installation, exactly as you would on a real PC.
Step 6: Open EXE files and launch programs
Inside the container, opening a program works the way it does on Windows:
- Open the file explorer and go to the D: drive.
- Find your game's folder and the game's
.exefile (the launcher or main executable; check the game's documentation if there are several). - Double-tap (or double-click, depending on your input mode) the EXE.
The first launch of anything is the moment of truth. A few things to know:
- First launches are slow. Wine may show configuration dialogs, install bundled components (like DirectX redistributables or Visual C++ runtimes that ship with the game), or just take a while. Let it finish.
- Wine Mono / Wine Gecko prompts: some programs trigger prompts to install Wine Mono or Wine Gecko. Allow these. They are normal Wine components, not malware.
- "Run as administrator": if a program complains about permissions, look for a run-as-administrator style option in the container's settings or the program's context menu rather than fighting it.
If the game reaches its menu, congratulations. The hard part is over. If it crashes or shows a black screen, do not panic: note exactly what happened (which screen, any error text) and work through the troubleshooting guide. Most of the time it is a graphics driver or DX wrapper mismatch, fixed by trying the other options in the container settings.
Step 7: Set up your controls
Before you judge whether a game "works," get the input right:
- Touchscreen mode works for point-and-click games, menus, and strategy titles out of the box.
- Virtual gamepad: Winlator includes an on-screen gamepad overlay you can enable and customize. Map buttons to keyboard keys for games that expect a keyboard.
- Mouse: for shooters and games needing precise aiming, enable mouse/pointer capture mode if your container offers it, and consider pairing a Bluetooth mouse. It transforms first-person games.
- Controllers: XInput-compatible controllers (including most Bluetooth gamepads) can be mapped for games with controller support.
Spend five minutes mapping controls for each new game. A game that feels unplayable with default touch controls often feels fine with a mapped gamepad or mouse. The controls setup guide covers gamepad mapping, pointer capture, and per-game profiles in full.
Step 8: Install a second game (repeat the pattern)
Now that the first game works, the pattern for every future game is the same:
- Create a new container named after the game (one per game, as in Step 2).
- Choose settings suited to that game (2D indie title? lighter settings. Demanding 3D game? the full driver and DXVK treatment).
- Copy the game to the D: drive, mount the ISO if needed.
- Install or run the EXE inside the container.
- Map controls, tune resolution until performance feels right.
This container-per-game discipline is what separates people who enjoy Winlator from people who fight it. Settings that make one game sing can make another crash; isolation keeps every game independent.
What mistakes do first-timers make?
- Putting games on C: instead of D:. C: is the container's system area; D: is persistent shared storage.
- One container for everything. The golden rule exists for a reason.
- Maxing resolution first. Start at 720p-ish, confirm the game runs, then raise resolution. Resolution is the cheapest performance lever you have.
- Changing five settings at once. When troubleshooting, change one thing, test, then change the next. Otherwise you will never learn what fixed it.
- Judging performance in the first 60 seconds. Shader compilation and first-time setup cause stutter that disappears on later runs. Give a game a few minutes before deciding it is too slow.
- Downloading games from "free Winlator game" sites. Apart from the piracy issue, repacked game downloads are a classic malware vector. Use game files you own.
What files can Winlator actually run?
The short list: Windows .exe installers and programs, .msi installers, disc images (ISO) once mounted or extracted, and portable game folders copied straight from a PC. It does not run Android APKs (your phone already does that), it does not run Linux binaries, and it does not run console ROMs. Those need their own emulators. If a file is a Windows program, Winlator is at least worth trying; if it is anything else, you are in the wrong app.
Frequently Asked Questions
How do I use Winlator on Android for the first time?
Install the APK from GitHub, create a container, put your game files on the D: drive, and launch the game's EXE inside the container. The steps above cover each one in order.
Where do I put games in Winlator?
On the D: drive: the shared folder between your phone's storage and the container. Never on C:, which belongs to the container's system.
How do I mount an ISO in Winlator?
Copy the ISO to the D: drive folder, then mount it through the container's drive options. Or extract the ISO on your PC first and copy the extracted files over, which avoids mounting entirely.
How do I open EXE files in Winlator?
Launch the container, open its file explorer, browse to the D: drive, and double-tap the EXE, exactly like opening a program on Windows.
Why does my game show a black screen on first launch?
Most commonly a graphics driver or DX wrapper mismatch. Try the other driver options and DX wrappers in the container settings, one at a time. The troubleshooting guide linked in Step 6 covers this in depth.
Do I need one container per game?
Strongly recommended. Per-game containers keep settings isolated so one game's configuration can never break another's.
Can I copy a game folder directly from my PC?
Yes. That is one of the most reliable methods. Copy the installed game folder to the D: drive and run its EXE inside the container. DRM-free games (like GOG releases) work best this way.
Can I run an installer EXE instead of copying game files?
Yes. Copy the installer to the D: drive, run it inside the container, and install the game to the D: drive. This works well for GOG offline installers and old disc-based games.
Can I back up my Winlator containers?
Partially. A container is a folder inside Winlator's app data, so the files can be copied, but Android restricts access to other apps' private folders, so you will need a file manager with full storage access. The backup that matters most is your saves: copy save folders to the D: drive (which lands in your Downloads, outside the container) and from there to cloud storage. If you ever reinstall Winlator, containers start from zero.
How do I completely remove a game?
Delete its container. That removes the game, its settings, and its virtual Windows environment in one move. If you want to keep the container, uninstall the game from inside it (use the game's uninstaller or just delete its folder). Either way, there is no recycle bin: it is just gone.
Why does Winlator ask to install Wine Mono or Gecko?
These are normal Wine components that some Windows programs need: .NET-style runtime pieces and a browser engine that Wine implements itself. The prompt is expected, not a sign of malware. Allow the install and let it finish; blocking it is a common cause of programs that silently fail to start.
Can I use Winlator without an internet connection?
Yes. Once the app is installed and your game files are on the device, everything runs locally. No connection needed to play. You only need internet for the one-time APK download, for getting game files in the first place, and for account-based steps like the first Steam login if you run Steam inside a container.
Where is the D: drive folder on my phone?
It is the Winlator shared folder inside the app's storage, usually reachable through your file manager. If you cannot find it, check the container's drive settings: they show exactly which phone folder maps to D:. Whatever you copy into that folder appears on the container's D: drive.