Skip to content

🔥🔥🔥 You are viewing a development version of the website. Things will blow up. 🔥🔥🔥

Regular users, please follow the exit signs.

# Capture

DOSBox Staging can capture screenshots, record audio, and record video directly from the emulator. By default, all captures are saved to the `capture` directory in the current working directory. You can change this with the capture_dir setting.

## Screenshots

Screenshots can be saved in multiple formats: upscaled (sharp pixels, aspect-corrected), rendered (post-shader, exactly what you see on screen), or raw (the framebuffer’s contents with 1:1 pixel aspect ratio).

Use `Ctrl`+`F5` / `Cmd`+`F5` to take a screenshot using the default format(s) configured by the default_image_capture_formats setting.

## Video capture

Press `Ctrl`+`F7` / `Cmd`+`F7` to start and stop video recording. The video is captured as a lossless AVI file.

## Audio capture

Press `Ctrl`+`F6` / `Cmd`+`F6` to start and stop audio recording. Raw MIDI and OPL output can also be captured for those who want to tinker with game music outside the emulator.

## Configuration settings

Capture settings are to be configured in the `[capture]` section.

##### capture_dir

  Directory where the various captures are saved, such as audio, video, MIDI, and screenshot captures (`capture` in the current working directory by default).

##### default_image_capture_formats

  Set the capture format of the default screenshot action.

  If multiple formats are specified separated by spaces, the default screenshot action will save multiple images in the specified formats. Keybindings for taking single screenshots in specific formats are also available.

  Possible values:

  - `upscaled` default – The image is bilinear-sharp upscaled and the correct aspect ratio is maintained, depending on the `aspect` setting. The vertical scaling factor is always an integer.
  - `rendered` – The post-rendered, post-shader image shown on the screen is captured. Filenames end with `-rendered`.
  - `raw` – The contents of the raw framebuffer is captured (always results in square pixels). Filenames end with `-raw`.