KEditor

KEditor is a Kotlin Multiplatform video editing library powered by FFmpeg.

It provides a simple Kotlin API for performing common video editing operations without requiring users to interact directly with FFmpeg's command-line interface.

KEditor is designed for Android and iOS applications and can be integrated into Kotlin Multiplatform projects.

• 🎬 Video editing powered by FFmpeg
• ✂️ Trim videos
• 🔄 Rotate videos
• 📐 Scale videos
• ✂️ Crop videos
• 🔃 Horizontal and vertical flip
• 🎨 Video filters
• 🌫️ Blur effects
• ⚫ Grayscale and color adjustments
• 🎞️ Fade effects
• 🐇 Change video speed
• 🔇 Remove audio
• 🎥 Remove video
• 🌍 Kotlin Multiplatform
• 🤖 Android support
• 🍎 iOS support

KEditor currently supports the following CPU architectures:

• Android

  • arm64-v8a
  • x86_64

• iOS

  • arm64

• iOS Simulator

  • arm64 (Apple Silicon)

Add the required KEditor dependencies to your project.

dependencies {
    implementation("io.github.nesyou01:keditor:<version>")
}

Replace <version> with the latest KEditor version.

A simple video editing operation can be created using the KEditor API:

val editor = KEditor {
    removeAudio()
    
    filter(CropFilter(0.0, 0.0, 200, 200))
}

editor.process(
    input = inputPath,
    output = outputPath
)

The exact configuration can be extended with editing options such as trimming, filters, compress, and audio/video settings.

KEditor supports trimming videos using Kotlin's Duration API.

KEditor {
    trim(
        start = 10.seconds,
        end = 30.seconds
    )
}

For example, this extracts the section between 10 and 30 seconds.

KEditor provides a filter-based API for applying video effects.

Filters implement the Filter interface:

interface Filter {
    fun build(): String
}

Multiple filters can be composed and passed to the editor.

RotateFilter(
    angle = 90.0
)

A custom fill color can also be specified:

RotateFilter(
    angle = 90.0,
    fillColorHex = "#000000"
)

ScaleFilter(
    width = 1080,
    height = 1920
)

GBlurFilter(
    sigma = 10.0
)

KEditor provides a Speed configuration for modifying playback speed.

Speed(
    value = 2.0
)

For example:

0.5x → Slow motion
1.0x → Original speed
2.0x → Double speed

Audio/Video can be removed from using:

removeAudio()
removeVideo()

This can be useful when converting a video file into an audio-only output.

Long-running video operations can report their progress through ProgressCallback.

val callback = object : ProgressCallback {
    override fun onProgress(progress: Int) {
        println("Progress: $progress%")
    }
}

This allows applications to display a progress indicator while FFmpeg processes the media.

KEditor is designed to make adding new FFmpeg filters straightforward.

Implement the Filter interface:

class MyFilter : Filter {

    override fun build(): String {
        return "my_ffmpeg_filter"
    }
}

Then add the filter to your editing pipeline.

This makes it possible to expose additional FFmpeg filters without changing the core editing architecture.

KEditor is built with Kotlin Multiplatform, while FFmpeg provides the native media-processing layer.

KEditor is built using:

• Kotlin
• Kotlin Multiplatform
• FFmpeg
• Android NDK
• JNI
• Native C/C++
• Coroutines

• Video trimming
• Scaling
• Cropping
• Rotation
• Horizontal flip
• Vertical flip
• Blur
• Box blur
• EQ adjustments
• Hue
• Fade
• Text overlay
• Video speed
• Remove audio
• Remove video
• Progress reporting
• Video concatenation
• Image overlays
• Watermarks
• Audio filters
• Audio replacement
• Hardware acceleration
• More FFmpeg filters

Contributions are welcome.

If you would like to contribute:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Add tests where appropriate.
5. Open a pull request.

Built with ❤️ using Kotlin and FFmpeg.