Binary List Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

View and configure the VICE path for each supported binary.

Main Screen Design

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Binaries                                                [Discover]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  LIST                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │   Binary            Path                                      Status   │  │
│  ├────────────────────────────────────────────────────────────────────────┤  │
│  │ > Commodore 64      /Applications/VICE/bin/x64sc                   ✓   │  │
│  │   C64 DTV           —                                              —   │  │
│  │   Commodore 128     —                                              —   │  │
│  │   VIC-20            /Applications/VICE/bin/vic-20                  ✗   │  │
│  │   Commodore Plus/4  —                                              —   │  │
│  │   Commodore PET     —                                              —   │  │
│  │   CBM-II            —                                              —   │  │
│  │   CBM 5x0           —                                              —   │  │
│  │   SuperCPU 64       —                                              —   │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: [Discover] and [Back] CTAs
Interactive: [Discover] and [Back] CTAs
Purpose: Display the screen title and provide access to auto-discovery

[Back] CTA

Returns to the previous screen.

[Discover] CTA

Navigates to the Binary Discover screen.

LIST

Type: Single-selection vertical list
Focusable: Yes (primary focus region)
Interactive: Yes
Order: Fixed — Commodore 64, C64 DTV, Commodore 128, VIC-20, Commodore Plus/4, Commodore PET, CBM-II, CBM 5x0, SuperCPU 64
Purpose: View and edit the binary path for each supported system (and potentially other binaries in future)

Each row shows:

Binary name
Configured binary path, or — if not configured
Status indicator: ✓ if the binary exists and is executable, ✗ if configured but invalid, — if not configured

All rows are always selectable. Selecting a row navigates to the Binary Edit screen for that binary.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display a status message when the focused row requires attention

When a configured path is invalid:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Reason>. Games on this platform will be unlaunchable.                      │
└──────────────────────────────────────────────────────────────────────────────┘

Where <Reason> is one of:

Binary not found
Binary is not executable

No message is shown when the focused row is not configured or is valid.