Issues with Junk Store itself? This section covers general plugin problems — from install issues to launch errors and everything in between.

If you're seeing errors and dependencies aren't installing, try running the following commands in Konsole:

export DECKY_PLUGIN_RUNTIME_DIR=~/homebrew/data/Junk Store
export PYTHONPATH=~/homebrew/plugins/Junk Store/scripts:$PYTHONPATH:~/homebrew/plugins/Junk Store/scripts/shared
export DECKY_PLUGIN_DIR=~/homebrew/plugins/Junk Store
export DECKY_PLUGIN_LOG_DIR=~/homebrew/logs/Junk Store
cd ~/homebrew/plugins/Junk Store
./scripts/install_deps.sh
When I launch a game, Steam tries to download something but it gets stuck at 0%

This is a known Steam issue, often related to Proton 9. We recommend switching to a GE-Proton version instead, as these are better suited for running non-Steam games. Open the game’s properties in Steam and select a different Proton version from the Compatibility tab to resolve the issue.

Games aren’t showing up in the Non-Steam tab

Check your settings and make sure the shortcut isn’t hidden. After changing settings, reboot your Steam Deck for changes to take effect.

Shortcuts aren’t appearing

Try rebooting your device first. If they still don’t appear, ask for help in the plugin-support forum on Discord.

My game works in Heroic or Lutris, but not in Junk Store

Games that run in Heroic or Lutris usually work in Junk Store too — it’s just a matter of finding the right tweaks:

  • Try switching to a different GE-Proton version.
  • Install any required or missing dependencies (you may sometimes get a prompt to install a Microsoft C++ runtime, or something else).
  • Some Epic games require the EOS overlay to be enabled before they will work. Make sure you have installed this globally (Epic tab) and enabled it for the game (done from the game page in Junk Store).

Please refer to our Tutorials section to learn how to change or check your Proton version or install Microsoft C++ runtimes if you are unsure how to do this.

If that doesn’t work, ask for help in our Discord server. Please be patient—our team is small! While we have a decent game library, we don’t have every game, so we may only be able to offer advice rather than fixes.

I don’t have Proton GE or don’t know how to install it.

To get Proton GE or other custom versions of Proton, you can use one of the following tools:

  • ProtonUp-QT — A simple app that lets you download and manage Proton versions. You can find it in the Discover Store (in Desktop Mode).
  • Wine Cellar — A Decky plugin that works similarly to ProtonUp-QT. If you already have Decky installed for other plugins, you can install Wine Cellar directly from the Decky Plugin Store.

Once installed, use either tool to download the latest GE-Proton release. After that, you’ll be able to select it as a compatibility option in Junk Store.

Please refer to our Plugin Tutorials page. section to see how to change/check your Proton version if you are unsure how to do this.

I want to change the FPS for a game

  • Open Junk Store through the Decky plugin and select your game.
  • Click the gear icon and choose Proton Config.
  • Scroll to the bottom and adjust the framerate setting.

    • Do I need to keep Junk Store open while downloading from Epic?

    Yes. Junk Store doesn't have a background download queue. If you close or leave the plugin, your download may stop or behave unpredictably.

    No games are showing.

    Make sure you try the following tips:

    • Refresh your games list from the main Epic tab:
      Sliders menu > Refresh Games List

    • Reboot the Steam Deck

    • Log out and log back into your Epic account

    What are the backend scripts, and do I need them?

    These are optional example scripts mainly for DOSBox games. They are not officially supported and may stop working if Junk Store is updated. Use them only if you know how they work.

    How do I uninstall the backend scripts for DOS and Win 3.1?

    You can delete them manually from:
    ~/homebrew/data/Junk Store/scripts/Extensions

    Game gets stuck at the Steam pre-launch screen

    This might be caused by another plugin (like decky-cloud-save) locking Junk Store’s files. Make sure nothing is interfering with this folder:
    /home/deck/homebrew/data/Junk Store
    Junk Store relies on that data directory to function correctly.

    Having issues bringing up the keyboard in Game Mode?

    If the Steam + X shortcut isn’t bringing up the keyboard try the following:

    • Try to bring up the keyboard ⌨️ from the Quick Access Menu (â‹Ż).
    • Tap directly on a text field (like a password box) to prompt the keyboard.
    • Try toggling to Desktop Mode and back to Game Mode to reset input services.
    • Restart Steam or the device if the issue persists.

    This is a known Steam bug that has been around for a while. These steps usually help work around it until Valve fixes it in a future update.

    Need Help or More Info?

    Here are your best starting points: