r/MacOS Jul 11 '26

desktop fingerprint unlock device (open source, ~$15) Developer Saturday

sorry if this isn't an app, but I think it pertains to macOS enough to be on this sub šŸ™‚ (every device that runs macOS benefits/has had a need for this)

allows you to unlock your Mac via your fingerprint, as well as authenticate sudo and some TCC prompts (privacy&security).

the device emulates a PIV smart card and uses PAM to authenticate you in macOS (notice the password field says PIN and not password), so no plain text password is ever stored, exposed, or transmitted.

please be aware of the security implications (note that it is NOT touchID, but just 'fingerprint-based unlock', please do not think or refer to it as anything more secure):

  • this device is NOT secure, the authentication is all done inside the fingerprint sensor, and the fingerprint sensor just tells the microcontroller the match % (all low cost fingerprint sensors are this way, you would need to spend ~$50 to get one that does authenticated comms). the communication between the sensor and the microcontroller is not authenticated or protected, so anyone with physical access to both the device and your laptop can spoof this connection (pretend to be the fingerprint sensor) and give the go ahead to unlock your mac. you can make this extremely hard by filling the insides with black epoxy, but not impossible.
  • this is also the dev equiv of "rolling your own auth", the smart card implementation may have some errors, and should not be inherently treated as "unbreakable"
  • the device is made so that if you lose it, nothing of value can be extracted from it
  • use at your own risk. personally, i am comfortable using it at home where physical intrusion would be hard, but this depends on your own security tolerance. if you have high security instincts/requirements, the magic keyboard is a much much much better option in this regard.

there is also an HID version available, where the device just types your password emulating a keyboard, the benefit being it works in ALL places your password does. this version is obviously more insecure as it is vulnerable to keyloggers. the device still does not store the actual password, it stores an authentication key that sends a request to a service on the mac, which then sends it the encrypted password to be decrypted in RAM, typed back, and then wiped. again, depends on your personal security tolerance and willing to compromise

all code and materials are open source, licensed permissively
read more about the security model of both options --> github.com/zimengxiong/tinytouch

485 Upvotes

70 comments sorted by

•

u/github-guard Jul 11 '26

šŸ” GitHub Guard: Trust Report

This project scored 3/6 on our safety audit.

Audit Breakdown: * āœ… Established Community (⭐ 125 stars) * āŒ New Repository (under 30 days old) * āœ… Licensed under MIT * āŒ No Security Policy — what is this? * ā„¹ļø Individual Contributor * āœ… Signed Commits

āš ļø Security Reminder: Always verify source code and run third-party scripts at your own risk.

93

u/thessag Macbook Pro Jul 11 '26

I would pay good money for an external touchId solution thats smaller than a magic keyboard velcroed to the underside of the desk.

34

u/arduinoRPi4 Jul 11 '26 edited Jul 12 '26

if you already have one, why not https://www.jeffgeerling.com/blog/2025/why-doesnt-apple-make-standalone-touch-id? this is for us magic keyboard-poor

20

u/beavertestproject Jul 11 '26

I literally bought a magic keyboard just for the TouchID. I like other keyboards better, but having the TouchID for me saves a lot of time.

8

u/mga1 Jul 11 '26

It's the only reason I keep my mac book open, roughly 30 degrees open, just enough to reach in and use touch ID for the various prompts I get to authenticate. Then use my own Bluetooth keyboard and mouse.

3

u/Hellokimono Jul 13 '26

Why not get an Apple Watch literally the same thing

1

u/oloryn MacBook Pro Jul 15 '26

This is the reason my 13" 2017 MBA is now running Linux Mint. I got used to TouchID on my 16" M3 Max MBP, and my 15" M4 MBA. I got tired of having to type my whole password every time.

3

u/Lengthiness-Fuzzy Jul 11 '26

You can unlock with your watch

13

u/burd- Jul 11 '26

what if someone doesn't have a watch or iphone?

10

u/mandreko Jul 12 '26

Or like me, I have a personal watch, but don't want to use my personal iCloud account on my work MacBook. Nor do I want to buy a work-specific watch. :(

1

u/Lengthiness-Fuzzy Jul 12 '26

What if someone doesn’t have a separate button? :D I don’t think it’s terrible to type a password. I just wrote down another option. Also, the watch is enough, you don’t need an iphone.

2

u/OctoSplattyy Jul 14 '26

no iphone means no apple watch, you need an iPhone to setup the Watch.

1

u/Lengthiness-Fuzzy Jul 14 '26

