Setup
Install the watcher
Five minutes, once per device. After that it runs by itself and you can close this page for good.
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 keysDesktop — 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.
Windows
gamestash-windows.exe
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.
- Launch it — a Gamestash icon appears in the tray or menu bar.
- Click the icon, paste your API key, hit Save.
- Press
F11in 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.
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.
- Quick Access menu → the Decky icon → Store.
- Search for Gamestash and install it.
- Open it from the Decky menu, paste your API key, Save settings.
- 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.
Check that it worked
- Take a screenshot in any Steam game — F12 on PC, R1 + L1 + R2 + L2 on Deck.
- Give it a few seconds.
- 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.