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.
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.
| Service | What you need |
|---|---|
| Boosteroid | games you already own |
| GeForce NOW | games you already own |
| Xbox Cloud | your subscription gives you the games |
| Amazon Luna | your 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.
- Open Decky Loader's settings. Open the Quick Access menu, press the plug icon, then press the cog at the top of the panel.
-
Go to Store, set it to Custom, and enter:
https://alphastore.schelstraete.org - 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.
-
Open the Quick Access menu on your Deck (the
… button), go to the plugin tab, and choose
Shelfcloud.
Shelfcloud sits in the Decky plugin list. - 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.
- 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.
- 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
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.
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
- 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.
- Select games on Shelfcloud — opens the list of games. Here you can search and choose what appears on your Deck.
- Add all my games — adds every game you can play. This means the games you own on Steam that also work on a cloud service you have, the free games, and the games your subscriptions include. The number on the button shows how many games there are.
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.
- It opens in its own browser profile. This is separate from the one your games use. When you sign in to a website here, it does not change your game logins. Nothing on the website can reach them.
- You can see the address bar. A game opens in a locked window. A website does not, because you typed the address and want to move around the site.
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.
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.
- Shared library — the normal choice. Every device sees these games.
- A shelf — only a device set to this shelf sees its games. It also sees the shared games.
Choose which shelf a device uses in Settings › Shelf in the plugin. You make and manage the shelves on the website.
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.
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:
| Service | R4 | L5 |
|---|---|---|
| GeForce NOW | the in-game overlay Ctrl+G | streaming statistics Ctrl+N |
| Amazon Luna | the Luna menu Shift+Tab | fullscreen F11 |
| Xbox Cloud | release the mouse pointer F9 | fullscreen F11 |
| Boosteroid | Ctrl+F2 | Alt+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.
Ctrl+G · L5 Ctrl+N
Ctrl+F2 · L5 Alt+R
F9 · L5 F11
Shift+Tab · L5 F11Xbox 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.
- 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.
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.
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
- 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.logeach 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.