Skip to content

mubaraknumann/unifideck

Repository files navigation

Unifideck - Unified Game Library for Steam Deck

A Decky Loader plugin that brings together Steam, Epic Games Store, GOG, Amazon Games, Ubisoft Connect, and Xbox Cloud Gaming in a single library experience on your Steam Deck.

License Platform Downloads Sponsor Ko-fi

Table of Contents

Features

  • Unified library tabs - Browse Steam, Epic, GOG, Amazon, Ubisoft, Xbox Cloud Gaming, Installed, Great on Deck, and Non-Steam from one place.
  • Steam-native install, update, and launch actions - Manage supported games directly from the game details view, with progress and status feedback.
  • Shortcut-based sign-in in Gaming Mode - Authenticate Epic, GOG, Amazon, Ubisoft, and Microsoft without leaving the Steam UI.
  • Flexible install locations - Use internal storage, SD card, or a validated custom install directory.
  • Launch options and Proton control - Preserve custom launch options across syncs, installs, and Proton toggles. Supports wrappers, MangoHud, LSFG, PROTON=, and PROTONPATH=.
  • Artwork and richer metadata - Pull cover art, icons, banners, store links, Metacritic data, and Great on Deck style compatibility info where available.
  • Cloud saves - Epic and GOG cloud saves are supported, including conflict prompts when both local and cloud saves exist.
  • Store-specific extras - GOG language selection, Epic/GOG DLC auto-downloads, Epic offline mode, GOG Galaxy / Comet support for compatible titles, and xCloud "Play on Cloud" support through Edge.

Screenshots

Unified Game Library

Screenshot_20260109_123258

Game Details

20260104022821_1

Prerequisites

  • Decky Loader must be installed on your Steam Deck.
  • Microsoft Edge is required for store sign-in and Xbox Cloud Gaming. If it is missing, Unifideck will prompt you to install it.
  • All other store CLIs and helper tooling are bundled with the plugin.

Decky Loader Installation Guide

Installation

  1. Download the latest plugin ZIP from the Releases page.
  2. Open Quick Access Menu (three dots button).
  3. Navigate to Decky -> Settings (gear icon).
  4. Enable Developer Mode if it is not already enabled.
  5. Click Install Plugin from ZIP.
  6. Select the downloaded ZIP file.

If an update gets stuck on installing plugin, uninstall the current Unifideck plugin and install the latest ZIP again.

https://www.youtube.com/watch?v=lP-90uYd72w

Getting Started

  1. Open the Quick Access Menu and launch Unifideck.
  2. Connect the stores you want to use.
  3. Set your default install location if you want internal storage, SD card, or a custom path.
  4. Run Sync Libraries or Force Sync.
  5. Restart Steam when prompted so new shortcuts and artwork are applied.
  6. For Ubisoft titles purchased through Epic, complete the one-time account link at epicgames.com/id/link/ubisoft.

Installed games are playable immediately after install. The Steam restart is still needed after sync or cleanup so the library refreshes fully.

Documentation

  • FAQ - Common issues, workarounds, and version-specific fixes collected from releases, code comments, and GitHub issues.
  • Launch Options Guide - Custom parameters, wrappers, LSFG, and per-game launch tweaks.
  • Proton Compatibility Notes - PROTON=, PROTONPATH=, and compatibility troubleshooting.

Known Limitations

  • Unifideck replaces Steam's default All Games, Installed, and Great on Deck tabs, so Steam's standard sort and filter behavior is not preserved there.
  • With TabMaster installed, Unifideck skips custom tab injection and relies on [Unifideck] collections instead.
  • Steam still needs a restart after sync or cleanup so new shortcuts and artwork fully apply.
  • Xbox Cloud Gaming support is streaming-only and depends on Microsoft Edge.
  • Cloud saves currently cover Epic and GOG only, and game-level support varies.
  • Some titles still need manual Proton experimentation or store-specific workarounds.
  • Not every game has SteamGridDB artwork or complete metadata.
  • For Ubisoft, choose your Proton version before installing. Changing Proton after install can invalidate the prefix and force a reinstall.

Troubleshooting

For a longer list of release-specific problems and fixes, see the FAQ.

Install Stuck on installing plugin

Uninstall the current plugin and install the latest ZIP again. This was the recommended workaround for the 0.6.0 -> 0.6.1 transition.

Games or Artwork Do Not Appear After Sync

Run Force Sync if needed, then restart Steam when prompted so shortcuts and artwork are reloaded.

Epic Login Shows a Blank Page or Pretty Print

Sign into Epic in a regular browser first, accept any pending legal updates, then retry in Unifideck.

A Game Will Not Install or Launch

Check available storage, make sure the store account is still connected, and inspect ~/.local/share/unifideck/launcher.log.

Microsoft / xCloud Will Not Open

Install Microsoft Edge when prompted. After the first successful Microsoft sign-in, you may still need to click Play via Cloud once inside the xCloud home screen to finish OAuth.

Ubisoft Titles from Epic Hang on Login or Ask for a Key

Make sure your Epic and Ubisoft accounts are linked at epicgames.com/id/link/ubisoft. If problems continue, clear ~/.local/share/unifideck/chromium-auth, ~/.local/share/unifideck/ubisoft_installer_cache, and the Ubisoft prefixes under ~/.local/share/unifideck/prefixes/, then try again.

Logs

  • Decky/backend log - /home/deck/homebrew/logs/Unifideck
  • Launcher/runtime log - ~/.local/share/unifideck/launcher.log
  • Edge/browser log - ~/.local/share/unifideck/chromium-auth.log

Languages

Unifideck currently ships with English (US), French, Brazilian Portuguese, Russian, Japanese, German, Spanish, Italian, Simplified Chinese, Korean, Dutch, Polish, Turkish, and Ukrainian.

To add a new language, create a JSON file in src/i18n/locales/ using en-US.json as the template and wire it into the language selector.

Building

To build the plugin from source:

  1. Install dependencies: pnpm install
  2. Build the frontend bundle: pnpm run build
  3. Build the plugin package:
    • standard Decky / fork workflow: ./.vscode/build.sh or the VS Code build-plugin task

For frontend watch mode, use pnpm run watch.

Tech Stack

  • Frontend - React, TypeScript, Rollup, @decky/api, @decky/ui, i18next
  • Backend - Python, Decky Loader RPC, CDP-based auth and browser helpers
  • Store tooling - legendary, gogdl, nile, comet, winetricks, umu-launcher
  • Services and data - SteamGridDB, Epic/GOG/Amazon/Microsoft APIs, Microsoft Edge, Metacritic, compatibility metadata

Credits

This project builds on a lot of open source work and community help.

Support

If you want to support development or keep up with releases:

License

GNU General Public License v3.0 or later - see LICENSE for details.

Author

Numan Mubarak ([email protected])

Disclaimer

This is an unofficial third-party tool. It is not affiliated with Valve, Epic Games, CD Projekt / GOG, Amazon, Ubisoft, or Microsoft.

About

A Decky Loader plugin that brings together games from Steam, Epic Games Store, GOG, Amazon, Ubisoft and XCloud into a single, unified library experience on your Steam Deck.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors