Build your own Bitcoin key collider. A small, portable device that generates random private keys and checks them against 43,497 known whale wallets — 24/7.
Will it ever find one? Almost certainly not. But almost isn't never.
1 WHAT YOU NEED
2 FLASH THE FIRMWARE
Flashing loads the keycracker software onto your board. You only need a browser — no coding required.
- Plug your Heltec into your computer via USB-C
- Open keycracker.io/flash in Chrome or Edge (Web Serial required)
- Select the latest firmware version and click FLASH FIRMWARE
- Choose your device's serial port when prompted
- Wait for the flash to complete (~2 minutes)
3 SETUP WIFI
After flashing, the device starts in WiFi setup mode (first time only). The OLED will show:
Connect to WiFi:
KEYFINDER-XXXXX
- On your phone or laptop, connect to the
KEYFINDER-XXXXXWiFi network (where XXXXX is your device's unique code) - A setup page opens automatically (or go to
11.11.11.1) - Select your home WiFi network and enter the password
- The device reboots and connects to your WiFi
4 START HUNTING
After WiFi connects (or if WiFi is unavailable), you'll see the splash screen. Press the PRG button to start immediately, or wait 5 seconds and the device starts automatically.
Your device gets a unique 5-character shortcode (based on its MAC address). View your live dashboard at:
The shortcode is shown on the device's main screen and the dedicated Device ID screen (large text for easy identification).
5 USING YOUR DEVICE
PRG button (short press) — cycles through screens:
- MAIN — keys checked, speed, uptime, truncated current key
- DETAILS — full private key and hash160 hex
- WIFI & BATTERY — WiFi signal, SSID, IP, MAC, battery voltage & percentage
- DEVICE ID — your unique 5-character device code in large text, for easy fleet identification
- FIRMWARE — current firmware version and update check (cached, checks once per 2 weeks)
PRG button (hold 5 seconds) — powers off the device. Press RST or unplug/replug to wake up.
PRG button (hold during boot animation) — forces WiFi setup mode. Use this to change WiFi networks without reflashing. Hold PRG while the boot animation plays on startup, and the device will open the WiFi setup portal instead of connecting automatically.
Screensaver — after 60 seconds of inactivity, the display switches to a Matrix-style rain animation with KEYCRACKER.IO periodically decoding from the hex rain. Press PRG to wake the screen.
6 UPDATING FIRMWARE
When a firmware update is available, your device dashboard will show an update banner. To update:
- Go to keycracker.io/flash
- Select the latest version and flash
- Your WiFi settings and lifetime key count are preserved — the device reconnects automatically