# lukeshortcloud/gameos-unlock architecture

> Architecture diagram of the GitHub repository lukeshortcloud/gameos-unlock, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lukeshortcloud/gameos-unlock
- Repository: https://github.com/lukeshortcloud/gameos-unlock

## Overview

GameOS Unlock is a collection of community scripts for remotely adding applications and modifying Playtron GameOS. The documented workflow is to prepare SSH access, then run installation scripts on the device; documented capabilities include Flatpak apps, desktop-mode installation, NVIDIA Mesa drivers, and uninstalling modifications. The README excerpt and tree identify these entry points, but no source excerpts were provided, so internal implementation details and connections between OS-modification examples are not inferred.

Main entry points: [`plugin-local/install-flatpak.sh`](https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/install-flatpak.sh) (Install Flatpak), [`plugin-local/uninstall-flatpak.sh`](https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/uninstall-flatpak.sh) (Uninstall Flatpak), [`gameos-unlock-uninstall.sh`](https://github.com/lukeshortcloud/gameos-unlock/blob/main/gameos-unlock-uninstall.sh) (Uninstall modifications), [`bootc/desktop/install-desktop-mode.sh.example`](https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/desktop/install-desktop-mode.sh.example) (Install desktop mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_remote["Remote access"]
  node_gameos["GameOS device"]
end

subgraph group_apps["Flatpak apps"]
  node_install_flatpak["Install Flatpak<br/>[install-flatpak.sh]"]
  node_uninstall_flatpak["Uninstall Flatpak"]
end

subgraph group_osmods["OS modifications"]
  node_uninstall_mods["Uninstall modifications"]
  node_desktop_installer["Install desktop mode"]
  node_desktop_image["Desktop image example"]
  node_nvidia_image["NVIDIA Mesa example"]
end

node_operator(("Device operator"))

node_operator -->|"connects via SSH"| node_gameos
node_operator -->|"runs remotely"| node_install_flatpak
node_install_flatpak -->|"installs apps on"| node_gameos
node_operator -->|"runs remotely"| node_uninstall_flatpak
node_uninstall_flatpak -->|"removes apps on"| node_gameos
node_operator -->|"runs remotely"| node_uninstall_mods
node_uninstall_mods -->|"reverts changes on"| node_gameos
node_operator -->|"runs remotely"| node_desktop_installer
node_desktop_installer -->|"installs desktop mode on"| node_gameos

click node_install_flatpak "https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/install-flatpak.sh"
click node_uninstall_flatpak "https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/uninstall-flatpak.sh"
click node_uninstall_mods "https://github.com/lukeshortcloud/gameos-unlock/blob/main/gameos-unlock-uninstall.sh"
click node_desktop_installer "https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/desktop/install-desktop-mode.sh.example"
click node_desktop_image "https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/desktop/Containerfile.example"
click node_nvidia_image "https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/nvidia-mesa/Containerfile.example"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gameos toneBlue
class node_install_flatpak,node_uninstall_flatpak toneAmber
class node_uninstall_mods,node_desktop_installer,node_desktop_image,node_nvidia_image toneMint
class node_operator toneIndigo
```

## Components

### Remote access

- **GameOS device**

### Flatpak apps

- [Install Flatpak](https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/install-flatpak.sh): `plugin-local/install-flatpak.sh`
- [Uninstall Flatpak](https://github.com/lukeshortcloud/gameos-unlock/blob/main/plugin-local/uninstall-flatpak.sh): `plugin-local/uninstall-flatpak.sh`

### OS modifications

- [Uninstall modifications](https://github.com/lukeshortcloud/gameos-unlock/blob/main/gameos-unlock-uninstall.sh): `gameos-unlock-uninstall.sh`
- [Install desktop mode](https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/desktop/install-desktop-mode.sh.example): `bootc/desktop/install-desktop-mode.sh.example`
- [Desktop image example](https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/desktop/Containerfile.example): `bootc/desktop/Containerfile.example`
- [NVIDIA Mesa example](https://github.com/lukeshortcloud/gameos-unlock/blob/main/bootc/nvidia-mesa/Containerfile.example): `bootc/nvidia-mesa/Containerfile.example`

### Other components

- **Device operator**

## Connections

- Device operator → GameOS device: connects via SSH
- Device operator → Install Flatpak: runs remotely
- Install Flatpak → GameOS device: installs apps on
- Device operator → Uninstall Flatpak: runs remotely
- Uninstall Flatpak → GameOS device: removes apps on
- Device operator → Uninstall modifications: runs remotely
- Uninstall modifications → GameOS device: reverts changes on
- Device operator → Install desktop mode: runs remotely
- Install desktop mode → GameOS device: installs desktop mode on