Document GUI backend requirement and handle missing backend

This commit is contained in:
thePR0M3TH3AN
2025-07-19 12:16:30 -04:00
parent 6855c85329
commit 70e05970f0
6 changed files with 47 additions and 0 deletions

View File

@@ -241,6 +241,11 @@ python -m seedpass_gui
seedpass-gui
```
Install a platform-specific BeeWare backend before running these commands. Only
the headless `toga-dummy` backend is bundled for tests. Linux users should
install `toga-gtk`, Windows users need `toga-winforms`, and macOS users require
`toga-cocoa`.
The GUI works with the same vault and configuration files as the CLI.
```mermaid
@@ -555,6 +560,10 @@ If the checksum file is missing, generate it manually:
python scripts/update_checksum.py
```
If SeedPass prints a "script checksum mismatch" warning on startup, regenerate
the checksum with `seedpass util update-checksum` or select "Generate Script
Checksum" from the Settings menu.
To run mutation tests locally, generate coverage data first and then execute `mutmut`:
```bash