Komoji is a combination of Kotlin and Emoji — a Kotlin Multiplatform library designed to provide fast, localized, and fully offline access to Unicode emoji data.

Built around a lightweight SQLite database, Komoji offers powerful emoji search, multilingual metadata, emoji grouping, variant support, and reactive APIs for Android, iOS, and JVM applications. The library manages its database connection automatically with lazy initialization and configurable timeouts, making it both efficient and easy to integrate.

It supports:

• Emoji search
• Localized emoji names & keywords
• Emoji groups & subgroups
• Emoji variants
• Lazy database initialization
• Reactive search via Flow
• Android, iOS, and JVM targets

The database connection is managed automatically and closes itself after a configurable timeout to minimize resource usage.

dependencies {
    implementation("io.github.raku2412:komoji:<version>")
}

Android requires initialization before any database access:

class App : Application() {

    override fun onCreate() {
        super.onCreate()

        Komoji.initialize(this)
    }
}

If initialization is missing, ContextNotProvidedException will be thrown.

iOS and JVM do not require initialization.

val emojis = Komoji.getAllEmojis()

val results = Komoji.searchEmojis(
    query = "smile"
)

val emoji = Komoji.getEmojiByUnicode("😀")

val emoji = Komoji.getEmojiById(1)

Emoji names and keywords can be loaded in different languages.

val emojis = Komoji.getAllEmojis(
    language = "de",
    metadata = setOf(
        EmojiMetadataType.NAME,
        EmojiMetadataType.KEYWORDS
    )
)

Available languages:

val languages = Komoji.getAllLanguages()

val groups = Komoji.getAllGroups(
    includeSubgroups = true
)

Emoji variants (e.g. skin tones) can be attached via metadata:

val emoji = Komoji.getEmojiByUnicode(
    unicode = "👍",
    metadata = setOf(EmojiMetadataType.VARIANTS)
)

Komoji supports reactive searching with Kotlin Flow.

val results = Komoji.searchEmojis(
    query = searchFlow,
    language = "en",
    metadata = setOf(
        EmojiMetadataType.NAME,
        EmojiMetadataType.KEYWORDS
    )
)

Komoji automatically:

• Lazily opens the SQLite database
• Shares the connection across requests
• Closes the connection after inactivity

Default timeout: 5 minutes

Custom timeout:

Komoji.configureTimeout(30.seconds)

MIT License (see here).