Shelfcloud

User guide

Shelfcloud puts cloud games into your Steam library. You choose games here on the website. You can do this on any device. The games then show up on your Steam Deck as normal tiles with pictures. When you open a tile, it starts the game.

What you need: Shelfcloud comes in two forms. The Decky plugin runs on a Steam Deck, a Steam Machine, or a Bazzite install with Decky Loader. The Linux app runs on any Linux desktop and needs no Decky. Decky works only on SteamOS and Linux, and there is no Windows version, because Steam on Windows cannot load the plugin. You can choose games in any web browser on any computer. Only the tiles on your own machine need the plugin or the app.

Good to know: Shelfcloud only adds the tiles and opens the game on the cloud service for you. It does not change the games and it does not touch the cloud service itself. How a game plays, how it looks, bugs in the game, and whether GeForce NOW, Boosteroid, Xbox Cloud or Amazon Luna is fast or stable — that is the game and the service, not Shelfcloud. So if a game will not start or a stream is slow, please ask that service. We can not fix something inside the game or the stream itself.

What it does

Cloud games do not show up in your Steam library by themselves. Shelfcloud adds them for you. A cloud game then starts like any other game. You open its tile and play with your controller.

Shelfcloud comes two ways: a Decky plugin for the Steam Deck, Steam Machine or Bazzite, and a standalone Linux app for any Linux desktop, no Decky needed. Both do the same job and share the same games you pick here on the website, so you can run either one, or both.

ServiceWhat you need
Boosteroidgames you already own
GeForce NOWgames you already own
Xbox Cloudyour subscription gives you the games
Amazon Lunayour subscription gives you the games

This difference is important. Boosteroid and GeForce NOW stream games that you already own. Xbox Cloud and Amazon Luna work in a different way. There, the subscription gives you the games. Owning a game on Steam does not help you there. So these two services stay off until you turn them on in My Shelfcloud. This way, a tile never asks you to pay for something you did not choose.

Both services also sell different plans, and each plan has different games. (Game Pass has Essential, Premium, and Ultimate. Luna has Prime and Luna Premium.) Tell Shelfcloud which plan you have. Then any game your plan does not include is marked before you add it. You will not be surprised later.

Shelfcloud does not buy anything for you. You still need your own access to each game.

Installing the Decky plugin

Shelfcloud is a Decky plugin, so you need Decky Loader first. If the Quick Access menu already has a plug icon, Decky is installed. Shelfcloud is not in the official Decky store. You get it from AlphaStore. You add AlphaStore once, and it also lists the official plugins.

  1. Open Decky Loader's settings. Open the Quick Access menu, press the plug icon, then press the cog at the top of the panel.
  2. Go to Store, set it to Custom, and enter:
    https://alphastore.schelstraete.org
  3. Open the store and search for Shelfcloud. Then press Install. The official plugins are still there too. This does not remove anything.

You update it the same way. When there is a new version, the store shows it. Install it, and you stay signed in. Your shelves and settings are kept on the server, not in the plugin.

Installing the Linux app

On a plain Linux desktop, where there is no Decky, the standalone Shelfcloud app does the same job. It writes the tiles into your Steam library itself, so there is no plugin and no Decky Loader to set up. It runs on any Linux desktop that has Steam.

The Linux app is coming soon. This section will get the download and the exact steps once it is out.

It works the same as the plugin. You sign in with Steam, pick your games here on the website (or in the app itself), and it syncs them to your Steam library as tiles. Your shelves and settings live on the server, so the games you picked are already there the first time you open it.

The plugin and the app recognise each other's tiles, so you can move from one to the other and your shelf stays intact — the app can remove or re-sync tiles the plugin made, and the plugin can do the same with the app's.

Getting started

After the plugin is installed, you do these steps on the Deck one time.

  1. Open the Quick Access menu on your Deck (the … button), go to the plugin tab, and choose Shelfcloud.
    The Decky plugin list in the Steam Deck Quick Access menu, with Shelfcloud at the top.
    Shelfcloud sits in the Decky plugin list.
  2. Press Sign in with Steam. Shelfcloud opens in Steam's browser. Sign in there. The panel sees this by itself. You do not need to go back and press anything.
  3. Choose a browser in Settings. Use Chrome or Edge. If you have neither, the plugin can install one for you. It also sets up the gamepad permissions. Firefox does not work: cloud services need video and gamepad features that only Chrome-based browsers have.
  4. Choose some games on this website. Then press Sync now in the panel.

