I’ve just released Deck Shelves 3.3.3 and ShelvesHub 0.4.0.

At this point both projects support quite a few different Steam setups, so I’d really like some help testing them outside my own devices — especially unusual configurations.

Deck Shelves 3.3.3

This release is mostly about compatibility, reliability and adapting to newer Steam UI changes.

Some highlights:

• Better support for Steam’s new Big Art / redesigned Home layouts
• Fixes for shelves disappearing, duplicating, being positioned incorrectly or becoming unreachable after Steam starts
• Better compatibility with Steam Beta builds
• Fixes for ArtHero and Switch Like Home
• Private Steam wishlists work again
• Remote Play cards now correctly distinguish between Play / Stream / Install
• Profile triggers now reliably reapply their actual settings after syncing between devices
• Showcase mode now stops correctly when Steam loses focus
• Improved standalone-host information in Diagnostics and bug reports
• Steam Stable / Beta / Preview channel is now shown in System Info
• Release packages now include SHA256 checksums
• New Visibility Rule / profile conditions:
  • Device kind
  • Input mode — gamepad vs pointer

The new device/input conditions are particularly interesting for people using Deck Shelves across a Steam Deck + desktop/HTPC setup.

ShelvesHub 0.4.0

ShelvesHub is the standalone host for Deck Shelves — Decky Loader is not required.

It can inject Deck Shelves directly into Steam Big Picture, host its backend, manage updates and provide its own native Quick Access Menu tab.

0.4.0 continues pushing that standalone experience much further:

• Standalone notifications/toasts now work
• ShelvesHub can stage and finish its own updates
• Automatic Deck Shelves updates
• Native ShelvesHub Quick Access Menu
• Integrated Deck Shelves backend for online features, backups, prices, wishlist, etc.
• Host/runtime logs and troubleshooting tools directly from the QAM
• Coexists with Decky rather than requiring you to remove it
• One-click installers for SteamOS, Linux, Windows and macOS
• macOS universal build for Intel + Apple Silicon
• Windows per-user installer with no admin requirement

And one of the things I’m most interested in testing:

ARM64 builds are now available for SteamOS and Linux.

There are dedicated aarch64 packages and architecture-aware installation/update handling. The build pipeline and automated tests are in place, but real ARM64 hardware validation is still experimental, so feedback here would be especially valuable.

Who I’m looking for

If you use any of these setups, I’d love your help:

• Steam Deck LCD / OLED
• Steam Stable
• Steam Beta / Preview
• Bazzite
• ChimeraOS / HoloISO / other SteamOS-like systems
• Linux desktop + Big Picture
• Windows + Big Picture
• macOS
• ARM64 Linux / SteamOS-compatible hardware
• Decky + ShelvesHub installed together
• CSS Loader themes, especially Home-screen-changing themes
• Multiple PCs/Decks sharing Deck Shelves settings
• Remote Play / Steam streaming setups

Even simply installing it and telling me “this works on X hardware / OS / Steam channel” is useful.

If something breaks, Deck Shelves 3.3.3 now exposes more of the relevant environment information in Settings → Advanced → System Info / Diagnostics, which should make reports much easier to reproduce.

Downloads

Deck Shelves 3.3.3
https://github.com/santojon/Deck-Shelves/releases/tag/v3.3.3

ShelvesHub 0.4.0
https://github.com/santojon/ShelvesHub/releases/tag/v0.4.0

Deck Shelves repository
https://github.com/santojon/Deck-Shelves

ShelvesHub repository
https://github.com/santojon/ShelvesHub

Community

Discord
https://discord.gg/EChuVEDakk

Subreddit
https://www.reddit.com/r/DeckShelves/

If you test either one, please mention your device, OS, Steam Stable/Beta/Preview channel, installation method (Decky or ShelvesHub), and any CSS Loader themes you use.

Bug reports, weird edge cases, screenshots and even “everything works here” reports are all welcome.

You can report things on GitHub, join us on Discord, or post directly in r/DeckShelves.

Thanks to everyone who has been testing and reporting issues so far. The amount of different Steam configurations these projects now touch makes real-world testing incredibly valuable.

More info

Deck Shelves website
https://santojon.github.io/Deck-Shelves/

ShelvesHub website
https://santojon.github.io/ShelvesHub/

I’ve been working on something new for Deck Shelves: ShelvesHub.

ShelvesHub is now the official standalone host for Deck Shelves. The main idea is simple: you can run Deck Shelves with or without Decky.

It runs as a small background service and loads Deck Shelves directly into Steam’s Big Picture UI. SteamOS / Steam Deck is still the primary target, but ShelvesHub also runs natively on Linux, Windows and macOS.

