Install Asomium

1. Download

When the public DMG goes live it’ll be a notarized .dmg — Apple has signed off on it so Gatekeeper passes silently on first launch.

2. Install

1. Open the downloaded Asomium-1.2.2-build35.dmg
2. Drag Asomium.app to your Applications folder
3. Eject the DMG (Cmd-E in the Finder sidebar)
4. Launch Asomium from Applications or Spotlight

The first launch may show a brief “verifying” dialog while macOS checks the notarization ticket. After that, the app opens normally — no “unidentified developer” warning.

3. Activate your license

When you buy from asomium.com/#pricing, Lemon Squeezy emails a license key (format XXXX-XXXX-XXXX-XXXX) to the address you used at checkout. To activate it:

1. Open Asomium
2. ⌘, to open Settings (or Asomium → Settings… in the menu bar)
3. Pick the Subscription tab
4. Paste your license key into the License key field
5. Click Activate

You should see “Activated. Welcome.” and the Current plan card swap to your tier:

• Pro Monthly → shows “Pro · Renews on <date>”
• Pro Annual → shows “Pro · Renews on <date> (annual)”

If you ever change Macs, sign out on the old machine first (Settings → Subscription → Sign out + deactivate this Mac) — that frees the activation slot on Lemon Squeezy’s side. Then paste the same key on the new Mac.

4. Connect App Store Connect

Asomium needs your ASC API key to read and write your app’s metadata. The key lives in your Mac’s Keychain — Asomium never sends it anywhere except api.appstoreconnect.apple.com directly.

1. Settings → ASC tab
2. Paste your Key ID, Issuer ID, and the contents of your AuthKey_<KEYID>.p8 file
3. Click Test connection — you should see a green check + your team’s apps in the sidebar

Need to mint an ASC key? Apple’s docs: How to generate App Store Connect API keys. The key must have App Manager role or higher.

5. AsoAI is already wired

AsoAI — Asomium’s AI for translations, ASO audit, keyword suggestions and revenue analysis — is bundled with your subscription. There is no key for you to add, no Anthropic / OpenAI account to set up, and no per-call cost on your side. Just activate your license and the AI features light up.

6. Updates

Asomium checks for updates on launch via Sparkle. New versions appear in a non-blocking sheet — Skip, Remind Me Later, or Install Update. Updates verify against an Ed25519 signature before installing, so a hostile mirror can’t slip a tampered build past the auto-updater.

You can also trigger an update check manually: Asomium → Check for Updates… in the menu bar.

Troubleshooting

Problem	Fix
Update Error on first Check for Updates	DNS cache lag for updates.asomium.com — run sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder, retry
”LS rejected the key” on activate	Check for stray whitespace in the pasted key; the LS API rejects keys that don’t match exactly
Activation count exceeded	License was already activated on another Mac and not signed out. Sign out there, or release the seat via your Lemon Squeezy account
ASC test connection fails	Verify the Key ID + Issuer ID match the .p8 you uploaded — Apple’s dashboard shows both alongside the key

Stuck? Email info@nativefirstapp.com.