SUPPORT · START HERE

Let's get you unstuck.

Most installation, startup, and command-line problems come down to one path or a terminal that needs reopening. Start with the shortest checks below; if you are still stuck, we will continue in the public repository.

Install and update

If you installed from Microsoft Store, Windows handles installation, signature verification, and updates. Open moeSegFault Scrap from Start; do not unpack the Store package and run its files manually.

GitHub Releases provides the Windows MSI and macOS/Linux archives. Download only the asset matching your system architecture from the project release page. Ordinary upgrades preserve existing records.

Start and local service

Start the desktop app, or run scrap --help in a fresh terminal. scrapd is an on-demand local daemon; you do not need to install it as a separate service or keep it running manually.

If the app does not respond, exit the desktop app completely and retry. If it still fails, note your Scrap version, operating-system version, and the exact error text after removing sensitive content.

scrap --helpscrap scope list

Where your data lives

Records and runtime state live under ~/.scrap for the current user; on Windows this is normally %USERPROFILE%\.scrap. Ordinary upgrade or uninstall does not remove this directory.

The database is ~/.scrap/data/scrap.db and daemon diagnostics are in ~/.scrap/log/scrap.log. Never attach the database, key-reference, or an entire raw log to an issue. To remove all local data, confirm your backups first and then explicitly delete ~/.scrap.

The scrap command is not found

The Store build exposes scrap.exe through a Windows App Execution Alias, ordinarily mapped through %LOCALAPPDATA%\Microsoft\WindowsApps. Close and reopen the terminal after installation. If it is still missing, check that scrap.exe is enabled under Settings → Apps → Advanced app settings → App execution aliases. You do not need to enter the protected package directory.

The MSI normally installs to %LOCALAPPDATA%\Scrap and adds that directory to the current user's PATH. The macOS and Linux archive installers normally use ~/.scrap/bin. PATH changes become visible only to new processes.

where scrapGet-Command scrapcommand -v scrap

Still stuck?

Bring a reproducible report.

GitHub Issues is the project's support channel. Include the Scrap version, operating system, install source, shortest reproduction steps, expected behavior, and a fully redacted actual result.

Issues are entirely public. Never paste secrets, access tokens, passwords, private keys, record values, databases, raw logs, or personal data. Remove user names, host names, and private paths before posting.

If the issue itself is sensitive, first open only a fully redacted contact request with the version and broad issue category, asking the maintainer for an appropriate private channel. Do not explain sensitive details in the public issue.

Open GitHub Issues