Troubleshooting
macOS blocks the app on first launch
Section titled “macOS blocks the app on first launch”macOS builds are not notarized yet, so Gatekeeper warns on first launch. Right-click the app → Open (once), or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Lopload.appA transfer failed
Section titled “A transfer failed”Failed transfers stay visible until you act on them — that’s by design. Check that the endpoint is reachable and your credentials still have access, then retry from the transfer’s row.
The app shows “requires the desktop app” in a browser
Section titled “The app shows “requires the desktop app” in a browser”The real S3/keychain/transfer stack needs the Tauri webview. If you’re
running from source, use bun run tauri dev — bun run dev alone starts
Vite in a plain browser tab, which can’t run the app.
The app writes JSON-line logs (one object per line) to the platform’s
standard log directory, under lopload-<timestamp>.log files:
| Platform | Location |
|---|---|
| macOS | ~/Library/Logs/com.lopload/ |
| Linux | ~/.local/share/com.lopload/ |
| Windows | %LOCALAPPDATA%\com.lopload\logs |
Searching them for "ERROR" is usually the fastest way to find what went
wrong.
Still stuck?
Section titled “Still stuck?”Open an issue with what you tried and any relevant log lines (logs never contain credentials).