The Linux app follows the same four steps, in its own window instead of the Quick Access panel: sign in with Steam, pick a browser, choose your games, and sync.

Your services

The account menu on the Shelfcloud website, open, with My Shelfcloud, Contact, User guide and Sign out.
You find everything about your account under Account.

Open Account › My Shelfcloud on this site. Turn on the services you have. This is the most important step. A game can only use a service that you have turned on. So a tile can never ask you to pay for something you did not choose.

The My Shelfcloud dialog listing Boosteroid, Xbox Cloud, GeForce NOW, Amazon Luna and websites, each with a switch and how many games it has.
Turn on the services you have. The number next to each one shows how many games it has.

Shelfcloud cannot check this. There is no way to ask a service if you have a subscription. So it trusts what you tell it. This is also why Xbox Cloud and Amazon Luna start switched off. On those two, the subscription gives you the games. Owning a game on Steam does not help you there.

Lower down in the same window are three more settings. They decide which games you see, and which service a game opens with.

Preferred service set to GeForce NOW, Game Pass set to Essential, Luna set to Prime, and a country picker.
Your plan decides which games you can play. Your country decides which games Game Pass offers.
Preferred service
Which service to use when a game is on more than one. This does not hide any games. If your favourite service does not have a game, it still opens with another one. You can also choose a service for each game.
Your Game Pass, Your Luna
Both services sell different plans, and each plan has different games. Tell Shelfcloud your plan. Then games your plan does not include are marked before you add them. You will not be surprised later.
Your country
Game Pass offers different games in different countries.

Adding games

You choose games here on the website. You can use any device, even a phone. Every game shows which services have it. If your plan does not include a game, it is marked before you add it.

The Shelfcloud catalogue: a search box, provider filters, and game cards each with an Add button and the services that carry them.
The game list. “Needs Premium” on a card means your plan does not include that game.
The Shelfcloud panel on the Deck showing 840 games in the library, a chip per service, and buttons to select games, add all games and sync.
The panel on the Deck. The chips say how many tiles each service has.

On Amazon Luna and Xbox Cloud, the subscription gives you the games. Owning a game on Steam does not matter there. Your plan decides how many games you see. Prime does not include the Luna Premium games. Game Pass Essential does not include the Premium games. Boosteroid and GeForce NOW are different. They stream a game you bought, so they only offer you games you own.

The first sync takes the longest. Every tile needs its picture downloaded and its controller layout set up. A large library can take a few minutes. The panel shows a Cancel button while it works. After the first sync, later syncs only change what is new and finish in seconds. If you press Cancel, it stops and keeps the tiles it already made. It does not add the rest, so nothing appears later to surprise you. A cancel never removes games you chose yourself.

Websites as tiles

Any website can be a tile, not only games. Add one under Your websites on this site. It then appears on your Deck like everything else. For example, a wiki, a shop, a dashboard, or a video site.

The websites section of My Shelfcloud, with one site listed and a form to add another, above the sign out and delete account controls.
Add any website as a tile. The same window has sign out and delete account.

One website is there already: Shelfcloud Website. It opens this site on the Deck, so you can choose games without using a phone. You can remove it like any other tile. If you remove it, it stays removed.

Where tiles end up

Each tile goes into a Steam collection named after its service. For example, Boosteroid (Shelfcloud) and GeForce NOW (Shelfcloud). All websites go together in Websites (Shelfcloud).

The word "(Shelfcloud)" in the name is on purpose. It shows which collections Shelfcloud manages. Shelfcloud may add tiles to these or empty them. So your own collection called "Boosteroid" is safe. If you move a game into one of ours by hand, it stays where you put it.

The Steam collections view showing one collection per service, each named with a Shelfcloud suffix and a game count.
One collection for each service. The "(Shelfcloud)" name shows which ones are ours.

If you turn on a tile per service, a game on three services gets a tile in each of those three collections. The tiles look the same, but each one opens its own service. So the collection you open it from is the service you get.

Shelves

A shelf is a group of games with a name. You make shelves here on the website. Each device can use a different shelf. So you can show different games on each device.

Choose which shelf a device uses in Settings › Shelf in the plugin. You make and manage the shelves on the website.

The shelves section listing two shelves with rename and delete buttons, and below it the devices signed in and which shelf each shows.
Your shelves, and which shelf each device uses.

You can put a game on a shelf when you add it, from the game card. So one game can be in the shared library, and another game can be only on the shelf your handheld uses.

