Troubleshooting

This page covers the most common problems you might encounter and how to resolve them.

I Forgot My Master Password

There is no password recovery. Your master password is never stored or transmitted — it exists only in your memory and is used to derive the encryption key locally. Claspt cannot reset it for you.

If you have biometric unlock enrolled (Touch ID, Windows Hello), you can still unlock your vault that way and then change your password from Settings > Security > Change Master Password.

If biometric is not enrolled and you do not remember your password:

• Your non-secret content (markdown text, titles, tags, folders) is stored as plain .md files. You can open them with any text editor or copy them out of the vault directory.
• Your encrypted secrets are unrecoverable. The enc:v1: ciphertext in each secret block cannot be decrypted without the original master key.

Caution

This is by design. Zero-knowledge encryption means nobody — not even us — can access your secrets without your password. We strongly recommend storing your master password in a separate password manager or writing it down in a secure location.

Vault Won’t Unlock

• Check Caps Lock — passwords are case-sensitive.
• Type it elsewhere first — open a text editor, type your password in the clear, verify it looks correct, then paste it into the unlock screen.
• Exponential backoff — after 5 consecutive failed attempts, Claspt introduces increasing delays between attempts. Wait for the timer to expire and try again carefully.

Search Isn’t Finding My Pages

The search index can occasionally fall out of sync, especially after importing pages or restoring from a backup.

Rebuild the index:

1. Open Settings > Utilities.
2. Click Rebuild Search Index.
3. Wait for the rebuild to complete (usually a few seconds).

Note

The search index is local-only and never synced. Each device maintains its own index. If search is broken on one device, rebuilding on that device is sufficient.

Sync Conflicts

Claspt auto-resolves most sync conflicts using a last-write-wins strategy with content merging. If a conflict cannot be auto-resolved, a conflict dialog appears showing both versions side by side.

You have three options:

Option	Effect
Keep Local	Discard the remote version and keep your local changes
Keep Remote	Discard your local changes and accept the remote version
Keep Both	Save both versions as separate pages so you can merge manually

Tip

To minimize conflicts, let sync complete before switching devices. Check the sync status indicator in the bottom-left corner — a green check mark means all changes are pushed.

App Crashes on Startup

A corrupted WebView cache can cause startup crashes. Delete the cache directory (this does not delete your vault data):

• macOS: ~/Library/WebKit/in.indivar.claspt/
• Windows: %APPDATA%/in.indivar.claspt/
• Linux: ~/.local/share/in.indivar.claspt/

Then relaunch Claspt. If the issue persists, try deleting the Caches directory as well:

• macOS: ~/Library/Caches/in.indivar.claspt/

Caution

Do not delete your vault directory (~/Claspt/ or wherever your vault is located). That contains your actual data.

Secrets Show as enc:v1:...

If you see raw enc:v1: ciphertext instead of secret cards, it means the vault is locked or the master key is unavailable.

• Unlock the vault — enter your master password from the lock screen.
• Master key mismatch — if the vault was created with a different password (e.g., you restored a backup from another device), you need the original password that was used to create the vault.key file.

Import Failed

• Check the file format — make sure the selected import type matches your file. Claspt supports CSV (1Password, Bitwarden, Chrome, LastPass) and XML (KeePass 2.x).
• CSV encoding — the file must be UTF-8 encoded. If you exported from Excel, re-save as “CSV UTF-8” explicitly.
• KeePass XML — only KeePass 2.x XML exports are supported. Older KeePass 1.x formats are not compatible.
• Preview before import — Claspt shows a preview of detected entries before committing. If the preview looks wrong, the file format likely doesn’t match.

Share Link Not Working

• Expired — share links have an expiry set at creation time. Once expired, the link returns a “not found” page.
• Revoked — the sender may have revoked the share from Settings > Sharing.
• Burn-after-reading — if the share was created with burn-after-reading enabled, it is permanently deleted after the first view.

Contact the person who shared the link to request a new one.

License Says Invalid

• Check the expiry date — go to Settings > License to see your license status and remaining days.
• Paste the new key — if you renewed your subscription, you’ll receive a new license key via email. Paste it in Settings > License > Activate.
• Clock sync — license validation checks timestamps. If your system clock is significantly wrong, it can cause validation failures.
• Contact support — if the issue persists after the above steps, email [email protected] with your license key and a screenshot of the error.