yeon

Install & first run

yeon runs on Windows (x64) and on Apple Silicon Macs — the M1, M2, M3, M4 and M5 families, including Pro / Max / Ultra.

Apple Silicon only, for now

The macOS build does not run on older Intel Macs. If you are not sure which Mac you have, open the Apple menu → About This Mac; if the Chip line says "Apple M1/M2/M3/M4/M5" you are good.

1. Download yeon

Your download link comes from the yeon Discord. Join, get your license key (see Licensing & activation), and download the latest build for your platform.

You will get yeon-<version>-windows-x64-setup.exe — a normal Windows installer, and the recommended way in. A portable .zip is also published as a fallback; it unzips to a folder of runtime files instead of installing.

You will get a .zip. Double-click it to unzip, and you will have yeon.app.

2. Install it

  1. Run the installer

    Double-click yeon-<version>-windows-x64-setup.exe. This is a per-user install — it needs no administrator rights and raises no UAC prompt.

  2. Choose the folder

    The installer offers %LOCALAPPDATA%\Programs\yeon. Keep it, or pick another folder on that page.

  3. Finish

    On the last page, leave the Launch yeon checkbox on to open the browser straight away.

The installer creates a Start Menu shortcut and a Desktop shortcut, registers yeon in Settings → Apps so you can uninstall it from there, and registers the yeon:// link handler that makes quicklinks open.

Installing over an existing yeon upgrades it in place.

Drag yeon.app into your Applications folder — that is where macOS expects apps to live, and it keeps yeon updating cleanly.

Then open yeon from Applications or Launchpad, or run:

open -a yeon

3. If your OS warns you

Because yeon is delivered directly to you rather than through the Microsoft Store, Windows may show "Windows protected your PC" when you run the installer. If you see it, click More info, then Run anyway.

Because yeon is delivered directly to you (not through the Mac App Store), macOS marks it as "downloaded from the internet" and may refuse to open it, saying "yeon" cannot be opened or "yeon" is damaged and can't be opened. Clear that flag once and you are done.

Open the Terminal app (find it with Spotlight — press CmdSpace and type "Terminal"), then paste this line and press Return:

xattr -dr com.apple.quarantine /Applications/yeon.app
What that command does

It only removes the "quarantine" tag macOS puts on downloaded apps, so Gatekeeper stops blocking yeon. It does not change anything else on your Mac. Some builds are pre-approved (notarized) and skip this step entirely — if yeon opens on the first double-click, you can ignore this.

4. Activate your license

The very first time yeon opens, it shows a license screen. Paste in your key and click Activate. Once it is accepted, yeon unlocks and drops you on a fresh new-tab page.

Where keys come from, what happens if you are offline, and what each message means are on the Licensing & activation page.

yeon's activation screen: the yeon wordmark, the text 'This browser is locked until you activate a license', a License key field and an Activate button
Paste your key and click Activate to unlock the browser.
Optional: automatic sign-in codes

To let yeon fill one-time sign-in codes for you, there is a one-time setup in Settings → yeon → Identities, where you enter your email (AYCD or IMAP) and SMS-provider keys. Everything else works without it — see OTP autofill.

Where your data lives

%LOCALAPPDATA%\yeon\User Data
~/Library/Application Support/yeon

That is a different path from the app itself, so installing or updating never touches it. Your license, your identities and their saved sessions, and your imported accounts all live there.

Keeping yeon up to date

yeon checks for updates in the background at startup and every 6 hours, and shows an in-app notice with an Update now button. The notice names the version it is offering — "yeon 0.4.70 is available", for example. Update now downloads and installs that version and restarts yeon for you; it does not just send you to a download page. Dismissing the notice snoozes it for 6 hours.

You can also update on your own schedule: open chrome://yeon-license, go to the Updates section, and use Check for updates / Install update.

Updates are license-checked and hash-verified. On Windows the update re-runs the installer silently — no setup pages, no prompts — or, if you are running the portable .zip build, swaps the files in place instead. On macOS it replaces the app. Either way your license, identities, sessions and imported accounts are untouched.

You can also update by hand — drag the new yeon.app over the old one in Applications.

Troubleshooting the install

"Windows protected your PC"

Windows SmartScreen on a directly-delivered build. Click More info, then Run anyway.

A quicklink doesn't open yeon

The yeon:// handler is registered by the installer. If you are running the portable .zip, install with yeon-<version>-windows-x64-setup.exe instead.

"yeon" cannot be opened

macOS is still quarantining the app. Re-run the xattr command in step 3, making sure the path matches where you put the app (/Applications/yeon.app).

"yeon" is damaged and can’t be opened

Same quarantine flag — the xattr command in step 3 fixes it. It does not mean the download is actually broken.

Nothing happens on launch

Make sure you moved the app into Applications and are not running it from inside the .zip or the Downloads folder.

More fixes are on the Troubleshooting page.