Skip to content
Skip to content
Mobile & multiplatform

Chorono Android animation SDK

Use the published Chorono Android SDK to play an authored animation in an Android view or Jetpack Compose screen. Version 1.0.0 is available from Maven Central, with a native player, ChoronoView and a Compose wrapper.

Install from Maven Central#

Version 1.0.0 requires Android 7.0 / API 24 or later. Its published AAR contains native libraries for arm64-v8a and x86_64 only. Use a device or emulator with one of those architectures; this release does not include 32-bit ARM or x86 libraries.

In an existing Android project, make sure your dependency repositories include Maven Central. If you already have a dependencyResolutionManagement block in settings.gradle.kts, add the repository there:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}

Add the versioned dependency to your app module's build.gradle.kts:

dependencies {
    implementation("com.grntsoftware:chorono-android-sdk:1.0.0")
}

Sync the Gradle project before adding the player to your screen. This is the native Android package; it does not use the npm package or the browser's CanvasRenderAdapter.

Show an animation in Jetpack Compose#

Put a Chorono scene that you have checked against the native SDK in app/src/main/assets/intro.chorono.json. The sceneFile argument is a filename relative to that assets directory.

In an app with Compose already configured:

import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import com.grntsoftware.chorono.ScaleMode
import com.grntsoftware.chorono.compose.ChoronoAnimator

@Composable
fun IntroAnimation() {
    ChoronoAnimator(
        sceneFile = "intro.chorono.json",
        modifier = Modifier.fillMaxWidth().height(220.dp),
        scaleMode = ScaleMode.FIT
    )
}

The published view begins playback when the scene loads. Give it an explicit display size and check how the composition fits inside it. The wrapper also accepts scene parameters and callbacks for animation and layer events; use names declared by your scene.

This SDK plays a Chorono scene inside your interface. For a simple Compose transition between ordinary UI states, you may not need an authored animation file or this player.

Use the Android view directly#

For a View-based screen, the package exposes com.grntsoftware.chorono.view.ChoronoView. After attaching it to your layout, load("intro.chorono.json") reads a bundled asset. The API also provides timeline controls and parameter setters. Inspect the published source archive below for exact signatures when connecting a particular interaction.

The native loader expects a scene object with composition at the top level. Do not pass the entire JavaScript export envelope containing runtime and warnings. Review runtime export, retain the editable project, and validate the scene on the native player.

Downloads and package metadata#

FileLinkPurpose
Android libraryDownload SDK 1.0.0 AARPublished library artifact; Gradle is the normal installation path
SourcesDownload SDK 1.0.0 sourcesPublished Kotlin player, view and Compose APIs
POMRead dependency metadataCoordinates and declared dependencies
Version metadataView Maven release metadataPublished version list

The version and file links were checked on 11 November 2026. Downloading an AAR alone does not configure its dependencies; use Gradle unless you are managing those dependencies yourself.

Check the scene on Android#

Start with a small scene and inspect playback, fonts, images and interaction on your target device. A published SDK version does not imply support for every feature added to a newer editor. Keep the package version pinned while validating your application.

For browser playback, use the separate JavaScript runtime. The React Native and Kotlin Multiplatform projects are still in development; the Android release does not make those wrappers available automatically.

A good place to start
Getting started / Chorono documentationChorono documentationLearn Chorono with editable animation examples. Install the editor, edit keyframes, build loops and connect Claude Code or Codex through MCP. Cre…Getting started / Install ChoronoInstall ChoronoSet up the free, open-source animation editor on your computer and start a local browser session. This guide installs the browser editor, its loc…Getting started / Create your first editable animationCreate your first editable animationOpen an editable Chorono example, change its text and colors, inspect the timeline, then save and reopen your first 2D animation. Start with a re…Workspace / Chorono editor workspaceChorono editor workspaceFind the canvas, layers, properties, timeline and resource tools in the Chorono editor. Choose a guide for each part of your animation workflow.…Workspace / Canvas and drawing toolsCanvas and drawing toolsNavigate the canvas, draw shapes and splines, use snapping and edit motion keys in Chorono. Use the canvas to arrange the objects in your composi…Workspace / Choose a drawing or transform toolChoose a drawing or transform toolUse Select, Pan, Pen, Move, Rotate, Scale and Anchor tools without losing track of the active editing mode. Choose the tool that matches the edit…Workspace / Select exactly the objects you needSelect exactly the objects you needUse box, lasso, circle, paint and rule-based selection to work with several animation layers. When several objects overlap, clicking each one can…Workspace / Align objects with guides and snappingAlign objects with guides and snappingSet grid, object, point, guide, pixel, angle and scale snapping for precise placement in Chorono. Snapping helps a dragged object settle on an ex…Workspace / Edit Bézier points and spline curvesEdit Bézier points and spline curvesDraw editable paths, adjust points and handles, and extend or close a spline in Chorono. A curve is easier to control when you can see the points…Workspace / Edit animation positions on the canvasEdit animation positions on the canvasUse Motion Keys to adjust position keys, draw a movement and control how the path is timed. Motion Keys bring position editing onto the canvas. T…Workspace / Layers and scene hierarchyLayers and scene hierarchySelect, name, group and organize scene objects in Chorono using the Layers panel and Scene Explorer. A layer is an editable object in your Choron…Workspace / Draw and edit basic shapesDraw and edit basic shapesCreate rectangles, circles, polygons and procedural shapes, then adjust their geometry in Properties. Basic shapes are a useful starting point fo…
Explore the docs