A Compose Multiplatform video player for Android and iOS. Add one dependency to shared Compose code and call RubyVideoPlayer; the library creates and releases ExoPlayer on Android and AVPlayer on iOS internally.

Repository · Latest release: io.github.rubywai:ruby-kmp-player:1.1.1 · Upcoming release: 1.2.1

• Compose Multiplatform API for Android and iOS
• Progressive MP4 playback and explicit MP4 quality sources
• HLS master playlists with dynamically discovered resolutions
• Built-in resolution and playback-speed settings, centred skip/play controls, mute, seek, status, buffering, error, auto-hide, and fullscreen controls
• Optional controller API for advanced integrations

The examples below use 1.2.1, which is currently tested from Maven Local and will be available from Maven Central after the GitHub Release for v1.2.1 is published.

commonMain.dependencies {
    implementation("io.github.rubywai:ruby-kmp-player:1.2.1")
}

@Composable
fun App() {
    RubyVideoPlayer(
        url = "https://example.com/video.mp4",
    )
}

The consuming app does not create a platform controller or add source files in androidMain, iosMain, or nativeInterop.

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET" />

    <application>
        <!-- application components -->
    </application>
</manifest>

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|screenSize"
    android:exported="true" />

<key>UISupportedInterfaceOrientations</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>
<key>UISupportedInterfaceOrientations~ipad</key>
<array>
    <string>UIInterfaceOrientationPortrait</string>
    <string>UIInterfaceOrientationLandscapeLeft</string>
    <string>UIInterfaceOrientationLandscapeRight</string>
</array>

RubyVideoPlayer(
    url = "https://example.com/video.mp4",
    modifier = Modifier.fillMaxWidth().height(240.dp),
    config = RubyPlayerConfig(
        autoPlay = true,
        looping = false,
        startPositionMs = 0L,
        volume = 1f,
        playbackSpeed = 1f,
    ),
    controls = RubyPlayerControls(
        showPlayPause = true,
        showSkipBackward = true,
        showSkipForward = true,
        centerControlSize = 60.dp,
        centerControlIconSize = 34.dp,
        showMute = true,
        showSeekBar = true,
        showQualitySelector = true,
        showPlaybackSpeedSelector = true,
        showFullscreen = true,
        showStatus = true,
        autoHide = true,
        autoHideDelayMillis = 5_000L,
    ),
)

volume must be from 0f to 1f; playbackSpeed must be greater than 0f; and startPositionMs must not be negative. Set showFullscreen = false when the app manages fullscreen itself, or showQualitySelector = false to hide the resolution entry in player settings. Set showPlaybackSpeedSelector = false to hide the 0.5× to 2× speed entry. The settings icon appears immediately before fullscreen only when at least one of those entries is enabled and available. The player shows previous 10 seconds, play/pause, and next 10 seconds in the centre; use showSkipBackward and showSkipForward to hide either skip button. Use centerControlSize and centerControlIconSize to adjust their diameter and icon size. The active playback speed remains visible beside the time status after the menu closes.

Use RubyVideoSourceSet when the app owns separate progressive URLs. The selected source changes while preserving playback position and runtime settings.

val qualities = RubyVideoSourceSet(
    qualities = listOf(
        RubyVideoQuality("240p", RubyVideoSource("https://cdn.example.com/video-240.mp4")),
        RubyVideoQuality("360p", RubyVideoSource("https://cdn.example.com/video-360.mp4")),
        RubyVideoQuality("720p", RubyVideoSource("https://cdn.example.com/video-720.mp4")),
    ),
    initialQualityLabel = "360p",
)

RubyVideoPlayer(sources = qualities)

Labels are exact. If initialQualityLabel is null, missing, or misspelled, the first quality is selected.

Provide one master playlist URL. Do not enumerate individual rendition URLs. After the playlist loads, the quality menu shows Auto and every discovered resolution.

RubyVideoPlayer(
    url = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8",
)

Choose a resolution to constrain playback to that rendition. Choose Auto to restore adaptive bitrate playback. Android pins the selected HLS track; iOS uses the selected resolution as AVPlayer's maximum, so AVPlayer can choose a lower rendition when network conditions require it.

For custom headers, direct commands, or observing StateFlow snapshots, keep using the controller-based API:

val controller: RubyVideoPlayerController = /* platform controller */
controller.load(
    RubyVideoSource(
        url = "https://example.com/video.mp4",
        headers = mapOf("Authorization" to "Bearer token"),
    ),
)
controller.setPlaybackSpeed(1.25f)

Most Compose Multiplatform apps should use the controller-free RubyVideoPlayer(url = ...) or RubyVideoPlayer(sources = ...) overloads.

The repository's example/ app consumes the Maven-coordinate dependency from shared Compose code. It includes MP4, HLS master-playlist, and MP4 quality source screens.

./gradlew -I build/local-repo.init.gradle :example:androidApp:installDebug
./gradlew :example:composeApp:assembleDebugXCFramework

For the Xcode host instructions, see iosApp/README.md.