# Technical Documentation: brunodev85/winlator

> ℹ️ **Provenance:** In-Tree Documentation (10 Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/brunodev85/winlator) · Recency: Active (< 180 days)

## File: README.md

# Winlator

Winlator is an Android application that lets you to run Windows (x86_64) applications with Wine and Box86/Box64.

# Installation

1. Download and install the APK (Winlator_11.2.apk) from [GitHub Releases](https://github.com/brunodev85/winlator/releases)
2. Launch the app and wait for the installation process to finish

----

[](https://www.youtube.com/watch?v=ETYDgKz4jBQ)
[](https://www.youtube.com/watch?v=9E4wnKf2OsI)
[](https://www.youtube.com/watch?v=czEn4uT3Ja8)
[](https://www.youtube.com/watch?v=eD36nxfT_Z0)
[](https://www.youtube.com/watch?v=GHBKmzGmhoo)

----

# Useful Tips

- If you are experiencing instability issues, try changing the Box64 preset in Container Settings -> Advanced Tab.
- For applications that use .NET Framework, try installing `Wine Mono` found in Start Menu -> System Tools -> Installers.
- If some older games don't open, try adding the environment variable `MESA_EXTENSION_MAX_YEAR=2003` in Container Settings -> Environment Variables.
- Try running the games using the shortcut on the Winlator home screen, there you can define individual settings for each game.
- To display low resolution games correctly, try to enabling the `Force Fullscreen` option in the shortcut settings.
- To improve stability in games that uses Unity Engine, try changing the Box64 preset to `Stability` or in the shortcut settings add the exec argument `-force-gfx-direct`.
- If you are experiencing audio crackling, try increasing the average latency in ALSA/PulseAudio configuration. Old games like Unreal Gold resolve audio issues by increasing this value to 90ms.

# Credits and Third-party apps

- GLIBC Patches by [Termux Pacman](https://github.com/termux-pacman/glibc-packages)
- Wine ([winehq.org](https://www.winehq.org/))
- Box86/Box64 by [ptitseb](https://github.com/ptitSeb)
- Mesa (Turnip/Zink/VirGL) ([mesa3d.org](https://www.mesa3d.org))
- DXVK ([github.com/doitsujin/dxvk](https://github.com/doitsujin/dxvk))
- VKD3D ([gitlab.winehq.org/wine/vkd3d](https://gitlab.winehq.org/wine/vkd3d))
- CNC DDraw ([github.com/FunkyFr3sh/cnc-ddraw](https://github.com/FunkyFr3sh/cnc-ddraw))

Special thanks to all the developers involved in these projects.
Thank you to all the people who believe in this project.

---

## File: android_alsa/CMakeLists.txt

cmake_minimum_required(VERSION 2.8)

project(AndroidAlsa C)
message("Building ${PROJECT_NAME}")

set(CMAKE_VERBOSE_MAKEFILE on)
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -O2 -fPIC -DPIC")

MESSAGE(STATUS "Compiler options: ${CMAKE_C_FLAGS}")

include_directories(include)

add_library(asound_module_pcm_android_aserver SHARED module_pcm_android_aserver.c)
target_link_libraries(asound_module_pcm_android_aserver "/data/data/com.winlator/files/rootfs/lib/libasound.so.2")

---

## File: input_controls/index.txt

Alien Versus Predator.icp
Alpha Protocol.icp
Bioshock.icp
Call of Juarez Gunslinger.icp
Cyber Shadow.icp
Dark Souls 2.icp
Deus Ex Human Revolution.icp
Divinity 2 DC.icp
Drakensang.icp
Driver Parallel Lines.icp
Fallout 3.icp
Far Cry 4.icp
Final Fantasy 8.icp
Final Fantasy Type-0.icp
FlatOut 2.icp
Front Mission Evolved.icp
Gravity Circuit.icp
GTA 5.icp
Hitman 2.icp
IGI 2.icp
Infernal.icp
La Mulana.icp
Marvel Ultimate Alliance.icp
Mass Effect 2.icp
Metro 2033.icp
Oblivion.icp
Prey.icp
Psychonauts.icp
Quake 4.icp
RAGE.icp
Rayman 3.icp
Risen 2.icp
Second Sight.icp
Shovel Knight.icp
Singularity.icp
Skyrim.icp
Sonic Generations.icp
Sonic Mania.icp
Spiderman Shattered Dimensions.icp
Stalker CS.icp
Star Wars Jedi Knight 2.icp
SteamWorld Dig 2.icp
Sunset Overdrive.icp
The Alliance Alive.icp
The Forest.icp
The Saboteur.icp
Turok 2.icp
Turok Evolution.icp
Ultima Underworld.icp
Unepic.icp
Wolfenstein.icp
Xanadu Next.icp
Ys Origin.icp

---

## File: installable_components/box64/index.txt

box64-0.3.3.tzst
box64-0.3.5.tzst
box64-0.3.7.tzst

---

## File: installable_components/dxvk/index.txt

dxvk-0.96.tzst
dxvk-1.4.2.tzst
dxvk-1.7.2.tzst
dxvk-2.2.tzst
dxvk-2.3.1.tzst
dxvk-2.5.2.tzst
dxvk-2.6.1.tzst

---

## File: installable_components/turnip/index.txt

turnip-24.1.0.tzst
turnip-25.0.0.tzst
turnip-26.0.3.tzst

---

## File: installable_components/vkd3d/index.txt

vkd3d-2.12.tzst
vkd3d-2.14.1.tzst
vkd3d-3.0b.tzst

---

## File: installable_components/wined3d/index.txt

wined3d-4.21.tzst
wined3d-7.8.tzst
wined3d-10.0.tzst

---

## File: .github/FUNDING.yml

# These are supported funding model platforms

github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
patreon: # Replace with a single Patreon username
open_collective: # Replace with a single Open Collective username
ko_fi: # Replace with a single Ko-fi username
tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
liberapay: # Replace with a single Liberapay username
issuehunt: # Replace with a single IssueHunt username
lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
polar: # Replace with a single Polar username
buy_me_a_coffee: brunosx
thanks_dev: # Replace with a single thanks.dev username
custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

---

## File: .github/ISSUE_TEMPLATE/bug_report.md

---
name: Bug report
about: Create a report to help us improve
title: ''
labels: ''
assignees: ''

---

Please describe the issue in as much detail as possible.

### General Information
- Winlator Version:
- Smartphone Model:

### Container Settings
- Graphics Driver:
- DX Wrapper:
- Audio Driver:
- Box64 Version:

--- METRICS ---
- Files Extracted: 10
- Estimated Token Budget: ~1706 tokens
- Recency Window: Active (< 180 days)
- Canonical Reference: https://codewiki.google/github.com/brunodev85/winlator
