Skip to main content

DOS Player

DOS, Windows 3.1, and Windows 95 games use a different in-game UI from the rest of the library. The engine is DOSBox Pure running inside a WebView, with on-screen mouse, keyboard, and game-control overlays.

TODO: DOS Player with on-screen overlays

Screen layout​

The DOS Player runs full-screen and supports both portrait and landscape, though many DOS titles look best in landscape.

RegionWhat's there
Main areaGame canvas
Bottom (configurable)Virtual keyboard and/or keypad overlay
Bottom-right cornerRight-click button (for games that need RMB)

Mouse input​

Tap the canvas to send a left-click at that location. The right-click button sends RMB. Movement is absolute — the cursor moves to wherever you tap.

Keyboard input​

For games that need keyboard input (typing your name, hotkeys, etc.), the virtual keyboard overlay is available. See Virtual Keyboard to customize colors, height, and font.

Keypad input​

For games with simple key-based controls (arrow keys + a few action keys), the Virtual Keypad is faster than the full keyboard.

Exit behavior (two-tap back)​

The Android back button is intercepted:

  • First press → shows a message like "Press back again to exit"
  • Second press within ~2 seconds → quits the game

This prevents accidentally exiting mid-play. You can also map the back button to save state or right-click in DOS Specific Settings.

Saving in DOS games​

DOS doesn't have native save-state. Two options:

  1. In-game save — use the game's own save menu (most DOS games have one)
  2. Save state — DOSBox Pure supports state saving; trigger it from the menu or back-button mapping. The state is written to the app's save folder for that game.

See Save & Load Workflow.

Windows 3.1 / 95​

These run on the same DOSBox Pure core (the DOSP95 variant) with extended memory and CPU cycles. Performance depends heavily on the game and your device — see Performance troubleshooting.

tip

For Windows 95 games specifically, give the engine a few seconds at startup — booting Windows 95 inside a phone takes ~10–15 seconds depending on the device.

Aspect ratio and screen offset​

Some DOS games have non-standard resolutions. You can adjust:

  • Aspect ratio — 4:3, 16:9, or original
  • Screen offset — nudge the game canvas up/down/left/right
  • Portrait W/H, Landscape W — per-orientation canvas dimensions

These are saved per-game in the game's settings.