Troubleshooting

What it does

When something goes wrong, RoomCaddie shows a line on the screen explaining what happened. This chapter explains the messages you may see when a tile does not start, how to restart RoomCaddie or leave it for the Windows desktop, and when to contact support.

Before you start

• Read the whole line on the screen first. It names the tile and gives the reason.
• Each chapter ends with a table of messages. This chapter covers messages that do not belong to a single chapter.

Step by step

Restart RoomCaddie

1. In the editor, press Settings….
2. Under Restart RoomCaddie, press Restart….
3. Press Restart.

RoomCaddie closes and reopens in a few seconds in the same room. Anything running keeps running.

Leave RoomCaddie for the Windows desktop

1. In Settings…, under Exit to Windows, press Exit….
2. Press Exit, or Stay to keep RoomCaddie open.
3. To return, open RoomCaddie from the Start Menu or the desktop shortcut.

Anything running keeps running.

Ask support for help

1. In Settings…, press Copy support info.
2. Paste it into an email to [email protected] and describe what you saw.

The Support and refunds chapter explains what the support info includes and what support covers.

Settings

Setting	Where	What it does	Default
Restart RoomCaddie	Settings > Restart RoomCaddie	Closes RoomCaddie and opens it again fresh, on this room. Anything running is left alone.	Nothing to set
Exit to Windows	Settings > Exit to Windows	Leaves RoomCaddie and shows the Windows desktop. Anything running stays running.	Nothing to set

Good to know

• Before RoomCaddie starts a tile, it checks what the tile needs. If it cannot finish the check, it starts nothing.
• A tile's line in the editor says "Untested" after any change to what it launches or how it ends.
• Ctrl+Alt+Q is the emergency exit. It closes RoomCaddie.
• If RoomCaddie cannot read your saved room, it shows a safe screen and leaves the file unchanged. Restart RoomCaddie, or restore a snapshot from Settings > Backups. Backups has a snapshot from before every change. When you restore a snapshot or a backup file over a saved room that RoomCaddie cannot read, RoomCaddie first keeps the damaged file as damaged-<date-time>.json in the room's Backups folder so support can look at it.

If something goes wrong

What you see	What to do
"program not found"	The program the tile points to is missing or has moved. Open the tile in the editor and point it to the program again, or delete the tile.
"a step doesn't point at a program (.exe)"	Open the tile in the editor and pick the program's .exe file for that step.
"that app isn't installed anymore"	Install the app again from the Microsoft Store, or remove it from the tile.
"that game isn't in this PC's Steam library anymore"	Install the game again in Steam, or remove it from the tile.
"Steam isn't installed on this PC"	Install Steam and sign in, or remove the Steam game from the tile.
"Microsoft Edge wasn't found"	Website tiles open in Microsoft Edge. Install or repair Microsoft Edge, then tap the tile again.
"part of it already opened"	Close what opened as you normally would, then tap the tile again.
"its program refused to launch"	Start the program once from Windows to see its own message. If it starts there, send the support info.
"so it didn't start anything"	RoomCaddie could not finish its check before starting. Wait a moment and tap the tile again.
"isn't set up yet"	The tile has no program yet. Open it in the editor and point it to a program.
"RoomCaddie couldn't read its key file"	Your key is still there, and nothing has changed. Open Settings again in a moment. If this keeps happening, send the support info.
"RoomCaddie couldn't read its carried-over record"	Only the note about your room moving over from ScreenBoss may be missing. Nothing has changed.
The home screen has a scroll bar	It should not have one. Tell support which theme you use and how many tiles are on the screen.
RoomCaddie came back after you told it to exit	It should not reopen. Send the support info. The log it includes explains what happened.