Hi, I'm YellowMiso.

Look at your Mac. It unlocks. That's it.

A free little app that recognizes your face and types your password for you, so you don't have to.

Free · for Macs with Apple silicon · everything stays on your Mac

Why you'll like it

Less typing. More looking.

👀
Just look

Open your Mac and glance at it. It unlocks in a second or two. Your password and Touch ID still work, always.

🔒
Private by design

No account, no internet, no cloud. Your face and password never leave your Mac.

🚶
Walks away with you

Step away and it locks itself. Come back and it unlocks. Like a watch, without the watch.

😷
Made for real life

Dim rooms, glasses, even a mask: teach it each look once and it recognizes you.

🖥️
Great for desk Macs

Mac mini, iMac, Mac Studio, or a laptop closed at your desk: no Touch ID button? No problem.

🎁
Free

No subscription, no ads, no strings.

How it works

Three steps. About three minutes.

1
Say hello

Install it, let it see your face for a minute, and enter your Mac password once. It's stored encrypted, only on your Mac.

2
Lock like always

Press ⌃ ⌘ Q, close the lid, or walk away. Nothing new to learn.

3
Look at it

YellowMiso recognizes you, checks that you're a real person and not a photo, types your password, and you're in.

Ready when you are

Download YellowMiso for Mac

Download YellowMiso
Version 1.1 · about 13 MB · macOS 15 or newer · Apple silicon (M1 and later)
SHA-256: loading…

Want the most accurate recognition? Get the full version (about 90 MB, adds a second, larger face model). Faces you set up work in either one.

Friendly heads-up: macOS will ask you to confirm the first time YellowMiso isn't from the App Store and isn't notarized by Apple (that costs $99 a year), so macOS shows a warning when you first open it. It's a one-time right-click → Open, and the steps below show exactly where to click.
Let's be honest about the limits

YellowMiso is a convenience, not a vault. It uses your Mac's ordinary webcam, not the special hardware behind Face ID, so it's not as secure as Face ID or Touch ID. It works hard to tell a real face from a photo or a phone screen, but no camera-only check is perfect: a very good replay, a deepfake or a lookalike may still get in. Use it to save time, keep a strong password, and don't rely on it to protect something a determined person wants.

Try it in 2 minutes

  1. Install: open the .dmg, drag YellowMiso to Applications, then right-click → Open the first time (steps below).
  2. Set up: allow Camera and Accessibility, enroll your face (about a minute), enter your Mac password.
  3. Check it: open Settings → Status. Everything should be green. Press Run test: it looks at you and reports the match score and a live-face score, without typing anything.
  4. Lock and unlock: press ⌃ ⌘ Q and look at the camera. Your Mac unlocks itself in a second or two. Your password and Touch ID still work as normal.
  5. Optional: in Settings → General, switch on Lock when I walk away, step away, and come back.

What you need