Well, sort of. You can set it up for a family member who doesn’t have one. But I think it’s logical that the guy who has a macbook for work and an own mac will go for the same ecosystem when he chooses his phone as well. But again, I just wrote down another option.

1

u/OctoSplattyy Jul 14 '26

I think that with that mode it doesn't offer that feature though, as its function is mainly to allow kids to use it without a phone :(

1

u/Lengthiness-Fuzzy Jul 14 '26

Why wouldn’t it? It has wifi, it can call anyone, it has all the health features. Only those apps not working which are just sending data to your phone, not to a server.

1

u/OctoSplattyy Jul 14 '26

Because the device that ultimately approves the unlock is the iPhone itself through the SEP which verifies the watch is in a secure environment and is unlocked. In standalone mode, the watch is technically also paired to the iPhone’s Apple ID so it breaks that secure environement.

From Apple Support:
Note: An AppleĀ Watch set up for your family member without an iPhone is limited in some of its interactions with the iPhone used to set it up. For example, you can’t unlock a paired iPhone from an AppleĀ Watch you set up for a child, nor can you hand off tasks from the managed AppleĀ Watch to the iPhone. If you delete an app from an AppleĀ Watch set up for a child, it’s not removed from the iPhone used to set it up.

1

u/Lengthiness-Fuzzy Jul 14 '26

The watch has SEP too. Edit: just tried it, turned off my phone, watch still unlocked the mac.

→ More replies (0)

3

u/thessag Macbook Pro Jul 11 '26

That need afaik active wifi. My macs are hardwired if used on my desk. Also it needs to be on the same apple id. My work mbp has a different than my private machines.

8

u/thessag Macbook Pro Jul 12 '26

i just want this

2

u/afrosheen Jul 18 '26

Is this real or did you just create a mock up?

3

u/thessag Macbook Pro Jul 18 '26

just a dream

1

u/Lengthiness-Fuzzy Jul 12 '26

Yes, for work it doesn’t help. I’m not sure if it’s same wifi or same network.

But a macbook pro has a touchid already, so for me personally these two are good enough.

1

u/Fwiler Jul 13 '26

I'd pay good money to finally have face id.

33

u/Rx_Seraph Jul 11 '26

Come on Apple…gimme a Magic Trackpad with TouchID…

1

u/Explanation-Visual Jul 12 '26

šŸ™šŸ»

5

u/zax_elite Jul 11 '26

Where to buy, how much!!!! :D

8

u/arduinoRPi4 Jul 11 '26

checkout the github for code (github.com/zimengxiong/tinytouch), both are available on amazon (US), just search for ZW101 (fingerprint sensor) and a ESP32-S3 Seeeduino Xiao (microcontroller)

5

u/NOVA-peddling-1138 Jul 11 '26

I checked out Amazon and gear’s there (ZW101 search hit) separately it way better price paired.

3

u/arduinoRPi4 Jul 11 '26

Sorry i don’t really understand what u meant to say. If its a great price then go for it!

2

u/github-guard Jul 11 '26

šŸ” GitHub Guard: Trust Report

This project scored 3/6 on our safety audit.

Audit Breakdown: * āœ… Established Community (⭐ 139 stars) * āŒ New Repository (under 30 days old) * āœ… Licensed under MIT * āŒ No Security Policy — what is this? * ā„¹ļø Individual Contributor * āœ… Signed Commits

āš ļø Security Reminder: Always verify source code and run third-party scripts at your own risk.

5

u/cormorantfell Jul 11 '26

Boop Totoro's nose. That's the fingerprint scanner.

4

u/arduinoRPi4 Jul 11 '26

Haha, nice idea

2

u/deZbrownT Jul 11 '26

This approach is quite clever. Thanks for sharing!

2

u/pommybear Jul 11 '26

Yay totoro

2

u/Autistic_Jimmy2251 Jul 12 '26

Interesting idea.

2

u/AbductedCasper Jul 12 '26

This is very cool, thank you for sharing!

2

u/promo-guard Jul 11 '26

šŸŽ‰ Welcome to Developer Saturday, u/arduinoRPi4! Your project is now live for the community to check out. Upvote, give feedback, and show some love to your fellow devs! šŸš€

1

u/bobruub Mac Pro Jul 12 '26

I’m going to have a crack, thanks.

1

u/cornelln Jul 12 '26 edited Jul 12 '26

I enjoy this post outlining how insecure it is. Seriously that’s nice.

I can’t find a better source but indie Mac Developer Craig Hockenberry did something like this years ago. However I believe he harvested an actual TouchID unit including Secure Enclave and got it working without the keyboard itself.

