A high-performance, lightweight image compression library for Compose Multiplatform (Android, iOS, Desktop/JVM, Web/WASM). It allows you to efficiently compress and resize images into high-quality WebP format using a simple, unified multiplatform API.

Key Features:

• ⚡ Dual Compression Modes: Compress by target quality percentage or target file size constraint (KB).
• 📐 Smart Resizing: Fast, aspect-ratio-aware resizing prior to compression to save memory and network bandwidth.
• ⚙️ Multi-Engine Execution: Uses high-performance native engines under the hood (Android's Bitmap, JVM's Skia, iOS's UIKit, Wasm's Canvas).
• 📊 Rich Analytics: Delivers metadata and diagnostics on compression ratios, elapsed times, and iteration counts.
• 🧪 Testable Design: Designed to support clean UI unit tests and portable multiplatform verification.

Wasm Demo:

API Docs:

Add the dependency to your Compose Multiplatform project:

Option A — Version Catalog (Recommended)

1. In gradle/libs.versions.toml:

[versions]
cmpImgcompress = "0.0.1"

[libraries]
cmp-imgcompress = { module = "io.github.aryapreetam:cmp-imgcompress", version.ref = "cmpImgcompress" }

2. In your module's build.gradle.kts:

kotlin {
  sourceSets {
    val commonMain by getting {
      dependencies {
        implementation(libs.cmp.imgcompress)
      }
    }
  }
}

Option B — Direct Dependency

kotlin {
  sourceSets {
    val commonMain by getting {
      dependencies {
        implementation("io.github.aryapreetam:cmp-imgcompress:0.0.1")
      }
    }
  }
}

import io.github.aryapreetam.cmpimgcompress.*

suspend fun compressMyImage(inputBytes: ByteArray) {
  val imageData = ImageData(inputBytes, "image/png")
  
  // Compress to WebP at 80% quality
  val compressed: CompressedImage = ImageCompressor.compress(
    input = imageData,
    config = CompressionConfig.ByQuality(80f)
  )
  
  println("Original: ${compressed.originalSize} bytes")
  println("Compressed: ${compressed.compressedSize} bytes")
  
  val outputWebpBytes = compressed.bytes
}

import io.github.aryapreetam.cmpimgcompress.*

suspend fun compressToLimit(inputBytes: ByteArray) {
  val imageData = ImageData(inputBytes, "image/jpeg")
  
  // Attempt to compress the image to fall under 100 KB
  val compressed = ImageCompressor.compress(
    input = imageData,
    config = CompressionConfig.ByTargetSize(100), // Target size limit in KB
    resize = ResizeOptions(maxLongEdgePx = 1920) // Optional resizing
  )
  
  println("Elapsed time: ${compressed.metadata?.elapsedMillis} ms")
  println("Iterations taken: ${compressed.metadata?.iterations}")
}

Download and try the sample app on your platform without building from source:

Platform	Format / Package	Download Link
🍏 macOS (Intel)	DMG Installer
🍎 macOS (Apple Silicon)	DMG Installer
🪟 Windows	MSI Installer
🐧 Linux	DEB Package
🤖 Android	APK Executable
🌐 Web (Wasm)	ZIP Bundle
 iOS Simulator	ZIP Bundle

• Download the APK file.
• Open an Android emulator or connect a physical device.
• Drag the APK onto the emulator window, or run:

  adb install sample-app-android-unsigned.apk

• Download and unzip sample-app-wasm.zip
• Open index.html in your web browser.
• Or visit the live demo: Try Live Demo

• Download sample-app-ios-simulator.zip
• Unzip to get sample-app-ios-simulator.app
• Open your iOS Simulator from Xcode.
• Drag the .app onto the Simulator window, or run:

  xcrun simctl install booted /path/to/sample-app-ios-simulator.app

• Download the DMG for your architecture (Intel/x64 or Apple Silicon/arm64).

• Open the DMG and drag the app to your Applications folder.

• When you try to open the app for the first time, macOS Gatekeeper will block it since it is an open-source build signed ad-hoc. Follow these 6 sequential steps to allow running the app:

  1. Block Alert Dialog	2. Open System Settings	3. Privacy & Security Section
  4. Click "Open Anyway"	5. Authenticate Security Dialog	6. Click "Open" to Launch

• Summary:

  1. Double-click the app. If blocked, open System Settings.
  2. Navigate to Privacy & Security and scroll down to the Security section.
  3. You will see a notice stating: "sample was blocked from use because it is not from an identified developer".
  4. Click "Open Anyway" and authenticate with your Touch ID / password.
  5. Re-open the app and click "Open" on the confirmation dialog.

• Download the .deb package.
• Install it via your GUI software manager, or run:

  sudo dpkg -i sample-app-linux.deb

To run the sample app locally on your machine:

• Desktop JVM: ./gradlew :sample:composeApp:run
• Android: Run the :sample:androidApp run configuration in Android Studio.
• iOS: Open sample/iosApp/iosApp.xcodeproj in Xcode and run it.
• Wasm: ./gradlew :sample:composeApp:wasmJsBrowserRun

MIT License © 2026 aryapreetam and contributors. See LICENSE for details.