Troubleshooting
The common fixes, ordered roughly from "won't start" to "a feature isn't behaving."
Ask in the yeon Discord. Describe what you did and what you saw, and someone will help.
yeon won't open
Windows may show "Windows protected your PC" when you run the installer — SmartScreen's standard notice for a build delivered directly rather than through the Microsoft Store. Click More info, then Run anyway.
If yeon installed but nothing happens when you launch it, open it from the Start Menu or the
Desktop shortcut the installer created. If you are running the portable .zip instead, install
with yeon-<version>-windows-x64-setup.exe — that is the supported path. Full walkthrough:
Install & first run.
On the first launch, macOS may say "yeon" cannot be opened or "yeon" is damaged and can't be opened. This is not a broken download — it is macOS's standard block on apps delivered outside the App Store. Clear the flag once by opening Terminal and running:
xattr -dr com.apple.quarantine /Applications/yeon.app
Then open yeon again. If nothing happens at all on launch, make sure you moved the app into your
Applications folder rather than running it from the .zip or Downloads. Full walkthrough:
Install & first run.
License or activation errors
If the activation screen refuses your key, the message tells you why — a typo, an expired or revoked key, a key meant for a different product, or too many devices already using it. Your first activation also has to happen online.
The full list of messages and what each one means is on Licensing & activation. If you believe a key should be working, check it with the license bot in Discord — see License bot commands.
A proxy won't connect
If an identity can't load pages, or its location looks wrong, the proxy is the usual culprit:
- Check the proxy details. A small mistake in the host, port, username, or password stops it connecting. Re-paste the line and confirm each part.
- Confirm the proxy is alive. Proxies expire or run out of data. Try the proxy in your provider's dashboard, or switch this identity onto a different proxy.
- Give it a moment, then retry. Some proxies are briefly slow to establish. Reload the page or switch proxies and try again.
yeon lines up each identity's time zone and location with where its proxy exits, so if those look off, it is a strong sign the proxy itself is the problem rather than yeon. Full details: Proxies & rotation.
Autofill isn't filling
If pressing CmdCtrlShiftF does nothing, run through these:
- Load your personas first. Autofill needs details to fill. Import them from a spreadsheet — see Importing profiles & accounts — so the identity has a persona to draw from.
- Click into the form first. Autofill fills the form you have focused. Click a field on the page, then press the shortcut.
- Check the shortcut. The fill shortcut is CmdCtrlShiftF out of the box. You can view or change it on the Custom keybinds page.
The complete setup is on Persona autofill.
OTP codes aren't arriving
Automatic one-time-passcode filling only works once its source is connected — the email inbox (AYCD or IMAP) or SMS provider the codes come from. Confirm you have entered those keys in Settings → Identities, and that each identity has its phone number set for SMS codes. Everything you need is on OTP autofill.
Two identities look linked, or state seems to leak
Each identity keeps its own cookies, logins, and storage, so a website normally cannot connect two of them. When they do look linked, it is almost always one of these:
- They share an IP address. If two identities browse from the same proxy (or with no proxy), a site can tie them together by network alone — nothing in the browser required. Give each identity its own proxy with a different exit IP. This is the single biggest lever. See Proxies & rotation.
- It wasn't actually a new identity. A normal new tab stays inside the current identity and shares its logins. To get a genuinely separate identity, open one with CmdCtrlShiftY or from the launcher. See Identities & profiles.
For the small number of sites that look hard at the physical device, the most effective step is giving each identity its own clean proxy — ideally a residential one — with its own exit IP. On a fresh IP, an identity stands on its own.
Live timers or queue position update slowly
For time-critical ticketing, keep that identity's tab in the foreground. A tab left in the background can update more slowly than the one you are looking at. You can still watch the cart timer and queue position from the tab title — see Tab-title live status.
Related
- Install & first run — setup and the first-launch OS warning.
- Licensing & activation — every activation message explained.
- Proxies & rotation · Identities & profiles — the two keys to keeping identities separate.
- Persona autofill · OTP autofill — feature setup.