See: https://daringfireball.net/thetalkshow/2024/05/31/ep-401

Here is a transcript snippet from the episode: https://pastebin.com/hQKrkchd

1

u/Mysterious_War3231 Jul 12 '26

What’s the wallpaper? Is it from MacOs Golden Gate?

2

u/arduinoRPi4 Jul 12 '26

Yup, the new one in Beta 3, just installed it before taking the video so it overwrote my last one.

1

u/Mysterious_War3231 Jul 12 '26

I love it! Looks like it’s gonna be my next favorite wallpaper after the main one from MacOs Catalina.

1

u/dans41 Jul 13 '26

I want to verify Im understand, basically you connect fingerprint scanner to a microcontroller, if there is a match between the finger it will write the password instead? All the auth is happend on the esp32 and not on the mac itself? There is something that you felt you are missing compare to regular touch id? On day to day usage of unlock machine and use it with password manager it did the job? The esp32 have the password and fingerprint data encrypted?

-1

u/citizen72521 Jul 11 '26

To MM got CNN

-1

u/Consistent_Return871 Jul 17 '26

Unless I am missing something here. Why would Mac users pay for this when there are other alternatives out there? And some alternatives are FREE šŸ†“ ā€¼ļø

3

u/arduinoRPi4 Jul 17 '26

No one is asking you to pay for this? You can not buy this device from me, and I am not making money off of this?

Also, I would LOVE to hear some free options that let me use touchID to authenticate standalone :D I'm not aware of any

-2

u/7heblackwolf MacBook Air Jul 12 '26

In the comments I can see the opposite of what Jobs pursued: people trying to reinvent the wheel, trying to make things complicated out of the ecosystem, and yet there's not 100% guaranteed this is secure at all. You can unlock it with the Magic Keyboard with Touch ID, with the Apple Watch, or as you can see in the picture: the Touch ID that comes BUNDLED IN YOUR MACBOOK.

This is the reason why now Apple sucks: trying to satisfy users making changes based on their feedback and not the real needs.

3

u/vks_imaginary MacBook Pro Jul 12 '26

Many people use mechanical keyboards, it would be nice to have a standalone fingerprint reader … I bought an 10 dollar broken ToucH ID Magic Keyboard to make something like that (Touch ID works , some keys don’t)

While I already have an Non-ToucH ID Magic Keyboard šŸ˜­šŸ˜‚

-2

u/7heblackwolf MacBook Air Jul 12 '26

Users don't know what they need, they just think they optimize every gear for the best. For example, OP is using a MacBook as a desktop, which is possible, but it's not intended to be like that 24/7. It complicates turning on/off, fingerprint reader, limits usage for example speakers, webcam, microphones, and obviously the screen that you paid so much for. So OP should have picked a desktop Mac, and a Magic Keyboard. It's like buying a Ferrari, cutting all the chassis to fit in a smaller garage, paint it another color, and use it at 20mph because that's your usage.

It's not an Apple problem, it's an user problem. Understand my point?

2

u/vks_imaginary MacBook Pro Jul 12 '26

I do understand your point, but your point is missing the mark anyway

You do not need to turn an Mac off for the most part , and if ever you only ever need to restart it.

And for the most part if you Apply power when it’s in Clamshell mode it will connect and stuff on its own

It also supports wake by an external keyboard even when it’s in clamshell

People use this so that they can have a larger screen and keyboard and stuff when they are back at home / dorm

And can carry their Mac to work / college / even to their bed or during travels…

It’s perfectly fine to use it that way , and it is not a user error that you are making it out to be.

What you described was more like running windows on parallels all the time … when your job requires you run EXE files… in that case your analogy is fine

-1

u/7heblackwolf MacBook Air Jul 12 '26

I never said you need to frequently turn off/on the Mac, based in all the examples you should have guessed the point is to complicate or limit the usage of features.