A game card marked Added, with a list of shelves beside it and “Shared — every device” ticked.
Each game shows which shelves it is on. Choose only a shelf to keep it off your other devices.

If you have only one device, you do not need shelves. The shared library is enough.

Playing a game

Open the tile like any Steam game. The browser opens, and Shelfcloud presses Play for you.

The first time you use each service, you must sign in yourself. Shelfcloud never sees your password. The browser keeps it in its own profile. You do this one time for each service, not for each game.

If a page needs a click that Shelfcloud did not make, hold the Steam button and use the right stick as a mouse.

Gamepad or mouse, and the overlay

Every tile has a controller layout with two modes. L4 changes between them at any time. It starts in Mouse + Keyboard mode on purpose. A service often shows a start page, a sign-in box, or a cookie message first. You cannot click these with a gamepad. Press L4 when the game starts. Press it again if the game sends you back to a menu.

Each service has useful things behind a keyboard shortcut. The other two back buttons open them, so you do not need a keyboard:

ServiceR4L5
GeForce NOWthe in-game overlay Ctrl+Gstreaming statistics Ctrl+N
Amazon Lunathe Luna menu Shift+Tabfullscreen F11
Xbox Cloudrelease the mouse pointer F9fullscreen F11
BoosteroidCtrl+F2Alt+R

Steam shows this for each tile too. Open the controller icon on the game's page. So you can always check the layout of a tile:

You can set a different controller layout for each game. Open the game's page, press the controller icon, and choose the layout you want. This is a Steam feature, so your choice stays even after a Shelfcloud sync.

Xbox Cloud is different. It has no keyboard shortcut for its menu. On a controller, the Guide button opens it. In Gamepad mode, that button goes to the stream, so just use it. On Xbox Cloud, R4 does something else useful. Sometimes a game keeps the mouse and will not let it go. R4 gives the mouse back.

Boosteroid keeps the two shortcuts from its old layout. The table above shows the keys they send.

These layouts are made for the Deck's own controls and for controllers with back buttons. An Xbox or PlayStation controller gets a normal gamepad layout. It works well, but it has no L4 to change modes and no place for the shortcuts above. With these controllers, use the Steam button and the right stick as a mouse when a page needs a click.

Badges

A cloud tile looks like any other Steam tile. This can be confusing when your library has both. Two small marks on a game's page tell you what the game is and what is happening with it.

A game page with a GeForce NOW badge over the artwork and a badge reading 3,144 playing in the opposite corner.
The service the game uses, and how many people play it on Steam right now.
Provider badge
Shows which service the tile uses, in that service's colour. It appears only on tiles Shelfcloud made. So it also helps you tell a cloud game from a game installed on the machine.
Players online
Shows how many people are playing that game on Steam right now. This number comes from Steam's own public data. A cloud tile is not a Steam game, so Steam does not show this by itself.

About one game in six is not on Steam. Those games show nothing, not a zero. "No players" and "not on Steam" are not the same thing. The number updates every fifteen minutes. It tells you if a game is busy. It is not a live count.

The plugin settings showing switches for the provider badge and for the badge on the highlighted card.
You can turn off both badges. The card badge is separate from the one on the game's page.

You choose a corner for each badge. They cannot use the same corner. When you choose a corner for one badge, that corner is no longer offered for the other. This stops the two badges from covering each other.

Settings showing the players online switch, a corner picker for each badge, and the shelf this device follows.
One corner for each badge. A corner in use is not offered for the other badge.

Staying in sync

The plugin checks for changes by itself. You choose how often in Sync every. Games you add here appear on the Deck by themselves. A message tells you their names.

If you remove a game here, its tile goes away at the next sync. Tiles you made yourself are never changed.

Settings

The plugin settings: a browser picker, a sync interval, and the tile per service switch with its explanation.
The plugin’s settings, in the Quick Access panel.
Browser
Which browser games play in.
Shelf
Which shelf this device uses. "Shared games" is the normal choice. Choose a shelf to show different games on this device.
Sync every
How often to check for changes. More often is not better. Every few minutes is enough.
A tile per service

When this is off, a game gets one tile, on the best service for it. When it is on, a game gets one tile for every service it plays on. So a game on three services becomes three tiles. Each tile is in that service's collection, and each tile opens only that service.

When you turn it on, it also adds the games your subscriptions include that you had not added yet. Without this, you would see only a few tiles, and it would look broken.

This makes your library much larger. The first sync after you turn it on takes a long time. It is off until you turn it on. If you turn it off again, the extra tiles are removed.

Interface size

