When printing strings to logs sometimes we want to print useful debugging information about users or positions. But we don't want to leak things like usernames or locations. So this function if given a string, will return a string which is a maximum of three characters long, taken from the tail of the string. Which should effectively hide real usernames and locations, but still let us see if values were zero, empty or different.

CHANNEL_SHARE_PATH

const val CHANNEL_SHARE_PATH: String

Path segment for Channel Set URIs.

CHANNEL_URL_PREFIX

const val CHANNEL_URL_PREFIX: String

Full prefix for Channel Set URIs: https://meshtastic.org/e/

CONTACT_SHARE_PATH

const val CONTACT_SHARE_PATH: String

Path segment for Shared Contact URIs.

CONTACT_URL_PREFIX

const val CONTACT_URL_PREFIX: String

Full prefix for Shared Contact URIs: https://meshtastic.org/v/#

isDebug

const val isDebug: Boolean = false

Whether the app is running in debug mode.

MESHTASTIC_HOST

const val MESHTASTIC_HOST: String

The base domain for all Meshtastic URIs.

primaryChannel

val ChannelSet.primaryChannel: Channel?

Return the primary channel info

subscribeList

val ChannelSet.subscribeList: List<String>

Functions

anonymize

fun Any?.anonymize(maxLen: Int = 3): String

A version of anonymize that allows passing in a custom minimum length

base64ToByteString

fun String.base64ToByteString(): ByteString

Decodes a Base64 string into a ByteString.

byteArrayOfInts

fun byteArrayOfInts(vararg ints: Int): ByteArray

Utility function to make it easy to declare byte arrays

compareUsers

fun compareUsers(oldUser: User, newUser: User): String

Compares two User objects and returns a string detailing the differences.

decodeOrNull

fun <T : Message<T, *>> ProtoAdapter<T>.decodeOrNull(bytes: ByteArray?, logger: Logger? = null): T?

Safely decode a proto message from ByteArray, returning null on error.

fun <T : Message<T, *>> ProtoAdapter<T>.decodeOrNull(bytes: ByteString?, logger: Logger? = null): T?

dispatchMeshtasticUri

fun Uri.dispatchMeshtasticUri(onChannel: (ChannelSet) -> Unit, onContact: (SharedContact) -> Unit, onInvalid: () -> Unit)

Bridge extension for Android clients.

fun CommonUri.dispatchMeshtasticUri(onChannel: (ChannelSet) -> Unit, onContact: (SharedContact) -> Unit, onInvalid: () -> Unit)

Tries to parse a Meshtastic URI as a Channel Set or Shared Contact, including fallback logic.

encodeToString

fun ByteString.encodeToString(): String

formatMuteRemainingTime

fun formatMuteRemainingTime(remainingMillis: Long): Pair<Int, Double>

Calculates the remaining mute time in days and hours.

formatUptime

fun formatUptime(seconds: Int): String

Formats a duration in seconds as a human-readable uptime string (e.g., "1d 2h 3m 4s").

getChannel

fun ChannelSet.getChannel(index: Int): Channel?

getChannelUrl

fun ChannelSet.getChannelUrl(upperCasePrefix: Boolean = false, shouldAdd: Boolean = false): CommonUri

Return a URL that represents the ChannelSet

getInitials

fun getInitials(fullName: String): String

Given a human name, strip out the first letter of the first three words and return that as the initials for that user, ignoring emojis. If the original name is only one word, strip vowels from the original name and if the result is 3 or more characters, use the first three characters. If not, just take the first 3 characters of the original name.

getSharedContactUrl

fun SharedContact.getSharedContactUrl(): CommonUri

Converts a SharedContact to its corresponding URI representation.

getShortDateTime