Get Glyph
Warning This documentation is still a work in progress. Some details may be out of date depending on the version of Glyph you are using, but it is being actively reviewed and improved.
Documentation AI Assistant Development Licensing

Documentation

License Activation

How to activate your Glyph license key

After purchasing Glyph from Gumroad, you’ll receive a license key that unlocks the app on all your devices.

Activation Process

Purchase from Gumroad

Buy Glyph from Gumroad . You’ll receive your license key immediately via email.

Open Glyph

Launch the official Glyph binary you downloaded from GitHub Releases .

Enter your license key

You can activate through any of these methods:

  • Click Enter License Key in the trial banner (during trial)
  • Use the lock screen after trial expiration
  • Navigate to Settings → General → License
  • Use command palette: Manage license

Verify with Gumroad

Glyph sends your key to Gumroad’s verification endpoint:

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

This requires an internet connection for the first activation only.

Activation complete

Once verified, Glyph stores a local activation record and unlocks permanently. You can now use Glyph offline forever on this device.

Verification Flow

Glyph verifies license keys directly against Gumroad using the product ID configured for official builds:

  • Verification endpoint: POST https://api.gumroad.com/v2/licenses/verify
  • Required fields: product_id and license_key
  • Success rule: Activation succeeds only if Gumroad returns success: true

What Gets Stored Locally

Glyph does not store your raw license key on disk. Instead, it stores:

  • Masked license key (e.g., ABCD-****-****-WXYZ) for display only
  • Key hash (SHA-256) for verification
  • Activation timestamp when you first activated
  • Trial timestamps (if you started a trial first)

This data is stored in:

app_config_dir()/license.json

Info

Your raw license key is never written to disk for security reasons.

Offline Behavior

After Gumroad verifies your key once:

  1. Glyph stores a local activation record
  2. Glyph continues working offline forever on that installation
  3. No periodic online rechecks are required
  4. You can reinstall on unlimited devices

Warning

This is an honest-user licensing model, not DRM. If you modify or delete the license file, you’ll need to reactivate with internet access.

Multiple Devices

Your Glyph license has:

  • No device limits - Install on as many computers as you need
  • No seat counting - Use simultaneously on multiple machines
  • No device fingerprinting - Hardware changes won’t invalidate your license
  • No activation caps - Reinstall unlimited times

Activation from Settings

If you’re already using Glyph, you can activate from Settings:

  1. Open Settings → General → License
  2. View your current license status (Trial Active, Trial Expired, Licensed, Community Build)
  3. Enter your license key in the input field
  4. Click Activate
  5. Wait for Gumroad verification (requires internet)
  6. Success! Glyph is now unlocked

Removing Local Activation

If you need to clear your local activation record:

  1. Open Settings → General → License
  2. Click Remove Local Activation
  3. Your trial state will be restored (if trial is expired, you’ll see the lock screen)
  4. You can reactivate with your license key anytime

Info

Removing local activation does not invalidate your license key. You can always reactivate with the same key.

Next Steps