A few things it already supports:

• Deck Shelves without installing a plugin loader
• SteamOS, Linux, Windows and macOS
• One-click installers for each platform
• Its own Deck Shelves tab in the Quick Access Menu
• Automatic updates for both ShelvesHub and Deck Shelves
• Full Deck Shelves backend support, including online features
• Logs, recovery tools and configuration directly from Steam
• Coexistence with Decky — you don’t have to choose one or the other

So if you use Deck Shelves on a Steam Deck, a Bazzite machine, a Windows gaming PC, or even want it on Steam Big Picture on macOS, the goal is to provide the same Deck Shelves experience across all of them.

It’s still a young project, so feedback and testing are very welcome.

Website:
https://santojon.github.io/ShelvesHub/

GitHub:
https://github.com/santojon/ShelvesHub

This one brings a bunch of smaller things I’ve been wanting to add for a while, plus a few experimental features.

Some highlights:

• Keyboard shortcuts can now be used alongside gamepad bindings
• (Experimental) Optional settings sync between devices
• New Deck Shelves screensaver and Showcase modes
• 5 new filters, including review score, release date, demos and SteamOS compatibility
• Better TabMaster imports, including proper filter conversion
• Filters now work much better with wishlist/store games
• Optional Deck Shelves tab directly in the QAM
• A few Steam Beta and UI fixes

Most of the new experimental stuff is disabled by default, so nothing should suddenly change after updating.

As always, feedback and bug reports are very welcome — especially for the new sync, screensaver, Showcase and QAM features.

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

Just wanted to say a big thank you to everyone who downloaded and is using Deck Shelves.
It’s been really cool seeing the project grow, and I really appreciate all the feedback, suggestions, and support from the community. ❤️
On to the next milestone! 🚀

From 3.2.0, Deck Shelves Profile Triggers let you automatically activate a profile when a specific system condition is met.

✨ Highlights:

• 🖥️ External display conditions — trigger profiles when an external display is connected, including specific resolutions and docked setups.
• 🔋 Power conditions — activate profiles depending on whether the Steam Deck is charging or running on battery.
• 🎧 Bluetooth conditions — react to connected Bluetooth devices.
• 🕐 Time-based triggers — activate profiles based on specific times, days or schedules.
• 📅 Date conditions — create triggers for specific dates or date ranges.
• 🧩 Combine conditions — build more specific triggers by combining multiple conditions.
• 🔄 Automatic switching — once the conditions are met, Deck Shelves can automatically activate the associated profile.
• ➕ And much more — with more conditions available to help make your profiles truly context-aware.

The idea is simple:

Condition → Profile → Automatic activation

This makes profiles context-aware, allowing your setup to automatically adapt to how and where you're using it.

For example, I’m using a more info-rich profile when charging — which usually means my Deck is sitting in the dock:

📺 Logos, game descriptions, hero art on all shelves and native Recents hidden — perfect for a TV-docked experience.

When the Deck is disconnected, it automatically switches back to a simpler profile:

🎮 Shelves without hero art, logos or descriptions, with native Recents enabled again — better for portable use.

⚙️ How to configure Profile Triggers

Go to the Deck Shelves Settings → Profiles, then select the Triggers icon for the profile you want to configure.

Choose your conditions, configure the trigger, and let Deck Shelves handle the profile switching automatically. Remember to enable automatic profile switching in QAM profiles section.

📖 Learn more:
https://santojon.github.io/Deck-Shelves/

💬 Join the community:

🔵 Discord: https://discord.gg/EChuVEDakke
🟠 Reddit: https://www.reddit.com/r/DeckShelves/
🌐 Website: https://santojon.github.io/Deck-Shelves/

What kind of Profile Trigger would you use on your Steam Deck? 🎮

Deck Shelves — Your Steam Deck Home Screen. Your Way.

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.

With Deck Shelves 2.4.1, and the possibility to composite more than one source for a shelf, I started to do my own experimentation and try to mix many of my shelves into less but more meaningful ones.

Some shelf compositions I’m using now:

* Update pending + in execution. Ordered by recently executed (the actual running game is put to the start of the list). This shelf only shows if you are running something or something is needing to be updated.

* Backlog: some collections merged. The collections of games I want to finish. Random order.

* Free now + wishlist promos: a composition of two online sources: Store and wishlist. With different criteria for each. Store entries must be something with 100% discount and I didn’t have it on my Steam library yet. Wishlist ones may have discount around 50 and 100% and I didn’t have it on Steam or other libraries. Sorting by higher discount first, higher original price first.

Next steps: Thematic and decorated shelves.

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