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 ERROR CLASS: Symbol not found for ChannelSet.primaryChannel: Channel?

Return the primary channel info

subscribeList

val ERROR CLASS: Symbol not found for 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(): ERROR CLASS: Symbol not found for 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: ERROR CLASS: Symbol not found for User, newUser: ERROR CLASS: Symbol not found for User): String

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

decodeOrNull

fun <T : ERROR CLASS: Symbol not found for Message<T, *>> ERROR CLASS: Symbol not found for ProtoAdapter<T>.decodeOrNull(bytes: ERROR CLASS: Symbol not found for ByteString??, logger: ERROR CLASS: Symbol not found for Logger?? = null): T?

fun <T : ERROR CLASS: Symbol not found for Message<T, *>> ERROR CLASS: Symbol not found for ProtoAdapter<T>.decodeOrNull(bytes: ByteArray?, logger: ERROR CLASS: Symbol not found for Logger?? = null): T?

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

dispatchMeshtasticUri

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

Bridge extension for Android clients.

fun ERROR CLASS: Symbol not found for CommonUri.dispatchMeshtasticUri(onChannel: (ERROR CLASS: Symbol not found for ChannelSet) -> Unit, onContact: (ERROR CLASS: Symbol not found for SharedContact) -> Unit, onInvalid: () -> Unit)

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

encodeToString

fun ERROR CLASS: Symbol not found for 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 ERROR CLASS: Symbol not found for ChannelSet.getChannel(index: Int): Channel?

getChannelUrl

fun ERROR CLASS: Symbol not found for ChannelSet.getChannelUrl(upperCasePrefix: Boolean = false, shouldAdd: Boolean = false): ERROR CLASS: Symbol not found for 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 ERROR CLASS: Symbol not found for SharedContact.getSharedContactUrl(): ERROR CLASS: Symbol not found for CommonUri

Converts a SharedContact to its corresponding URI representation.

getShortDate

fun getShortDate(time: Long): String?

Returns a short string representing the time if it's within the last 24 hours, otherwise returns a short string representing the date.

getShortDateTime

expect fun getShortDateTime(time: Long): String

Returns a short string representing the time if it's within the last 24 hours, otherwise returns a combined short date/time string.

actual fun getShortDateTime(time: Long): String

Returns a short string representing the time if it's within the last 24 hours, otherwise returns a combined short date/time string.

handleMeshtasticUri

fun handleMeshtasticUri(uri: ERROR CLASS: Symbol not found for CommonUri, onChannel: (ERROR CLASS: Symbol not found for CommonUri) -> Unit = {}, onContact: (ERROR CLASS: Symbol not found for CommonUri) -> Unit = {}): Boolean

Dispatches an incoming Meshtastic URI to the appropriate handler based on its path.

hasLoraConfig

fun ERROR CLASS: Symbol not found for ChannelSet.hasLoraConfig(): Boolean

hasValidEnvironmentMetrics

fun ERROR CLASS: Symbol not found for Telemetry.hasValidEnvironmentMetrics(): Boolean

Returns true if this telemetry packet contains valid, plot-able environment metrics.

isDirectSignal

fun ERROR CLASS: Symbol not found for MeshPacket.isDirectSignal(): Boolean

Returns true if this packet is a direct LoRa signal (not MQTT, and hop count matches).

isLora

fun ERROR CLASS: Symbol not found for MeshPacket.isLora(): Boolean

Returns true if this packet arrived via a LoRa transport mechanism.

isWithinSizeLimit

fun <T : ERROR CLASS: Symbol not found for Message<T, *>> ERROR CLASS: Symbol not found for ProtoAdapter<T>.isWithinSizeLimit(message: T, maxBytes: Int): Boolean

Check if an encoded message would fit within a size limit.

logMessage

fun <T : ERROR CLASS: Symbol not found for Message<T, *>> ERROR CLASS: Symbol not found for ProtoAdapter<T>.logMessage(message: T, logger: ERROR CLASS: Symbol not found for Logger, prefix: String = "")

Log a proto message with readable formatting.

metersIn