Skip to content

troubleshooting

github-actions[bot] edited this page Nov 15, 2026 · 5 revisions

Troubleshooting

Identify the failing layer first: hardware/device, filesystem, Launchstation launch preparation, external core, or the target application/game.

Device says Not checked

Open it. Not checked is intentionally actionable: the lazy driver has not yet established presence. A confirmed Not connected result is different.

USB path/unit changed

Do not assume mass0:. Multiple drives, MX4SIO and attach order can affect unit numbering. Start from the dashboard's USB / MASS device and let the root discovery logic identify what is available.

Paste fails while checking the destination

Older Launchstation builds used destination-stat checks before copying files. These could reject new memory-card files as directories (Checking destination (-21)) or reject missing MMCE files (Checking destination (-1)). Current ordinary copies follow R3Z 4.80: remove the old destination if present, then create and write the requested file directly. Paste no longer requires destination stat, temporary-file verification or rename support. A failed overwrite does not restore the previous destination; failed transfers retain Cut sources. Ordinary renames also use native directory/file conflict probes instead of the added destination-stat checks that could falsely reject unused memory-card names.

PS2 ISO will not start

  1. Browse/read the ISO from the same source device.
  2. Confirm it is an ISO9660 image.
  3. Set a Neutrino path explicitly to remove search-order ambiguity.
  4. Verify the Neutrino installation is complete for the version you use.
  5. Try a known-good ISO on the same backend.

PS1 VCD will not start

Confirm the VCD is in a supported POPStarter layout, then set POPStarter explicitly. HDD POPS layouts have special argument construction; a raw browser path is not necessarily a valid POPStarter command line.

Colored bars before opening ELFs

Launchstation can intentionally draw a short Game ID identification signal for compatible video adapters. To disable the colored bars, open Settings > Launching > Game ID output and turn off the application Game ID launch signal. Normal start-up boot-check text is hidden in production builds.

Top-of-dashboard flicker

The known fast selector oscillation has been removed. If flicker persists, report video mode, display/cable, interlace/progressive mode, theme, and whether the symptom occurs in the classic UI too.

Update check: HTTPS MAC error

HTTPS read: SSL-Verification of the message MAC failed (-29056) means TLS could not authenticate the received data. The standard PS2BUILD target includes corrections for an undersized socket receive-metadata buffer and stale head/tail copies after nonblocking reads. If an older updater fails this way, install the rebuilt ELF manually before testing updates again. Certificate-chain and console-date errors are separate checks; certificate verification remains required.

Good bug report

  • Exact commit/build and package or packed ELF SHA-256.
  • Console model and video mode.
  • Source device/backend and filesystem.
  • Minimal reproduction steps.
  • Whether classic browser and dashboard differ.
  • For Neutrino/POPStarter, external-core version and resolved path.

Clone this wiki locally