Install

  1. Download and open the disk image Click Download for Mac above. When YellowMiso.dmg finishes, double-click it (it's in your Downloads folder). A window opens with YellowMiso and a shortcut to Applications.
  2. Move it to Applications Drag YellowMiso onto the Applications shortcut. Do this before opening it, so it stays in one place. You can then eject the disk image.
  3. Open it the first time (the macOS warning) Double-clicking may say YellowMiso "cannot be opened" or that Apple could not check it for malware. Do this instead:
    • Open Applications, right-click (or Control-click) YellowMiso, choose Open, then click Open in the box.
    • If there is no Open button, go to System Settings → Privacy & Security, scroll down to the message about YellowMiso, click Open Anyway, and enter your password.
    • If macOS says the app is "damaged", open Terminal (Applications → Utilities), paste this line, and press Return:
      xattr -dr com.apple.quarantine /Applications/YellowMiso.app
      Then open YellowMiso again.
    You only need to do this once.

Set it up (about 3 minutes)

YellowMiso opens as a small panel at the top of your screen (around the notch, or a pill on Macs without one) and walks you through these screens, in order.

  1. Intro Click Next.
  2. Permissions Grant both, then Next becomes available.
    • Accessibility: lets YellowMiso type your password on the lock screen. Turn it on in System Settings → Privacy & Security → Accessibility.
    • Camera: click Allow when macOS asks.
    If the Accessibility switch is already on but the step doesn't turn green, quit and reopen YellowMiso once.
  3. Security notice Read it, then click I understand. (No thanks exits setup.)
  4. Set up Face Recognition Click Next.
  5. Select camera Pick the camera to use, then Next.
  6. Enroll your face Sit about an arm's length from the screen in good light and follow the on-screen directions: look straight ahead, then turn your head slowly toward each highlighted direction and hold until it lights up. It takes about a minute. Don't wear a mask for this first one.
  7. Name this face Type any name, for example your first name.
  8. Enter your password Type your Mac's login password and click Confirm. macOS also asks you to confirm with Touch ID or your password once. The password is encrypted and stored only on your Mac. YellowMiso never sends anything over the internet.
  9. Done A menu-bar icon appears (top right of the screen). Settings open from there.
If you ever change your Mac password YellowMiso will type the old one and fail. Open the YellowMiso menu-bar icon → Settings → Password and change the saved password.

Use it

  1. Lock your Mac Press ⌃ ⌘ Q, use → Lock Screen, close the lid, or let it sleep.
  2. Look at the camera A small panel drops from the top of the screen and scans. When it recognizes you, it types your password and your Mac unlocks. This usually takes one or two seconds.
  3. If it doesn't recognize you It tries again on its own, up to 10 times. You can also press Space on the lock screen to start a fresh set of tries. After 10 failures it turns face unlock off until you sign in with your password or fingerprint; once you do, it asks for Touch ID (or your password) to switch back on.
  4. You can always use your password or Touch ID Nothing YellowMiso does changes the normal ways to unlock.

Keep it running all the time

YellowMiso can only unlock while it's running. Open it from the menu-bar icon → Settings → General and turn on Launch at login. If your Mac restarts, it starts by itself once you log in the first time. Until then you must use your password, since macOS asks for it after a restart anyway.

Settings guide

WhereWhat it does
General → Enable Face UnlockMaster switch.
General → TriggersWhen a scan starts: On wake (screen turns on), On lock (screen locks), On space (you press Space).
General → Display onWhich screen shows the panel.
General → Retry on notch hoverHover the panel to try again.
General → Face detection durationHow many seconds one attempt looks for you.
General → Lock when I walk awayOff by default. When on, the Mac locks itself after you've been away for the delay you choose (30 seconds to 5 minutes), and your face unlocks it when you come back. It takes a brief look through the camera every few seconds while you're idle, so the camera light blinks. It never locks during video or presentations.
General → AnimationShow the unlock animation, and pick its style.
StatusA checklist of everything face unlock needs, and a Run test button that checks recognition and the fake-face score without typing anything.
FaceYour enrolled faces. Add another (+), recapture, delete, switch one off, or mark it as Wearing a mask.
PasswordChange the saved password, lock or unlock the session, set how long before it auto-locks.
CameraChoose which camera to use.
RecognitionHow strict matching is and the fake-face (liveness) checks.

Wearing a mask or glasses

A single profile can't be right for every look, so enroll separate ones.

  1. Put the mask on (or your glasses) and go to Settings → Face.
  2. Click + (Enroll another face), name it (for example "Mask"), and go through the same steps.
  3. For a mask profile: switch Wearing a mask on for that face. It is matched a bit more leniently (a match score 0.10 lower), because a mask hides most of what tells people apart.

More leniency also means a wrong person is slightly more likely to be accepted while that profile is on. Switch the profile off in Settings → Face if you don't want that.

Troubleshooting

Nothing happens when I lock the screen
  • YellowMiso must be running (menu-bar icon visible). Open it from Applications.
  • Check Settings → General → Enable Face Unlock is on and a trigger is selected.
  • Check Camera and Accessibility are both allowed for YellowMiso (System Settings → Privacy & Security).
  • If you lock the session yourself (menu-bar icon → lock), face unlock stays off until you unlock it with Touch ID or your password.
It recognizes me but doesn't unlock (or the panel says it worked but the Mac stays locked)

That means macOS isn't letting YellowMiso type. Open System Settings → Privacy & Security → Accessibility, select YellowMiso, click − to remove it, click + and add it again from Applications, switch it on, then quit and reopen YellowMiso. Do this whenever you replace the app with a new version.

It doesn't work in the dark

YellowMiso brightens dark camera images, but a nearly black room still gives the camera too little to see. A little light on your face (even a dim lamp) helps a lot.

It says "Screen glare detected" or won't accept me

Bright light behind you or on glasses can look like a screen to the fake-face check. Face the camera, avoid strong backlight, and retry. You can also enroll another profile for that lighting (Masks section above works the same way).

macOS asks to let YellowMiso access a Keychain item

Enter your login password and choose Always Allow. Current versions store their secrets in a private file instead and shouldn't ask.

Where are the logs?

YellowMiso writes a plain-text step log to:

~/Library/Application Support/YellowMisoUnlock/unlock.log

It records what happened on each attempt (matched, typed the password, retries, failures). It never contains your password, face images or keys. Send it when asking for help.

Uninstall

  1. Quit YellowMiso from its menu-bar icon.
  2. Delete the app: drag YellowMiso from Applications to the Trash.
  3. Remove saved data (your face data and encrypted password), in Terminal:
    rm -rf ~/Library/Application\ Support/YellowMisoUnlock
  4. Remove permissions (optional): System Settings → Privacy & Security → Accessibility and Camera → remove YellowMiso. Also turn off Launch at login if it's still listed under General → Login Items.

Questions

You might be wondering…

Does my face or password get sent anywhere?

No. YellowMiso has no network code at all. Recognition runs on your Mac using models bundled inside the app, and your data lives in one folder on your Mac that you can delete anytime.

What if it doesn't recognize me?

It tries again on its own, up to 10 times. If it still can't, just type your password or use Touch ID as you always do. The Status tab in Settings tells you what's wrong and lets you test recognition.

Will it work in the dark, or with glasses or a mask?

It brightens dim images and handles most lighting. For glasses or a mask, add another face profile wearing them (Settings → Face → +), and switch on "Wearing a mask" for a mask profile. Nearly pitch-black rooms are hard for any webcam.

Can someone unlock my Mac with a photo of me?

YellowMiso uses a trained model plus several checks to reject photos and phone or tablet screens, but it may not stop a very good fake. See "the limits" above.

Why isn't it in the App Store?

Typing a password into the lock screen isn't something the App Store allows, and notarizing an app costs $99 a year. So it's a free download you open once with a right-click.

How do I remove it?

Quit it, drag it to the Trash, and delete the folder shown in the Uninstall section. Nothing else is left behind.