How much to make a service's website bigger. These sites are made for a computer screen that is close to you. That is small on a 7 inch handheld, and even smaller on a television across the room.

Auto checks the screen each time a game starts and chooses a good size. So you do not need to change this when you dock or undock. The line under it shows what it found. This line is also saved in the log. You can choose a percentage yourself if you prefer.

This is not the same as the screen resolution. Steam has its own resolution setting for each game. Open the Quick Access menu during a game, go to the performance settings (the battery icon), and turn on the per-game profile. This is useful with an external screen, and it can also help performance. Like the controller layout, this is a Steam setting, so your choice stays after a Shelfcloud sync.

Provider badge, Players online
The two marks on a game's page, and the corner for each one. See Badges.
Fix gamepad permissions
Lets the browser use your controller again. This is done by itself when the plugin starts and after a browser is installed. It is here in case something went wrong.
Remove all games
Deletes every tile Shelfcloud made. It asks you twice. It also empties your choices on the website, so a sync does not bring them back. This clears your whole Shelfcloud library, not only the tiles on this Deck. The games you own on Steam are kept, so "Add all my games" can fill it again quickly.
Sign out
Signs this device out. The tiles stay, but they stop updating.

If something is wrong

Nothing appears after syncing
Check that you are signed in. The panel shows this at the top. Also check that you have chosen games on the website.
A game opens the wrong page, or asks you to log in
Sign in to that service one time, in the browser Shelfcloud uses. The login is kept, so this should happen only once for each service.
A tile does nothing
Every game start is saved in a log, with the reason for what happened: ~/homebrew/logs/Shelfcloud/shelfcloud-launch.log
The controller does not work in the stream
First try Settings › Fix gamepad permissions. This lets the browser use your controller. If the controller still does nothing, and you have an external controller next to the Deck's own controls, open the Quick Access menu during the game and use Reorder controllers. Move your controller to the first slot. Then wait a few seconds. After that, the controller should work. Steam can leave the first controller slot empty, and cloud games use that slot. This is how Steam works. The plugin cannot change it for you.
If none of that helps — the Deck's own controls or an external one — restart Steam (Steam button › Power › Restart Steam) and start the game again. Steam sometimes ends up with two copies of the same controller, and the cloud game reads the empty one, so nothing happens even though the buttons work everywhere else. A restart clears them back to one. It happens more after opening and closing a lot of games in a row. This is a Steam issue, not something the plugin can fix for you.
A game uses the wrong controller layout
Restart Steam. Layouts are saved when a tile is made, but Steam only reads them when it starts. So if a layout is saved after Steam is already running, Steam does not know it yet, and the game uses a normal gamepad layout instead. This is how Steam works. The plugin cannot change it. When you restart Steam, it also reads every other new layout.
The interface is too small, or too large
Set Settings › Interface size to a percentage instead of Auto. The line under the menu shows which screen was checked and what size was chosen. The same line is saved to ~/homebrew/logs/Shelfcloud/shelfcloud-launch.log each time a game starts. Look there if Auto chooses a strange size.
You want different artwork on a tile
Shelfcloud gives every tile the best picture it can find. For a game with no official picture, it makes one. If you want to choose your own, install the SteamGridDB plugin from the Decky store. It uses SteamGridDB and lets you set the pictures on any game, including the tiles Shelfcloud made.
One thing to know: when a game's picture changes, a Shelfcloud sync updates it. This replaces the picture you chose. If your picture changes back to ours, this is why. Set it again after the sync is done.
"Could not reach the gateway"
The Shelfcloud server is asleep or offline. Games still start from their last known link, so this is usually not a big problem.

What is recorded

When you start a game, the server saves which game, when, and which service. This lets the game list show what people play. It also lets your link be updated if a service changes it.

Not your name. When you sign in through Steam, this service gets only one thing: your Steam ID number. We never get and never save your name, your profile, or your email. Your account here is only that number, the date it was made, and the last time you used it. Nothing else. So a saved game start cannot be linked to your name, because we never had your name.

It does not save what you look at, and it never saves your service passwords. Those stay in your browser. This plugin never sends them anywhere. You can read more in the privacy notice.

One more thing to know: your Steam friends can see the game you are playing. A cloud tile has the game's name, for example "Valheim (Boosteroid)". When you play it, Steam shows this name to your friends, like any other game. This is a Steam feature, not Shelfcloud. If you do not want this, you can hide it in your Steam privacy settings.

Screenshots taken on a Steam Deck running SteamOS.