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.