﻿Cheat Happens Cosmos Linux
www.cheathappens.com

DOCUMENTATION


REQUIREMENTS / INSTALLATION
------------
=>	Desktop mode
First switch to desktop mode. While Steamdeck is on, hold down the power button of your Steamdeck until a menu appears.
Click on 'Switch to desktop'.

=>	Folder
Right click anywhereon the desktop and choose 'Create new' and then 'Folder'. Give the folder a name. Open this folder by double clicking on it.

=>	Root Password
This folder is now opened in 'Dolphin'. You must have set a root password first.
Steamdeck comes without a password. In order to set a password right click into the empty content area of this folder
then choose 'Open Terminal'. In this new window type: "passwd" without quotes. Now enter your new password.
NOTE: On Linux it is normal that you don't see anything when entering your password.
ATTENTION: Write down your password somewhere. It is VERY important that you don't loose or forget it!!!
HINT: You must type this password very often, so choose it wisely.

=>	Launch Cosmos Linux
Extract / copy the Cosmos Linux files into this folder. Switch back to the terminal and type: "sudo ./CosmosLinux" without quotes.
It will ask you for the previously set password. Type it in and press return key. Cosmos launches now.
Note: Everytime you want to launch Cosmos you must open the terminal in the folder and run the command above.

=>	Clipboard
In order to be able to use the clipboard function you must install xclip. Open the terminal from anywhere and type
"sudo apt install xclip" without quotes. Enter root password.

=>	Virtual Keyboard
Its recommended you use a bluetooth keyboard but if you don't have one you can spawn the virtual keyboard (if steam is running)
by pressing the STEAM+X buttons. As of time this is written the virtual keyboard of Steam doesn't open all the time so just keep
pressing these buttons until it appears.

=>	Alt-Tab
Unfortunately some games are locking the cursor or running in fullscreen. As of time this is written there is no inbuilt solution
to switch back to Cosmos. We recommend you use a bluetooth keyboard.

=>	Hotkeys
At the moment Cosmos has a few hardcoded hotkeys:

F9 = Start a new scan (you must have entered a value before)
F10 = Rescan for changed value
F11 = Rescan for unchanged value
Page Up = Rescan for increased value
Page Down = Rescan for decreased value

In the future these hotkeys can be changed and we will add more hotkeys for more (re)scan options.


KNOWN ISSUES
------------
=> Misplaced Windows
This is a known Avalonia bug. We have to wait for Avalonia Team to fix it.

=> Wrong sized dialogs
This is a known Avalonia bug. We have to wait for Avalonia Team to fix it.

=> The combobox items of 'Type' in cheat table are hard to read
This is a known Avalonia bug. We are looking for a workaround until Avalonia Team fixes it.

=> Windows may spawn somewhere else and suddenly centers on main window
This is a workaround for a known Avalonia bug. We have to wait for Avalonia Team to fix the original bug.


Cheat Happens is a trademark of Dingo WebWorks, LLC
Cosmos Linux (C) 2022