BoxOnPost for the LILYGO T-Deck Plus
BoxOnPost pages on the radio's screen · holds 64 messages.
BoxOnPost v0.7.3 includes MeshCore 1.18.0. Installing it replaces the firmware on your radio with this version.
Brand-new radio, or not running MeshCore yet?
Radios often arrive with other firmware (such as Meshtastic) or a factory test program. Before installing BoxOnPost, first install the official MeshCore Companion firmware for your radio from flasher.meshcore.io, connect it to the MeshCore app and make sure it works. Then come back here.
Already on MeshCore? Any recent version is fine: BoxOnPost v0.7.3 replaces it with MeshCore 1.18.0 plus the BoxOnPost features. If your radio runs a MeshCore version newer than 1.18.0, do the backup below before installing.
Back up your private key
Installing keeps your identity, contacts and settings. The backup is a safety net in case something goes wrong.
In the MeshCore app, open Settings and choose Export private key. Keep it somewhere private, like a password manager, and never share it. Also screenshot your radio settings and note any private channels. Full backup steps.
Flash it from your browser
The LILYGO T-Deck Plus version is being tested on real radios. The download appears here once it passes.
Want to help test it? Get in touch
What happens when you click Flash
- Click the Flash button above and pick your radio's port in the pop-up (it may be named USB JTAG, CP210x or similar).
- Already on MeshCore or BoxOnPost? When it asks “Erase device?”, leave it unticked. That keeps your identity, contacts and settings.
- Brand-new or wiped radio? Tick “Erase device” for a clean start.
- Wait about a minute while it installs. Keep the cable plugged in.
- When it says the install is complete, press the RST button once (or unplug the radio and plug it back in). Heltec radios sometimes stay in install mode until you do. If the screen still stays blank, run Flash again with “Erase device” ticked.
Nothing happens when you click? You need Chrome or Edge on a computer; Safari, Firefox and phones can't talk to USB devices. Or use the download option above.
Check it worked
Reconnect the MeshCore app. In Settings the version reads v1.18.0-BOP-0.7.3, and your contacts are still there.
Try it
- Find the new pages. Short-press the button to move through the pages. After “Recent adverts” come MAILBOX, LAST TRIES, SEND NOW, CLEAR MAILBOX, HOLD MESSAGES and SIGNAL. A long press (about 1 second) uses the page you're on.
- Hold a message. Send a direct message to a radio that's switched off. The app says “failed”, but MAILBOX on your radio shows Held: 1.
- Watch it deliver. Switch the other radio back on. Within about 15 minutes (or straight away if you long-press SEND NOW) it gets the message and your screen shows Delivered.
The Guide explains every page.
Good to know
- Use the trackball: press it to move to the next page, and hold it for about a second to use the page.
- Still needs the phone app: BoxOnPost is built on MeshCore's phone-app firmware, so you write and read messages in the MeshCore app. The keyboard isn't used.
Help us test the LILYGO T-Deck Plus
This build compiles and passes every mailbox test, but nobody has run it on a real radio yet. If you try it, please tell us what worked and send photos of anything odd. That's how it gets the Tested badge.
Something went wrong?
Won't start after installing? Install the official MeshCore Companion firmware for your radio from flasher.meshcore.io (pick your radio from the list), then install the BoxOnPost file again with “Erase device” unticked. If you had to erase, import your private key to get your identity back.
Going back to official MeshCore: in the flasher, pick your radio, choose Companion Bluetooth, version 1.18.0, and flash with “Erase device” unticked. Your identity and contacts are kept, and if you come back to BoxOnPost later your held messages are still there.