Troubleshooting

Possible causes:

• Typo in the license key
• Copying extra spaces or characters
• Using a key from a different product
• Internet connection problems preventing Gumroad verification

Solutions:

1. Copy the key again from your Gumroad purchase email
2. Paste directly - don’t type it manually
3. Check for spaces - remove any leading/trailing spaces
4. Verify internet connection - activation requires online access
5. Try the key on Gumroad - verify it’s valid at gumroad.com/library

This usually means a network issue.

Solutions:

1. Check internet connection - can you browse the web?
2. Disable VPN temporarily - some VPNs block Gumroad API
3. Check firewall settings - ensure Glyph can access api.gumroad.com
4. Try a different network - mobile hotspot, different WiFi, etc.
5. Wait and retry - Gumroad API might be temporarily down

Network requirements:

Glyph needs to reach:

POST https://api.gumroad.com/v2/licenses/verify

Possible causes:

• Empty license key field
• Already submitting (button disabled during verification)
• JavaScript error in the app

Solutions:

1. Ensure key is entered - paste your license key in the input field
2. Wait for current attempt - if “Verifying…” is shown, wait
3. Restart Glyph - close and reopen the app
4. Check for app updates - download the latest version from GitHub Releases
5. Open browser console - check for JavaScript errors (Cmd/Ctrl+Shift+I)

This shouldn’t happen, but if it does:

Solutions:

1. Restart Glyph - close completely and reopen
2. Check Settings - go to Settings → General → License to verify status
3. Look for activation timestamp - if present, you’re licensed
4. Hard refresh the UI - Cmd/Ctrl+R if in dev mode

If the problem persists after restart, report it on GitHub Issues .

Possible causes:

• Clock or time zone issues
• Leftover license file from previous installation
• System time was changed

Solutions:

1. Check system time - ensure your computer’s clock is accurate
2. Check time zone - verify it matches your location
3. Fresh install:
   • Quit Glyph completely
   • Delete app_config_dir()/license.json
   • Restart Glyph for a fresh trial
4. Or skip trial - enter your license key immediately

This happens when:

• System clock was changed after trial started
• Computer was asleep near trial expiration

Solutions:

1. Restart Glyph - should show lock screen if expired
2. Check system time - ensure clock is accurate
3. Enter license key - activate to bypass trial

Actually, you can! The trial starts based on local system time and doesn’t require internet.

If you’re seeing a lock screen immediately:

1. Your trial might have already been used on this device
2. Check app_config_dir()/license.json for existing trial timestamps
3. Delete the file for a fresh trial (if legitimate)
4. Or enter your license key to activate

License data is stored in:

app_config_dir()/license.json

Platform-specific paths:

• macOS: ~/Library/Application Support/com.glyph.app/license.json
• Windows: %APPDATA%\com.glyph.app\license.json
• Linux: ~/.config/com.glyph.app/license.json

Symptoms:

• Can’t activate even with valid key
• Trial state is weird (negative time, wrong dates)
• Lock screen appears incorrectly

Solutions:

1. Delete the license file:
   • Quit Glyph
   • Navigate to app_config_dir()/license.json
   • Delete the file
   • Restart Glyph
2. Reactivate - enter your license key again
3. Fresh trial - if you deleted the file before activating, you get a new 48-hour trial

For developers/testers:

1. Quit Glyph
2. Delete app_config_dir()/license.json
3. Restart Glyph
4. New trial starts

Note: This only works with official builds. Development builds skip licensing entirely.

Symptoms:

• Activation fails with network errors
• “Failed to verify license key” message
• Works on other networks

Solutions:

1. Check Gumroad status - visit gumroad.com to see if it’s accessible
2. Wait and retry - API might be temporarily unavailable
3. Try different network - mobile hotspot, different location
4. Contact support - if Gumroad is down for extended period, report to GitHub Issues

Symptoms:

• Activation fails on corporate/school networks
• Works on mobile hotspot
• Other apps can access internet

Solutions:

1. Whitelist Gumroad domains:

   api.gumroad.com
   gumroad.com

2. Try different network - activate on home/mobile network
3. Contact IT - ask them to allow Gumroad API access
4. Activate elsewhere - use a different network just for activation, then use offline

The same key should work everywhere.

If it’s failing:

1. Check internet connection - second device needs online access for first activation
2. Copy key carefully - ensure no extra characters or spaces
3. Verify it’s the same product - confirm purchase is for Glyph
4. Check Gumroad purchase - log into gumroad.com/library to confirm
5. Contact support - if key works on one device but not another, report it

There is NO device limit! You can use your license on:

• Unlimited computers
• All platforms (Mac, Windows, Linux)
• Simultaneously

If you’re seeing errors about device limits, this is a bug. Report it on GitHub Issues .

This means GLYPH_OFFICIAL_BUILD=1 was set during build.

Solutions:

1. Don’t set the official build flag - it’s only for release builds
2. Rebuild without the flag:

   # Don't do this for dev builds:
   # GLYPH_OFFICIAL_BUILD=1 pnpm tauri build
   
   # Do this instead:
   pnpm tauri dev    # for development
   pnpm tauri build  # for personal builds

3. Check CI configuration - ensure you’re not using the release workflow

Check in the app:

1. Open Settings → General → License
2. Look at the build indicator:
   • Official Release - requires license
   • Community Build - no licensing

Community builds:

• Don’t show trial banner
• Don’t show lock screen
• Don’t have license settings

Report the issue:

1. Go to GitHub Issues
2. Open a new issue with:
   • Error message (exact text)
   • Steps you tried from this troubleshooting guide
   • Platform (Mac/Windows/Linux)
   • Glyph version (from Settings → About)
   • Network environment (home/corporate/VPN/etc.)
3. Don’t include your license key in the issue!

The community and maintainers will help you resolve it.

Check these places:

1. Email - search for “Gumroad” in your inbox
2. Gumroad Library - log in at gumroad.com/library
3. Gumroad account - check your purchase history

Still can’t find it?

Contact Gumroad support (not Glyph support) - they handle purchase records and can resend your key.