Gamestash

Setup

Install the watcher

Five minutes, once per device. After that it runs by itself and you can close this page for good.

Step 1

Get an API key

Both the desktop app and the Decky plugin sign in with a key rather than your password. Open API keys, create one named after the device, and keep it on the clipboard — it is shown only once.

Open API keys
Step 2a

Desktop — Windows, macOS, Linux

A tray app that takes the screenshot itself: press the shortcut in any game and the shot goes straight up. Nothing is saved on the machine on the way.

macOS

gamestash-macos.zip

Apple Silicon · unzip into Applications

Linux

build from source

needs webkit2gtk, so no prebuilt binary

On Linux: task client:install from a checkout — the tray needs webkit2gtk from your own distribution, which is why there is nothing to download. On macOS, unzip and drag Gamestash.app into Applications — the first launch needs a right click → Open, since the build is signed by nobody in particular.

  1. Launch it — a Gamestash icon appears in the tray or menu bar.
  2. Click the icon, paste your API key, hit Save.
  3. Press F11 in a game. The shot is in your library moments later, filed under whatever the game calls its window.

F11 sits beside Steam's own F12, so both can live on one machine. To use something else, click the shortcut field in the panel and press the keys you want: a function key works on its own, anything else needs a modifier.

macOS asks for two permissions the first time — Screen Recording to take the picture and Input Monitoring to hear the shortcut. Grant both in System Settings → Privacy & Security, then start the app again. Under Wayland on Linux the desktop will not say which window is in front, so those captures arrive without a game name.

Step 2b

Steam Deck — Decky plugin

Needs Decky Loader. If you have not set that up, grab it from decky.xyz in Desktop Mode, then reboot into Game Mode.

  1. Quick Access menu → the Decky icon → Store.
  2. Search for Gamestash and install it.
  3. Open it from the Decky menu, paste your API key, Save settings.
  4. Turn Auto-sync screenshots on.

Prefer to sideload? Download gamestash-decky.zip, switch to Desktop Mode, and unzip it into ~/homebrew/plugins/ so the files land in ~/homebrew/plugins/gamestash/. Restart Decky Loader afterwards.

Step 3

Check that it worked

  1. Take a screenshot in any Steam game — F12 on PC, R1 + L1 + R2 + L2 on Deck.
  2. Give it a few seconds.
  3. Open your gallery — it should be there.

Nothing after a minute? Check the app is still running and that the key has not been revoked on the API keys page.