ESP32 MFA Authenticator
Offline two-factor code generator on the yellow display: your TOTP secrets stay on a board you own, behind a PIN.
Chipnik catalog@chipnik-catalogWhat you need
- Board
- Cheap Yellow Display
- Parts
- microSD card
- Also
- Wi-Fi network
ESP32 MFA Authenticator shows time based one-time codes (TOTP) for your accounts on the Cheap Yellow Display, like a phone authenticator app on a separate device. Secrets are encrypted on the microSD card, the screen locks with a PIN, and Wi-Fi is only used to set the clock. Original project by AllanOricil on GitHub, MIT. Chipnik hosts the release binaries unchanged so you can flash them from the browser.
Put your secrets and settings in a config file on the microSD card as described in the README. Keep a backup of your recovery codes somewhere else, as with any authenticator.
Firmware files come from the v0.20.0 release.
Parts
Buy everything for this project
- Cheap Yellow Display ESP32-2432S028BuyAliExpress
After flashing
- The board restarts by itself when flashing is done.
- The project needs Wi-Fi. How to connect it is in the project text or in the source repository.
- If nothing happens, press the RST (EN) button once.
Versions
0.20.0 added to Chipnik 2026-11-05
Release v0.20.0 of AllanOricil/esp32-mfa-authenticator, files unchanged. Release notes on GitHub