Home

Awesome

mastodonk — A Kotlin/Multiplatform Mastodon API client

JVM Build JS Build Native Build GitHub license GitHub release (latest SemVer including pre-releases)

Documentation

API Reference

Setup

repositories {
    maven { url = uri("https://nexus.outadoc.fr/repository/public") }
}

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                // Core library
                implementation("fr.outadoc.mastodonk:mastodonk-core:+")

                // Paging library, use with androidx.paging v3 on JVM
                implementation("fr.outadoc.mastodonk:mastodonk-paging:+")
            }
        }
    }
}

Usage

Mastodonk provides a Kotlin-first API based on coroutines and Flows.

fun main() = runBlocking {

    val client = MastodonClient {
        domain = "mastodon.social"
        authTokenProvider = AuthTokenProvider {
            // Provide an authentication token
            AuthToken(accessToken = "your-access-token-here")
        }
    }

    GlobalScope.launch {

        // Get some information about the configured instance
        val instance = client.instance.getInstanceInfo()
        println("connected to instance ${instance.title} at ${instance.uri}!")

        // Get a list of public toots
        val toots = client.timelines.getPublicTimeline()

        // Get some #cats in your life
        val catToots = client.timelines.getHashtagTimeline("cats")

        // Easy pagination
        val moreCatToots = client.timelines.getHashtagTimeline(
            "cats",
            pageInfo = catToots.nextPage
        )

        // Subscribe to streaming APIs and get a Flow
        client.streaming.getPublicStream().collect { event ->
            when (event) {
                is UpdateEvent -> println("new status from ${event.payload.account.displayName}!")
                else -> Unit
            }
        }

    }.join()
}