Troubleshooting Guide
TotalRecalls is engineered to be resilient across eight different AI vendor platforms. When an unexpected connection pause or download interrupt occurs, consult the proven recovery steps below.
1. Provider Sign-In Window Closes or Returns Empty
- Embedded Window vs. Default Browser: TotalRecalls uses an isolated, secure embedded Chromium runtime on your machine to capture session tokens. Sign in directly inside that window — the app does not and cannot read cookies or passwords from your default Chrome, Edge, or Firefox browser.
- Cloudflare Verification Challenges: Providers like Perplexity and Claude often present Cloudflare Turnstile or CAPTCHA verification challenges during sign-in. If a challenge appears, complete it interactively inside the window and wait 3–5 seconds until the provider dashboard renders before closing.
- Blank Window on Launch: If the login window opens blank or fails to render, close TotalRecalls and reopen it. The app automatically scans for and terminates orphaned background browser instances on startup.
- Forcing a Fresh Session: Click Disconnect next to the provider name in the app, then click Connect again to purge expired cached cookies and launch a fresh sign-in dialog.
2. "Servers Are Busy — Retrying" During Large Exports
When extracting hundreds or thousands of historical conversations, provider APIs (notably ChatGPT and Perplexity) occasionally issue HTTP 429 rate-limit warnings or 503 gateway timeouts.
- Automatic Exponential Backoff: Do not abort the run. TotalRecalls features an automatic retry queue with intelligent backoff pacing. The app will hold your progress, wait for the provider's cooldown window to clear, and resume smoothly from the exact last saved conversation.
- Incremental Refresh: If you stop an export early, running it again will not redownload existing conversations. The app compares remote timestamps against your local metadata manifest and downloads only new or modified conversations.
3. Google Takeout Gemini Import Hurdles
- Extract the Archive First: TotalRecalls reads uncompressed directory structures. If you import
directly from
takeout-2026.zip, the file picker cannot parse the contents. Right-click the ZIP in Windows Explorer, select Extract All, and point TotalRecalls to the extracted folder. - Nested Takeout Folder Hierarchy: Select either the root
Takeout\folder or the nestedTakeout\Gemini\(orTakeout\Bard\) directory. TotalRecalls recursively traverses all subdirectories to locate your JSON and HTML chat dumps.
4. License Activation Key Errors
- Key Format: Pro license keys follow the format
TR-XXXXXXXX-XXXX-XXXX. Smart Search Engine keys followSSE-XXXXXXXX-XXXX-XXXX. Ensure you enter your Downloader key into the Downloader app. - Clipboard Whitespace: When pasting your key from email, ensure no trailing spaces or newline characters were copied before clicking Activate.
- One-Time Internet Connection: License activation requires an active internet connection to communicate with our secure verification endpoint once. Once activated, the app operates 100% offline.
5. Smart Search Engine (SSE) First-Run Indexing Notice
When launching the Smart Search Engine add-on for the first time across a large library (1,000+ conversations), local vectorization and embedding generation runs entirely on your local CPU. This initial process takes between 5 to 15 minutes depending on your processor. Do not close the terminal window while the progress bar advances; subsequent searches launch instantly.
Still Need Assistance?
Our engineering team is available directly at support@totalrecalls.app. Include your Windows version and provider name for priority diagnostic assistance.