General Settings Screen - cressie176/Load64 GitHub Wiki
Configure application-level settings for LoadC64.
- Set the games directory path
- Configure the LoadC64 Catalogue URL
- Enable or disable the splash screen
The General Settings screen is reached from the Admin Hub.
When all settings are configured:
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β TOP BAR β
β General Settings β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β FORM β
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β βββββββββββββββββββββββββββββββββββββββ β β
β β Games Directory * β /Users/steve/Games/C64_ β [Browse] β β
β β βββββββββββββββββββββββββββββββββββββββ β β
β β β β
β β βββββββββββββββββββββββββββββββββββββββββββββββββ β β
β β Catalogue URL β https://github.com/LoadC64/catalogue/relβ¦_ β β β
β β βββββββββββββββββββββββββββββββββββββββββββββββββ β β
β β β β
β β Show Splashscreen [On] β β
β β β β
β β [Save] [Cancel] β β
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
When no games directory is configured (first run or unconfigured):
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β TOP BAR β
β General Settings β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β FORM β
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β βββββββββββββββββββββββββββββββββββββββ β β
β β Games Directory * β _ β [Browse] β β
β β βββββββββββββββββββββββββββββββββββββββ β β
β β β β
β β βββββββββββββββββββββββββββββββββββββββββββββββββ β β
β β Catalogue URL β _ β β β
β β βββββββββββββββββββββββββββββββββββββββββββββββββ β β
β β β β
β β Show Splashscreen [On] β β
β β β β
β β [Save] β β
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
β A games directory is required to continue. β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
When no catalogue URL is configured:
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
β Catalogue features are disabled. Enter a Catalogue URL to enable them. β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Purpose: Identify the current screen
Type: Form
Focusable: Yes (primary focus region)
Interactive: Yes
Purpose: Edit all application-level settings in one place
Fields are pre-populated with current values when already configured. Games Directory defaults to ~/Documents/LoadC64/games if not yet configured.
Path to the directory where LoadC64 looks for games. Can be typed directly or selected via the OS file picker opened by [Browse]. A valid games directory is required for LoadC64 to function.
URL of the LoadC64 Catalogue ZIP. Leaving this field empty disables catalogue features (ROMSet lookup, metadata seeding, suggested third-party catalogue IDs).
Toggle controlling whether the LoadC64 splash screen is shown at startup. Pressing confirm toggles between [On] and [Off].
- [Save] validates all fields. If the games directory path exists, saves all settings and returns to the Admin Hub screen. If the games directory path does not exist, opens the Create Directory confirmation overlay. If any field is otherwise invalid, displays an error in the bottom bar and keeps the form open.
- [Cancel] discards changes and returns to the Admin Hub screen. [Cancel] is only shown when a valid games directory is already configured.
Shown when [Save] is activated and the entered games directory path does not exist.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ββββββββββββββββββββββββββββββββ β
β β Create directory? β β
β β <path> β β
β β β β
β β > Yes β β
β β No β β
β ββββββββββββββββββββββββββββββββ β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| Option | Behaviour |
|---|---|
| Yes | Create the directory, save all settings, trigger an audit, and return to Admin Hub |
| No | Close the overlay and return to the form |
If the directory cannot be created (e.g. insufficient permissions), an error is shown in the bottom bar and the form remains open.
Focusable: No
Interactive: No
Purpose: Display status messages and validation errors
When no games directory is configured:
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
β A games directory is required to continue. β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
When the Catalogue URL field is empty (and games directory is configured):
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
β Catalogue features are disabled. Enter a Catalogue URL to enable them. β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
After a validation error:
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β BOTTOM BAR β
β <Error message> β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| Name | Type | Required | Notes |
|---|---|---|---|
| Games Directory | String | Yes | Must not be empty. Must be an existing directory or one that can be created. |
| Catalogue URL | String | No | If provided, must be a valid URL. |
| Show Splashscreen | Boolean | Yes | Defaults to on. |