This page details the general maintenance tasks for the display machine. For more in depth information concerning how to set up the machine for kiosk mode, see Linux Environment Details.

The kiosk application can be exited by plugging in a keyboard to the machine and hitting Ctrl+Q on the menu of the display application. This will take you back to the login screen.

In the bottom right (bottom left if rotated landscape) of the login screen there will be some text that says "Desktop Session: ...". Clicking this will bring up a drop down menu containing three options:

• Kiosk (Wayland)
• Plasma (Wayland)
• Plasma (X11)

Choose Kiosk (Wayland) for the kiosk mode. Choose Plasma (Wayland) for the desktop mode. After selecting, type in password as normal to log in.

Note: Plasma (X11) is another desktop mode using older software and likely will not provide a good touchscreen interface, only use if there are issues with Plasma (Wayland).

1. Log into desktop mode.
2. Navigate to the GitHub repo in the browser. It should be on the bookmarks toolbar in Firefox.
3. Navigate to the Releases section.
4. Download the executable for the latest release. It will be the file that does not have a file extension.

5. Open the file manager and navigate to the Downloads folder. Copy the executable file you just downloaded (Tap file to select and use Ctrl+C on keyboard to copy. Don't execute the file if asked).
6. Navigate to the kioskapp folder on the desktop. This is the folder where the executable used in the kiosk environment is located.
7. Paste the executable into the folder (Ctrl+V). Overwrite if prompted. Ensure that the executable is named exactly "cob-taylor-games".
8. Make the application executable. You do this by running the command chmod +x ./cob-taylor-games in the kioskapp folder. An easy way to open a terminal in the folder is by hitting F4 while in the file explorer. This will open up the Dolphin file manager's built-in terminal.
9. The program files must be updated as well in most cases. To do this, navigate to the repo folder cob-taylor-games on the desktop.
10. Use the terminal to switch to the required branch and pull.
    • Use git switch <branchname> or (git switch --create <branchname> if the branch doesn't exist locally) to switch branches.
    • Use git reset --hard if Git displays an error about uncommitted changes when trying to switch branches.
    • Use git pull to pull.
11. Copy the gamefiles and menufiles folders into the kioskapp folder.
    • NOTE: Do not copy the leaderboard folder as this could overwrite the leaderboard!!
    • profanitycheck folder is also not necessary unless there have been explicit changes to the profanity checking system.
12. Log out from desktop mode and log back into kiosk mode.

If you log into the kiosk mode and all you see is a flashing black terminal screen, this means that the application is not able to run. Usually this is caused by the application not being executable, the application not being able to find necessary libraries, or there being a bug in the application that causes it to crash immediately. If this is happening you can return to the login screen by spamming Ctrl+C.

The system should be updated and restarted at least once a month. There are two ways to update the system:

1. Log into desktop mode.
2. Find the update icon in the system tray and click it. If it is not appearing in the tray you may need to click the arrow to show more.

3. This will bring up the Discover software store on the update tab. Click "Update All" in the top right after it is finished loading.

4. After the update has finished, restart the machine.

If there were any issues with this process, try the next option...

1. Log into desktop mode.
2. Open the terminal application (called Konsole).
3. Run the command sudo apt update && sudo apt upgrade. Enter password if asked and hit Y and enter at all prompts.
4. After the update has finished, restart the machine.