Skip to content

Resource Overrides

Connor McLaughlin edited this page Jan 6, 2026 · 2 revisions

DuckStation allows you to override certain resources by placing files in the resources subdirectory of the user directory. This includes images and sound effects (e.g. menu navigation/achievement unlock).

Sound effects must be in WAV format, in 8/16/24/32 PCM or 32-bit float. Note that the sound effect output is always 44.1KHz stereo, if your sound file is using a different sample rate or channel configuration DuckStation will resample/mix it.

The directory structure for the overrides should follow the same structure as the resources directory in the program directory. For example, to override the achievement unlock sound:

  1. Select Open Data Directory from the Tools menu.
  2. Open the resources directory, then the sounds directory. You will likely have to create the sounds directory as the application does not create resource override subdirectories automatically.
  3. Name your replacement file unlock.wav.
  4. Relaunch the game (and Big Picture Mode) if it is running, as sound effects are cached.

Do not place resource override files in the program directory, as these will be overwritten when updating DuckStation.

Please note that not all resources are overridable for reliability reasons. This feature also will not work if DuckStation is configured in portable mode, as the user and program resources directory overlaps.

Clone this wiki locally