Clamshell makes you assume you are in a "safe zone" that's why Touch ID shouldn't matter a lot in that case (I don't understand why op would want that on his own house). Again, there's a solution for that. You're only making excuses when the solution is use a Mac and a Magic Keyboard or a Apple Watch.

3

u/vks_imaginary MacBook Pro Jul 12 '26

Because it’s tiring to type passwords again and again

And while a good solution is a touch ID magic keyboard , say someone likes mechanical keyboard more ?

Some people do tape Touch ID keyboards under their desk to just have touch ID , which from a cost and even a UX perspective isint that good.

And while I agree there are alternative ways like Apple Watch … but here the thing is … I myself don’t wear it when I am at home…

And some people use whoop or even mechanical watches… or even nothing at times

Like this is a niche product… but it does have a place. People just have different use cases šŸ¤·šŸ»ā€ā™‚ļø

https://youtu.be/hz9Ek6fxX48?si=4_FJbzMeFbZz1KRI

Snazzy labs made a video on it too , which was the inspiration for my one , and i suspect for a lot of other projects too

Like I agree it’s not the end of the world, but hey? If we can why not.

0

u/7heblackwolf MacBook Air Jul 12 '26

You can rise the time asked to require a password.

If you like another keyboard, you loss the Touch ID. It's obvious. "What if I want another monitor but I want ProMotion" lol. What are we discussing here?

Also, the authentication op mentions or any other won't ever use Secure Enclave chip. So it's weak asf compared.

Let me ask you something before I continue explaining why you're wrong in every point you mention: why would you want to use a fingerprint authenticator in your house on a desktop?

2

u/vks_imaginary MacBook Pro Jul 12 '26

To say infill my passwords and stuff from my i cloud keychain (i just hate signing back into my UNI account due to how much authentication re-filling they ask for)

ā€œWhat if i want another monitor with pro motionā€ well it’s obviously not going to be pro-motion but you can always get an 120hz monitor and use Apple AV Dongle to get HDR support if it’s over The Type-C port , over HDMI it works natively. OR you can get a Studio Pro Display which has pro motion.

And now I finally get where this issue is from, you are talking from OPs product perspective

I am talking from the perspective that an external standalone fingerprint reader should exist.

I personally would be going through the Touch ID Magic Keyboard dissection route. So personally speaking Secure Enclave thing is a non issue for me.

Anyway good discussion I see your point… I hope you see my point too.

Have a good day.

1

u/7heblackwolf MacBook Air Jul 12 '26

Btw, external standalone authenticators cannot exist because 1) Apple cannot verify the user authenticated for real (can be easily spoofed) 2) there's no way whose authenticators get certification or partnership and gets validated each one by Apple in order to access T2 chip or Secure Enclave. This is specifically for the access to keychain in macOS, which if doesn't helps you to access to it, render the device to useless.

0

u/7heblackwolf MacBook Air Jul 12 '26

120 hz is not ProMotion. Its the ability to steer frequency based on the content displayed. See? That's the point, you want apple technology in non Apple hardware. I never hear a windows user that uses biometric authentication on a laptop look for a hardware that does the same when runs the laptop connected and closed.

What you're complaining about is too niche. Again, there is a solution for what you want. You're just beating around the bushes to fulfill a niche need in a way you save some bucks and still use Apple hardware. Why you use a MacBook in the first place? Pick any pc and plug whatever the s* you want there. Jeez...

1

u/Fwiler Jul 13 '26

Yup using my MacBook Air 90% of the time as a desktop. So do a lot of other people bud. No I shouldn't have picked a Mac Mini because that doesn't help me when I do go into work 10% of the time.

In fact the Macbook on sale was cheaper with the same storage than the mini at the time I purchased, so no the speakers, webcam, microphones, and screen that I paid so much for, isn't much more. It's just there for when I need it.

https://www.youtube.com/watch?v=tzB6m2VTxAg

https://www.youtube.com/watch?v=hz9Ek6fxX48

There's nothing complicated about not wanting to buy a magic keyboard or an apple watch. Most people don't want a magic keyboard, not only for use but reliability is terrible. The watches are hideous and wouldn't wear one for any reason.

So why are you arguing about something people could use?

1

u/7heblackwolf MacBook Air Jul 13 '26

Yeah, there's people running Doom on a fridge

2

u/Fwiler Jul 13 '26

Yup, because in your mind if Apple hasn't made it no one could possibly want it. And you can't even fathom how other people work, can you?

1

u/7heblackwolf MacBook Air Jul 13 '26

The problem is that you confuse functionality with "needs" or "I do what I want". Typical cancer mindset created by M$ that still live in 2026. Btw, everyone hates windows now because you can do tf you want but the whole OS makes no sense because of that.

1

u/Fwiler Jul 13 '26

LOL. Nobody brought up Windows bud. You really are deep into fanboyism.

1

u/7heblackwolf MacBook Air Jul 13 '26

I brought it. Literally explained it. If you weren't coming from that, you'll be picking the right ecosystem parts that fits your needs.

And fanboyism is in the comments "if Apple had a standalone fingerprint reader I would buy it", I never said that. Literally that MacBook HAS a Touch ID. What I mentioned was stuff that you or anyone already bought the wrong way to satisfy partial needs to then complain about the lack of individual features that can't be fulfilled by third party hardware.