meshtastic/FIRMWARE_HACKS.md

Meshtastic Firmware Hacks

Custom Boot Logo & Message

• Download & install PlatformIO

• git clone https://github.com/meshtastic/firmware.git

• cd firmware && git submodule update --init

• Use XMB Viewer to convert an image to XMB

• The data from this goes in firmware/src/graphics/img/icon.xbm

Custom boot message

• Navigate to firmware/src/graphics/Screen.cpp

• Find & replace const char *title = "meshtastic.org"; with your custom message.

Custom screen color

• Navigate to src/graphics/TFTDisplay.cpp

• Find & replace #define TFT_MESH COLOR565(0x67, 0xEA, 0x94) with your custom color.

Custom alert sound (for T-Deck & devices with a buzzer)

• From the mobile app, click the 3 dots on the top right, and select Radio configuration
• Under Module configuration, select External Notification
• Scroll down & you will see a Ringtone option that takes RTTTL formatted tones.

As far as I know, at the time of writing this, the onyl way to change the Ringtone is from the App...

Compile & flash firmware

• Select PlatformIO: Pick Project Environment & select your board.
• Run PLatformIO: Build to compile the firmware.
• Place device in DFU mode & plug in to the computer
• Do PlatformIO: Upload to send the firmware to the device
• Press the RESET button or reboot your device.

See here for more information building & flashing custom firmware.