Skip to content

Add startup recovery mode for broken configuration #122

Description

@rowkav09

Goal

Let beta users recover from a bad configuration without repeatedly crashing at startup.

Bounded scope

  • detect repeated startup failures before provider polling begins
  • offer a safe mode that disables network polling, Discord IPC and automatic updates
  • preserve the current configuration and identify the failing subsystem without echoing secrets
  • provide actions to open settings, export diagnostics or retry normal startup
  • clear the failure counter after a confirmed healthy start
  • add tests for crash-loop detection, safe-mode isolation and recovery
  • document the flow in the troubleshooting guide

Done when

After repeated startup failures, the app opens in a usable offline recovery state and the user can diagnose or fix the installation without editing files by hand.

Activity

  1. rowkav09 commented on Sep 23, 2026

    @rowkav09
    MemberAuthor

    Status:

    • Done: startup recovery state core, covering crash-loop detection and failing-subsystem tracking (feat: add startup recovery state core #181)
    • Remaining: wire it into Windows startup (safe mode that turns off polling, Discord and updates), tray actions (open settings, export diagnostics, retry), and troubleshooting docs.
  2. moved this to Todo in nowplayingon Sep 23, 2026
  3. rowkav09 commented on Sep 24, 2026

    @rowkav09
    MemberAuthor

    Status: the crash-loop guard is merged (#317). It's wired into the Windows start in #322: safe mode skips Discord and hosted uploads, "Run setup again" retries a normal start, and there's a troubleshooting doc section. Left for "done when": check that safe mode also turns off automatic updates, and that safe mode offers "export diagnostics" and "open settings" (the status page from #279 and #318 could host these). Then close.

  4. moved this from Todo to In Progress in nowplayingon Sep 24, 2026
  5. moved this from In Progress to Done in nowplayingon Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions