A fully-featured Android photo editor library with drawing shapes, text stickers, image stickers, filters, crop, undo/redo, and more. Built in Kotlin.

Forked from burhanrashid52/PhotoEditor with significant enhancements.

• Shapes — Draw brush strokes, lines, arrows, ovals, and rectangles with customizable color, stroke width, stroke style (solid / dashed / dotted), and fill color (oval & rect)
• Text stickers — Add and edit text with custom color, font family, font size, and background color
• Image stickers — Add images/stickers from URLs or local paths
• Emoji — Insert emoji with custom fonts
• Filters — Apply built-in photo filters
• Crop — Free-style crop powered by uCrop
• Undo / Redo — Full history for all operations including crop, filter, shape changes, color changes, and transforms
• Duplicate — Duplicate any selected view
• Pinch to scale and rotate — Works on all graphic elements
• Selection — Tap to select, tap outside to deselect; palette/delete/duplicate buttons auto-enable based on selection state

Add JitPack to your project-level build.gradle:

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Add the dependency in your app-level build.gradle:

implementation 'com.github.virtualspirit:AndroidPhotoEditor:v3.1.8'

Add PhotoEditorView to your layout:

<com.virtualspirit.photoeditor.PhotoEditorView
    android:id="@+id/photoEditorView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:photo_src="@drawable/your_image" />

Build a PhotoEditor instance:

val photoEditor = PhotoEditor.Builder(this, photoEditorView)
    .setPinchTextScalable(true)
    .build()

val shapeBuilder = ShapeBuilder()
    .withShapeType(ShapeType.Oval)
    .withShapeColor(Color.RED)
    .withShapeSize(25f)
    .withStrokeStyle(StrokeStyle.SOLID)
    .withFillColor(Color.YELLOW) // oval and rect only

photoEditor.setShape(shapeBuilder)
photoEditor.setBrushDrawingMode(true)

Shape types: ShapeType.Brush, ShapeType.Line, ShapeType.Arrow(), ShapeType.Oval, ShapeType.Rectangle

Stroke styles: StrokeStyle.SOLID, StrokeStyle.DASHED, StrokeStyle.DOTTED

val style = TextStyleBuilder()
    .withTextColor(Color.WHITE)
    .withTextSize(18f)

photoEditor.addText("Hello", style)

photoEditor.addEmoji("😊")

photoEditor.addImage(bitmap)

photoEditor.setFilterEffect(PhotoFilter.BRIGHTNESS)

Crop is handled by the activity via uCrop and is part of the undo/redo history.

photoEditor.undo()
photoEditor.redo()

lifecycleScope.launch {
    val result = photoEditor.saveAsFile(filePath)
    if (result is SaveFileResult.Success) {
        // saved
    }
}

The library ships a ready-to-use EditImageActivity that can be launched via intent:

val intent = Intent(context, EditImageActivity::class.java)
intent.putExtra("path", imagePath)
intent.putExtra("targetPath", outputPath)
intent.putExtra("tools", arrayOf("draw", "line", "arrow", "circle", "square", "clip", "textSticker", "imageSticker", "filter", "pointer"))
startActivityForResult(intent, REQUEST_CODE)

• uCrop — crop
• Glide — image loading

See PUBLISH.md for step-by-step instructions on bumping the version, building the AAR locally, and releasing a new version via GitHub Actions + JitPack.

MIT — Copyright (c) virtualspirit