cot-kmp is a lightweight Kotlin Multiplatform library for parsing, generating, and transforming Cursor on Target (COT) messages. It targets Android, JVM/Desktop, and JavaScript.

• Android API 21+
• JVM 17+
• JavaScript Browser (IR)

Kotlin version requirement: This library requires Kotlin 2.1.x or higher in your project. It will not load correctly with Kotlin 2.0.x or earlier.

import cot.parser.CotParser

val result = CotParser.parse(
    """
    <event version="2.0" uid="UNIT-001" type="a-f-G-U-C"
      time="2024-01-01T00:00:00.000Z" start="2024-01-01T00:00:00.000Z"
      stale="2024-01-01T01:00:00.000Z" how="m-g">
      <point lat="34.0522" lon="-118.2437" hae="71.0" ce="10.0" le="5.0"/>
    </event>
    """.trimIndent(),
)

import cot.model.CotEvent
import cot.model.CotPoint
import cot.serializer.CotSerializer

val event = CotEvent(
    uid = "UNIT-001",
    type = "a-f-G-U-C",
    time = "2024-01-01T00:00:00.000Z",
    start = "2024-01-01T00:00:00.000Z",
    stale = "2024-01-01T01:00:00.000Z",
    how = "m-g",
    point = CotPoint(lat = 34.0522, lon = -118.2437),
)

val xml = CotSerializer.serialize(event)

import cot.sidc.SidcStandard
import cot.sidc.cotTypeToSidc

val sidc2525C = cotTypeToSidc("a-f-G-U-C", SidcStandard.MIL_STD_2525C)
val sidc2525D = cotTypeToSidc("a-f-G-U-C", SidcStandard.MIL_STD_2525D)

Supported SIDC standards in this library:

• MIL-STD-2525B
• MIL-STD-2525C
• MIL-STD-2525D

import cot.sidc.sidcToCotType

val cotType = sidcToCotType("SFGPUC---------")

npm install cot-kmp

See README.npm.md for the full JavaScript/TypeScript API reference and usage examples.

import cot.CotJvmApi;
import cot.model.CotEvent;
import cot.sidc.SidcStandard;

String xml = "<event version=\"2.0\" uid=\"UNIT-001\" type=\"a-f-G-U-C\" "
    + "time=\"2024-01-01T00:00:00.000Z\" start=\"2024-01-01T00:00:00.000Z\" "
    + "stale=\"2024-01-01T01:00:00.000Z\" how=\"m-g\">"
    + "<point lat=\"34.0522\" lon=\"-118.2437\" hae=\"71.0\" ce=\"10.0\" le=\"5.0\"/>"
    + "</event>";

CotEvent event = CotJvmApi.parse(xml);
String sidc = CotJvmApi.cotTypeToSidc(event.getType(), SidcStandard.MIL_STD_2525C);
String serialized = CotJvmApi.serialize(event);

All methods throw IllegalArgumentException on failure. CotJvmApi is available on JVM and Android targets.

CotDetail gives you simple access to common detail values like contact info and remarks, while still keeping custom detail elements available when you need them.

If your messages include ATAK or vendor-specific detail tags, they are preserved in a structured form instead of being discarded.

val event = CotParser.parse(xml).getOrThrow()
val group = event.detail?.children?.firstOrNull { it.tag == "__group" }
val role  = group?.attributes?.get("role") // e.g. "Team Member"

To add a custom child when building a message:

import cot.model.DetailElement

val detail = CotDetail(
    callsign = "ALPHA-1",
    children = listOf(
        DetailElement(
            tag = "status",
            attributes = mapOf("battery" to "87"),
        ),
    ),
)

For more detail about what is preserved and how it round-trips, see DETAIL_PRESERVATION.md.

Parsing and transformation APIs return Result<T> for normal failures. Invalid XML, malformed COT type strings, and unsupported SIDC values produce descriptive error messages.

scheme-affiliation-dimension[-function[-modifier]]

Examples:

• a-f-G-U-C
• a-h-A
• a-n-S

For more detail about SIDC support, legacy 2525B interoperability, and known ambiguities, see SIDC_INTEROP.md.

No extra repository configuration needed.

Android projects must use the -android artifact to avoid an AGP dependency analysis bug with KMP module metadata. JVM/Desktop projects use the root artifact.

Android (Kotlin DSL):

dependencies {
    implementation("io.github.rosaleskevin:cot-kmp-android:0.1.0-alpha05")
}

JVM / Desktop (Kotlin DSL):

dependencies {
    implementation("io.github.rosaleskevin:cot-kmp:0.1.0-alpha05")
}

Gradle (Groovy) — Android:

dependencies {
    implementation 'io.github.rosaleskevin:cot-kmp-android:0.1.0-alpha05'
}

Maven — Android:

<dependency>
    <groupId>io.github.rosaleskevin</groupId>
    <artifactId>cot-kmp-android</artifactId>
    <version>0.1.0-alpha05</version>
</dependency>

Maven — JVM:

<dependency>
    <groupId>io.github.rosaleskevin</groupId>
    <artifactId>cot-kmp</artifactId>
    <version>0.1.0-alpha05</version>
</dependency>

npm install cot-kmp

See README.npm.md for usage details.

This project is licensed under the MIT License - see the LICENSE file for details. You are free to use, modify, and distribute this library in both open source and commercial/proprietary projects with no restrictions beyond attribution.

Inspired by kotcot by cyberpython.