Skip to content

Guide and scripts for enabling per-game Auto HDR toggling on Steam Deck OLED via Decky Loader & Bash Shortcuts plugin.

Notifications You must be signed in to change notification settings

JediRhymeTrix/deck-toggle-autohdr

Repository files navigation

Steam Deck Auto HDR Toggle

This guide provides instructions for setting up an easy way to toggle Auto HDR on a per-game level for the Steam Deck OLED using Decky Loader and the Bash Shortcuts plugin. The included script will take the appid of the current game from Bash Shortcuts and automatically copy/link the required files into the game directory.

Prerequisites

  1. Decky Loader - Install from Decky Loader.
  2. Bash Shortcuts Plugin - Install from Bash Shortcuts Plugin for Decky.

Instructions

Temporary Fix for Bash Shortcuts Plugin

Bash Shortcuts is currently unavailable on the Decky plugin store due to it being incompatible with the latest Steam Client.

  • While the SDH-Stewardship team works on releasing a patched build to the store, you can find a built prerelease of the plugin here.

  • Extract it to the /home/deck/homebrew/plugins/ directory on your Deck.

  • Restart the Deck to apply changes.

Setting Up Auto HDR

  1. Clone or download (or grab a VERIFIED build from releases) and unzip this repo to the Downloads directory on your Deck.

  2. Boot into game mode and navigate to the Bash Shortcuts plugin.

  3. Create two new shortcuts for 32-bit and 64-bit games respectively:

    • Navigate to plugin config > add shortcut.

    • Name the shortcuts appropriately (e.g., Toggle AutoHDR 32-bit, Toggle AutoHDR 64-bit).

    • Set the command for 32-bit games to:

      sh +x /home/deck/Downloads/deck-toggle-autohdr/autohdr_shortcut_32bit.sh
    • Set the command for 64-bit games to:

      sh +x /home/deck/Downloads/deck-toggle-autohdr/autohdr_shortcut_64bit.sh
    • Configure the toggles as shown in the screenshot below:

      Configuration Screenshot

    • Save the shortcuts.

  4. To enable Auto HDR for a game:

    • Determine if the game is 32-bit or 64-bit.
    • Go to the game view page for any installed Steam game or launch a game.
    • Open the Bash Shortcuts plugin in the Quick Access Menu (QAM) and run the appropriate shortcut based on the game's architecture.
    • Once the shortcut has run, it should have copied the required files to the game's directory.
    • Either run the game if you were on the game view page, or exit and re-launch if the game was already running. Auto HDR should now be enabled.
  5. To disable Auto HDR, repeat Step 4 with the appropriate shortcut. The same shortcut will remove Auto HDR from the game.

Updating ReShade

To update ReShade or the Auto HDR plugin, go to the releases page and download the latest version or select a specific release with the version of ReShade you want. Note that releases marked with UNTESTED were auto-generated with the newest version of ReShade and aren't guaranteed to be compatible with this Auto-HDR plugin.

To update, add the new files to the correct directories and trigger the shortcut twice to update the files in the game directories.

Limitations

The limitations are the same as those for the Reshade Auto HDR plugin. For more details, refer to this Twitter post.

Credits

  • Reshade and Auto-HDR Plugin Developers - For building the functionality.
  • @JavaidUsama - For sharing the the AutoHDR files on Twitter.
  • u/ManSore - For providing the 32-bit version of the AutoHDR files.
  • Tormak - The original author the Bash Shortcuts plugin.
  • SDH-Stewardship: The team behind the Decky Plugin Stewardship Program and its contributors for supporting the Bash Shortcuts plugin.
  • Decky Loader Team - For making plugin integration possible on the Steam Deck.

Note

This guide and the scripts are currently in a very rough proof of concept stage. Plans for refinement are in place, especially once the issue with the Bash Shortcuts plugin is resolved.