Deck Shelves 3.0.0 is here! 🎉
This is the biggest update the plugin has received so far. The goal wasn't just to add features, but to make Deck Shelves feel like a more complete and polished part of the Steam Deck experience.
⚙️** A real Settings page
The old compact menu is gone. Settings now open in a full-screen interface (from the gear icon in Quick Access) with dedicated tabs for Shelves, Profiles, Shortcuts, Backup, and more.
📊 Statistics & Smart Suggestions
See how you actually use your shelves with activity charts, most-used shelves, and a breakdown of your library. You'll also get one-click shelf suggestions based on your games, along with recommendations to clean up shelves you never use.
🧩 More powerful shelf creation
Creating shelves is much more flexible now:
Many new filter and sorting options (playtime, genre, achievements, install size, friends playing, and more).
Combine multiple sources into a single shelf.
New built-in shelves like Never Played and Deck Playable.
Include games from other launchers.
🎨 More customization
Personalize every shelf with logos, icons, descriptions, and resizable banners. There's also a new full-page shelf layout for a more immersive look, plus small game icons displayed next to each title.
💾 Profiles
Save your entire configuration as a profile, switch between profiles instantly, and export/import them for backups or multiple Steam Decks. A built-in Default profile lets you reset everything whenever you want.
🎮 Custom shortcuts
Remap—or completely disable—the controller shortcuts to match your preferences.
🔍 Better navigation
Quick Search lets you instantly jump to any game, while the new Side Navigation makes moving between shelves much faster and automatically opens on your current shelf.
☀️ Light Mode **& 🛠️ Advanced Mode
Choose the experience that fits you:
Light Mode keeps the interface simple by hiding advanced options.
Advanced Mode unlocks integrations, diagnostic tools, reset options, and log viewing for power users.
🔔 Better notifications & logging
Notifications are now cleaner and more consistent, with dedicated icons and clickable update alerts. For troubleshooting, you can enable Show all logs and copy them directly when needed.
This release includes many additional improvements, fixes, and quality-of-life changes beyond the highlights above.
Full release notes: https://github.com/santojon/Deck-Shelves/releases/tag/v3.0.0

Deck Shelves 3.0.0 is here! 🎉

This is the biggest update the plugin has received so far. The goal wasn't just to add features, but to make Deck Shelves feel like a more complete and polished part of the Steam Deck experience.

⚙️ A real Settings page

The old compact menu is gone. Settings now open in a full-screen interface (from the gear icon in Quick Access) with dedicated tabs for Shelves, Profiles, Shortcuts, Backup, and more.

📊 Statistics & Smart Suggestions

See how you actually use your shelves with activity charts, most-used shelves, and a breakdown of your library. You'll also get one-click shelf suggestions based on your games, along with recommendations to clean up shelves you never use.

🧩 More powerful shelf creation

Creating shelves is much more flexible now:

• Many new filter and sorting options (playtime, genre, achievements, install size, friends playing, and more).
• Combine multiple sources into a single shelf.
• New built-in shelves like Never Played and Deck Playable.
• Include games from other launchers.

🎨 More customization

Personalize every shelf with logos, icons, descriptions, and resizable banners. There's also a new full-page shelf layout for a more immersive look, plus small game icons displayed next to each title.

💾 Profiles

Save your entire configuration as a profile, switch between profiles instantly, and export/import them for backups or multiple Steam Decks. A built-in Default profile lets you reset everything whenever you want.

🎮 Custom shortcuts

Remap—or completely disable—the controller shortcuts to match your preferences.

🔍 Better navigation

Quick Search lets you instantly jump to any game, while the new Side Navigation makes moving between shelves much faster and automatically opens on your current shelf.

☀️ Light Mode & 🛠️ Advanced Mode

Choose the experience that fits you:

• Light Mode keeps the interface simple by hiding advanced options.
• Advanced Mode unlocks integrations, diagnostic tools, reset options, and log viewing for power users.

🔔 Better notifications & logging

Notifications are now cleaner and more consistent, with dedicated icons and clickable update alerts. For troubleshooting, you can enable Show all logs and copy them directly when needed.

This release includes many additional improvements, fixes, and quality-of-life changes beyond the highlights above.

Full release notes: https://github.com/santojon/Deck-Shelves/releases/tag/v3.0.0

Now you can create your own shelves sources, filters, import sources etc by creating your own integrations over your plugins in a very simple way!

Version 0.1.1 of Deck shelves API is published on NPM.

Works with Deck Shelves 2.4.3+!

Now you can enhance your usability and customization by hiding or showing settings on QAM, using built-in settings panel by double dpad right on QAM.

Since we have a lot of customization options right now, some of them are not in use all the time or you activate and doesn’t like to see that on QAM anymore, we can just hide it from QAM to make the plugin use simpler.

This works on version 2.4.3+.

Enjoy!

Deck shelves is now at 1k downloads on GitHub! 🎉

With version 2.4.3 the plugin beat that.

Thank you all for using it. We have much more to come.

Available in Deck Shelves 2.3.0!

Theme by u/ProfessionHonest3193

Available on Decky store.

Download latest at: https://github.com/santojon/Deck-Shelves/releases/tag/v2.0.1

Disponível na loja Decky.

Baixe o mais recente aqui: https://github.com/santojon/Deck-Shelves/releases/tag/v2.0.1

Disponible en la tienda Decky.

Descarga la última versión en: https://github.com/santojon/Deck-Shelves/releases/tag/v2.0.1

Deck Shelves v2.0.0 was added to Decky Loader store 🎉

Now you can just search it there to find and install.

