Skip to main content
Setup & Configuration Tutorial

How to Install Winlator APK & Configure Containers on Android

This comprehensive tutorial covers the complete setup process for Winlator on modern Android devices: from allowing third-party package installation and extracting user-space container files to configuring optimal Turnip Vulkan drivers and virtual gamepad profiles.

Estimated Setup Time: ~10 minutes•Target Version: Winlator 11.2•Root Access Not Required

1. Hardware & Software Prerequisites

Before beginning the installation, ensure your Android device meets the necessary technical criteria:

Operating System

Android 8.0 (Oreo) or newer. Android 12, 13, 14, or 15 strongly recommended for modern Vulkan 1.3 drivers.

Available Storage

At least 5 GB of free internal storage for the Ubuntu RootFS, plus sufficient space for your game installations.

System Memory

Minimum 4 GB of RAM. 8 GB or 12 GB RAM recommended to avoid memory pressure when loading 3D textures.

2. Step 1: Downloading Official APK

Obtain the official Winlator APK directly from the developer's release channel. Do not download modified or repacked builds from unknown third-party file locker sites, as these may contain unwanted background processes.

Get the verified APK from our official download hub:Visit Download Hub →

3. Step 2: Enabling Unknown Sources

Android requires explicit authorization to install applications outside the Google Play Store. When you open the downloaded Winlator_11.2.apk file:

  1. A system prompt will appear stating: "For your security, your phone is not allowed to install unknown apps from this source."
  2. Tap Settings on the pop-up modal.
  3. Toggle the switch to "Allow from this source" for your web browser or file manager.
  4. Tap the back button, then select Install.

4. Step 3: First-Launch Container Setup

Once installed, tap the Winlator icon in your app drawer:

  • Initial Asset Extraction: The app will automatically unpack the Ubuntu RootFS, PRoot binary, and Wine system files into private app storage. Do not minimize or close the app during this process. It takes roughly 30–60 seconds depending on your device's flash storage speed (e.g., UFS 2.2 vs UFS 4.0).
  • Grant Storage Permissions: When prompted, grant Winlator permission to access storage so it can mount your Download directory as Drive D:.

5. Step 4: Creating & Configuring Your First Container

In the main Winlator dashboard, tap the "+" icon in the top right corner to create a container. Here are the optimal configuration options:

Screen Size / Resolution:

Set to 1280x720 (16:9) or 800x600. Rendering at native 1440p or 4K on a mobile screen causes severe GPU throttling.

Graphics Driver:

Select Turnip (Adreno) if you have a Qualcomm Snapdragon device. For MediaTek, Google Tensor, or Exynos devices, choose VirGL.

DX Wrapper:

Choose DXVK (v2.2 or v2.4) for 3D DirectX 9/11 games. For 2D or classic titles prior to 2004, select CNC DDraw or WineD3D.

Box86 / Box64 Preset:

Set Box64 to Fast or Performance. If a game crashes during launch, switch this preset to Compatibility.

Once configured, tap the checkmark (✓) at the bottom right to save the container.

6. Step 5: Input Controls & Gamepads

Winlator features extensive input customization:

  • Virtual Touch Controls: In the sidebar menu, open Input Controls. You can choose from pre-made profiles (such as RTS Mouse, Gamepad 12-Button, or FPS WASD) or construct a bespoke on-screen layout with resizable translucent buttons.
  • Physical Controllers: Pair your Bluetooth controller (Xbox Series/One, PS4 DualShock, PS5 DualSense) with your Android device. Winlator natively binds these via XInput or DirectInput.

7. Step 6: Transferring & Running PC Games

Running games in Winlator does not require complex command-line scripts:

  1. Copy your DRM-free game directory or installer (from sources such as GOG.com) to your phone's internal storage path: /storage/emulated/0/Download.
  2. Launch your Winlator container by tapping the three dots menu on your container card and selecting Run.
  3. A Windows desktop environment will load. Double-click My Computer.
  4. Open Drive D: (which points to your Android Download folder).
  5. Double-click the setup executable or game .exe file to install or launch the game.

8. Troubleshooting Common Errors

"App Not Installed" Error during APK install

Ensure you have sufficient free storage space and that you uninstalled any conflicting unofficial or modified fork with mismatched cryptographic signing certificates.

Black Screen or Crash on Game Start

If your device uses a MediaTek or Exynos chipset, you cannot use Turnip drivers. Switch Graphics Driver to VirGL or LLVMpipe. If running an older DirectX 8/9 game, switch DX Wrapper from DXVK to WineD3D or CNC DDraw.

Sound Crackling or High Audio Latency

Open your container settings, locate Audio Driver, and select PulseAudio. You can adjust the audio buffer size to 60ms or 80ms to prevent stutter during high CPU load.

Frequently Asked Questions About Winlator Setup

Does Winlator require root access or unlocking the bootloader?

No. Winlator does not require root permissions or an unlocked bootloader. It operates entirely within Android userspace permissions through PRoot emulation and standard application storage access. You can install and run it safely on any stock, unrooted Android phone or tablet running Android 8.0 or newer.

What hardware specifications are required for playable frame rates?

For 3D titles (DirectX 9, 10, or 11), a Qualcomm Snapdragon processor with an Adreno 6xx or 7xx GPU (such as Snapdragon 855, 870, 888, 8 Gen 1, 8 Gen 2, or 8 Gen 3) is strongly recommended because of the open-source Turnip Vulkan driver. Devices with MediaTek Dimensity, Google Tensor, or Samsung Exynos (Mali / Xclipse GPUs) must rely on VirGL or LLVMpipe software rasterizers, which offer significantly lower 3D performance and are best suited for 2D or lightweight vintage games. A minimum of 4 GB of RAM is required, while 8 GB or 12 GB is recommended for modern titles.

How do I add and run my PC games in Winlator?

By default, Winlator maps your Android device’s standard "Download" folder (/storage/emulated/0/Download) to Drive D: inside the container. Place your game installation folder, DRM-free installer (such as from GOG.com), or portable game directory into your Android Download folder. When you launch your Winlator container, open "My Computer", navigate to Drive D:, and double-click the installer or game executable (.exe) to start.

What are the best container settings for Snapdragon devices?

For most 3D Windows games on Snapdragon devices: Set Graphics Driver to "Turnip (Adreno)", DX Wrapper to "DXVK" (v2.2 or v2.4 depending on title), Audio Driver to "PulseAudio", Screen Resolution to "1280x720" (or 960x540 for demanding titles), Box86/Box64 preset to "Fast" or "Performance", and ensure Turnip GPU cache is enabled. This delivers the best balance of stability and frame rate.

Why does Winlator crash or show a black screen when launching a game?

A black screen or crash is typically caused by: 1) Using Turnip on a non-Adreno (Mali/PowerVR) device; 2) DirectX missing components (use Winecfg or install native DirectX libraries inside the container); 3) Screen resolution mismatch; 4) Out of memory (RAM shortage). Try switching the DX Wrapper to WineD3D or CNC DDraw for older games, lowering the container resolution to 720p, or toggling the Box64 compatibility preset.

How do I update Winlator without losing my installed containers and game saves?

When a new official Winlator update is released, you can install the new APK directly over your existing installation without uninstalling it first. Android will preserve your container configurations, Wine prefix files, and game saves located in internal storage. However, as a precaution, it is always recommended to back up your save files from Drive C: (Drive C/users/xuser/Saved Games or AppData) before applying major version upgrades.