Friend Finder Firmware Flasher

Install the custom Meshtastic firmware with Friend Finder & Magnetometer support directly to your device.

1. Select Your Device

Skip full erase (coming soon)

Important: The "skip erase" feature will be added soon. For now, flashing the firmware will perform a full erase of the device.

Please back up your settings and channel keys using the Meshtastic app or CLI before you proceed.

🚀 Key Features

Real-Time Tracking: See the distance and direction to your friends.
Compass Support: Adds magnetometer support for a directional arrow.
Friend Map: View all your paired friends on a map screen.
Designed for the Outdoors: Perfect for festivals, skiing, and hiking.

📋 Instructions

Select your device from the dropdown menu above.
Plug your device into your computer.
Click the Connect & Install button.
Select the correct COM/Serial Port from the pop-up window and click “Connect”.
The installation will begin. Keep this browser tab open until it completes.

⚙️ Hardware Requirements

This firmware is designed for ESP32-S3 devices like the Heltec V3, Heltec V4, or LILYGO T-Lora T3-S3 and requires a GPS module to function. For the directional arrow feature, a QMC5883L magnetometer is also needed.

Recommended Magnetometer Pins (SDA / SCL):

Heltec V3: 41 / 42 (Confirmed)
Heltec V4: 17 / 18 (Possible)
LILYGO T-Lora T3-S3: 18 / 17 or 43 / 44 (Varies)

Please read the project's README file carefully for important details on wiring the components and performing the essential compass calibration to ensure accuracy.

📄 Source Code & Documentation

You can find the source code, full documentation, and project updates on GitHub.

Firmware Fork on GitHub - The main source code for this project.
Web Flasher Repository - The code for this installation page.

Warning

Flashing firmware can potentially brick your device. Ensure you have the correct firmware for your specific model and follow all instructions carefully. This firmware is experimental and may have bugs. Use at your own risk.