Additionally, v2.0.1 is live, and you can download and install manually if you want from here: https://github.com/santojon/Deck-Shelves/releases/tag/v2.0.1

Thank for all the community support and feedback!

Report issues/request features here: https://github.com/santojon/Deck-Shelves/issues

Some of you already know,

I was working in Deck Shelves for a while and now I’ll take a break….

But just to use and test it a lot for some time before keep updating it.

My current goal is to make it approved on Decky store, so I’ll keep it stale until it occurs.

But… what is new on V2 Since 1.x.x versions?

* Shelves have new filters and sort options. Including random and manual sorting. With built-in preview to verify how it will be like in home
* New visual options such as highlight individual games, or show/hide game names, download status etc.
* Smart shelves with edit and smart filtering options like hour of a day or day of a week to appear etc
* Refresh random shelves
* More templates
* UI/UX enhancements
* Translations updated
* Enhanced ArtHero compatibility
* API for other plugins add their own shelves, import and filters sources or get shelves data from Deck Shelves

And much more.

You can see full notes from versions here: https://github.com/santojon/Deck-Shelves/blob/main/RELEASE_NOTES.md

If you’re interested in test or use it now, you can download and install it manually from here: https://github.com/santojon/Deck-Shelves/releases/tag/v2.0.0

For more info or reporting bugs/enhancements or request new features, fell free to go to project’s GitHub: https://github.com/santojon/Deck-Shelves

Thank you all for keep giving me good feedback!

Deck Shelves is an open-source Decky plugin that adds customizable game shelves to the Steam Deck home screen (filters, collections, Non-Steam games, hero background, etc.).

**Release v1.5.0** — highlights below. Full notes: https://github.com/santojon/Deck-Shelves/releases/tag/v1.5.0

What's new

• **Highlight All**: new per-shelf toggle (`highlightAll`) and global toggle (`globalHighlightAll`) that rend...
• **Publisher filter**: new filter type
• **App ID list filter** (`appIdList`): new filter type matching games by explicit app IDs (comma-separated t...
• assets/import/screenshots-en.json

Changes

• **QAM visibility**: Smart Shelves section and Apply Globally toggles are now hidden when the plugin is disa...

Fixes

• **Navigation Bug B**: no longer bridges focus from native tabs (below our mount) into the first shelf when...
• **Navigation Bug A**: pressing DIR_DOWN from the last shelf no longer causes Steam to wrap focus back to th...

_5 more change(s) in the full release notes._

• Releases: https://github.com/santojon/Deck-Shelves/releases

Deck Shelves is an open-source Decky plugin that adds customizable game shelves to the Steam Deck home screen (filters, collections, Non-Steam games, hero background, etc.).

**Release v1.3.0** — highlights below. Full notes: https://github.com/santojon/Deck-Shelves/releases/tag/v1.3.0

### What's new

- Experimental `Use first shelf as recents (experimental)` toggle

- Runtime kill switch for the experiment: filters appids by Steam (Game/Application) before injection, detect...

- `qa:all-shelves-hide-home-tabs` / `qa:all-shelves-show-home-tabs` scripts mirror the recents-hide harness f...

- `Hide home tabs` toggle hides the native novidades/amigos/recomendados area (detected via `[role="tablist"]...

### Changes

- PR title tag → version bump mapping: `[FEATURE]` is now minor (was major), `[REFACTOR]` is now major (was m...

- Shelf-to-shelf centring: switched to direct math on the resolved scrollable ancestor and coalesced to one s...

- Screenshot automation opens the Steam main menu and activates its first item (home) before capturing, waits...

- Reddit release post: replaced the full changelog dump with a condensed, 3-section summary (top bullets per...

### Fixes

- `collectionStore.userCollections` access in is now try/catch'd per host window

- Compat checks: 4 false positives eliminated (Colored Compatibility Icons, QAM Hide Tabs, Non-Steam Badges,...

- Screenshot capture no longer leaves the home in an overlay/focus state

- Duplicate first shelf when the replace-source experiment is actively injecting

_10 more change(s) in the full release notes._

---

- Releases: https://github.com/santojon/Deck-Shelves/releases

Changelog

Changed

• `[PERF]` Focus restoration MutationObserver scoped from `document.body` to `.deck-shelves-root` — fewer mutation callbacks during idle and user navigation
• "Show background art" toggle is now hidden when "Hide recent games" is inactive (instead of disabled) — removes dead UI state
• QAM action buttons regrouped: Add / Import / Export on the left; Import from TabMaster on the right
• Shelf action button (⋯) right-aligned to match the TabMaster import button position
• Card dimensions discovered from the native SteamOS shelf are now persisted to `localStorage` (`ds-cardsize`) per viewport/DPI, so cold boot reuses the last-session values instead of briefly rendering the hardcoded fallback before re-measuring — eliminates the initial card reflow. Cache is keyed by `innerWidth`/`innerHeight`/`devicePixelRatio` and re-measured whenever the viewport changes.
• About page doc sections now render inside the native SteamOS `DialogBody` + `DialogControlsSection`, matching the container decky-loader itself uses for its own settings pages. This restores scrolling on every About subpage (Overview / How to / Shelves / Filters / Support) without a custom bounded-height wrapper.

Fixed

• "Installed" filter no longer includes every UnifiDeck shortcut as installed — UnifiDeck marks all its shortcuts `installed: true` in the app overview; the filter now cross-references the `[Unifideck] Installed` collection (the same source TabMaster-based tabs use) for non-Steam apps, falling back to `size_on_disk` / local playtime when the collection is absent. Also extended the non-Steam detector to handle UnifiDeck's numeric `app_type` value.

Releases: https://github.com/santojon/Deck-Shelves/releases