Skip to main content

photo_editor_studio 1.0.0 copy "photo_editor_studio: ^1.0.0" to clipboard
photo_editor_studio: ^1.0.0 copied to clipboard

A modern & professional Flutter photo editor library for editing images with filters, cropping, adjustments, drawing, text, and stickers across all platforms.

#1 Flutter Library — photo_editor_studio Golden Award Badge

photo_editor_studio

A modern & professional studio-grade Flutter photo editor library
24 categorized color filters, 14 precision adjustments with live RGB histogram, interactive split-screen before/after comparison, cropping, straightening, vector markup & privacy blur, typography layers with magnetic snap guides, studio badges, and museum/Polaroid frames across Android, iOS, macOS, Windows, Linux & Web (WASM) — with zero external runtime dependencies.

pub package pub points 160/160 License: MIT Supported by Humanize AI


Live Real-UI Studio Showcase #

photo_editor_studio automatically adapts between a sleek 3-pane Desktop Studio (left navigation rail, zoomable darkroom canvas with live split-screen curtain & magnetic snap guides, right precision inspector with live RGB histogram) and a thumb-friendly Mobile Studio layout, in both Dark and Light themes.

Desktop Studio Frame #

photo_editor_studio running live in Desktop Studio frame

Mobile Frame #

photo_editor_studio running live in Mobile frame


Pro-Studio Feature Matrix #

Studio Module Capabilities
24 Categorized Color Filters Organized into All, Vivid, Cinema, Film, B&W, and Moody (Vivid, Warm, Cool, Velvia, Cinematic, Teal Gold, Dramatic, Golden, Midnight, Portra, Gold 400, Fade, Vintage, Retro 70s, Nordic, Pastel, Dreamy, Forest, Cyber, Mono, Noir, Silver, Sepia, Original) with live thumbnails, 0–100% intensity blending, and custom 4×5 matrix filter support.
14 Precision Adjustments + Live RGB Histogram Real-time Exposure, Brightness, Contrast, non-linear GPU Highlights & Shadows, Saturation, skin-tone-aware Vibrance, Warmth, Tint, Clarity, Fade, Radial Vignette, Analog Film Grain, and resolution-scaled Gaussian Blur — paired with a live 64-bin RGB & Luminance Histogram on desktop.
Interactive Split-Screen Compare Draggable Before / After Split Curtain directly on the canvas with BEFORE / AFTER pills plus full-original preview toggle.
Crop, Rotate, Flip & Straighten Interactive 8-handle + interior drag crop frame with rule-of-thirds grid, live pixel dimension badge, aspect ratios (Free, Original, 1:1, 4:3, 3:2, 16:9, 4:5, 9:16), 90° left/right rotation, horizontal/vertical mirror, and -45°..+45° fine straightening with exact automatic corner-fill zoom.
8 Markup & Privacy Blur Tools Smooth quadratic Bézier Pen, translucent Marker, straight Line, vector Arrow, Box, solid Fill Box, Oval, and non-destructive Privacy Blur redaction regions stored in resolution-independent normalized coordinates.
Typography, Layers & Smart Snap Guides Multi-line Text overlays (Plain, Solid, Glass, Outline pills, bold/italic, alignment, letter spacing/tracking, line height, opacity, shadow) plus Stickers & crisp cross-platform Studio Vector Badges (RAW, PRO, 4K, HDR, NEW, LIVE, 35MM, 100%) with magnetic center snap alignment guides, visibility toggles, Z-order reordering, duplication, and arrow-key nudging.
Studio Frames & Borders Minimal, museum Gallery mat, classic Polaroid, widescreen Cinema letterbox, and Rounded Card frames with customizable colors, border thickness, and inner corner radius rendered identically in preview and export.
Zero-Dependency WYSIWYG Export Shared PhotoSceneRenderer pipeline guarantees pixel-identical output across PNG, built-in pure-Dart baseline JPEG (quality: 1..100), and Raw RGBA, with optional maxWidth/maxHeight bounds across all 6 Flutter platforms + WebAssembly (WASM).

Installation #

Add photo_editor_studio to your pubspec.yaml:

dependencies:
  photo_editor_studio: ^1.0.0

Or install via CLI:

flutter pub add photo_editor_studio

Quick Start #

1. Open as a Full-Screen Route #

The fastest way to integrate photo_editor_studio is PhotoEditor.open, which returns a PhotoEditorResult? (null if cancelled):

import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:photo_editor_studio/photo_editor_studio.dart';

Future<void> editPhoto(BuildContext context, Uint8List imageBytes) async {
  final PhotoEditorResult? result = await PhotoEditor.open(
    context,
    bytes: imageBytes,
    config: PhotoEditorConfig(
      theme: PhotoEditorTheme.dark(accentColor: const Color(0xFF4F8BFF)),
      exportOptions: const PhotoExportOptions(
        format: PhotoExportFormat.jpeg,
        jpegQuality: 92,
        maxWidth: 2048,
      ),
    ),
  );

  if (result != null) {
    // result.bytes  -> Uint8List (PNG / JPEG / Raw RGBA)
    // result.width  -> Exported pixel width
    // result.height -> Exported pixel height
    // result.state  -> Non-destructive PhotoEditState (serializable via toJson())
  }
}

2. Embed Directly in Your Widget Tree #

Edit from memory bytes, any Flutter ImageProvider (AssetImage, NetworkImage, MemoryImage), or a pre-decoded ui.Image:

PhotoEditor.provider(
  const AssetImage('assets/sample.jpg'),
  config: PhotoEditorConfig(
    theme: PhotoEditorTheme.light(),
    enableSplitCompare: true,
    enableSnapGuides: true,
    showHistogram: true,
  ),
  onComplete: (PhotoEditorResult result) {
    // Handle exported bytes & edit state
  },
  onCancel: () => Navigator.of(context).pop(),
)

3. Headless / Programmatic Editing & JSON State Persistence #

Save drafts, build batch processors, or create custom UIs around PhotoEditorController and PhotoExportEngine:

final controller = PhotoEditorController()
  ..selectFilter(PhotoFilters.tealOrange)
  ..setFilterIntensity(0.85)
  ..setAdjustment(PhotoAdjustmentType.contrast, 0.20)
  ..setAdjustment(PhotoAdjustmentType.shadows, 0.18)
  ..setAdjustment(PhotoAdjustmentType.vignette, 0.35)
  ..setFrameStyle(PhotoFrameStyle.polaroid)
  ..addTextLayer(text: 'MORNING LIGHT', letterSpacing: 2.0)
  ..addBadgeLayer('RAW 4K');

// Persist non-destructive edit state as JSON
final Map<String, dynamic> savedDraft = controller.state.toJson();

// Restore later
final restoredState = PhotoEditState.fromJson(savedDraft);

// Export headless at full resolution
final PhotoEditorResult exported = await PhotoExportEngine.export(
  image: decodedUiImage,
  state: restoredState,
  options: const PhotoExportOptions(
    format: PhotoExportFormat.png,
  ),
);

4. Custom Color Filters & Custom Labels / Localization #

const customFilter = PhotoFilter(
  id: 'emerald_film',
  name: 'Emerald',
  category: PhotoFilterCategory.film,
  matrix: <double>[
    0.92, 0.04, 0.00, 0, -4,
    0.00, 1.12, 0.02, 0,  4,
    0.00, 0.06, 1.04, 0,  6,
    0.00, 0.00, 0.00, 1,  0,
  ],
);

final config = PhotoEditorConfig(
  filters: <PhotoFilter>[...PhotoFilters.presets, customFilter],
  labels: const PhotoEditorLabels(
    title: 'Studio Editor',
    done: 'Save Photo',
    cancel: 'Discard',
    cropTab: 'Crop',
    filtersTab: 'Presets',
    adjustTab: 'Tone',
    drawTab: 'Markup',
    textTab: 'Type',
    stickersTab: 'Badges',
    framesTab: 'Borders',
  ),
);

Desktop & Web Keyboard Shortcuts #

Shortcut Action
Cmd / Ctrl + Z Undo
Cmd / Ctrl + Shift + Z or Ctrl + Y Redo
Cmd / Ctrl + 0 Reset zoom to 100% (Fit)
\ Toggle Split-Screen Before / After Comparison
Arrow Keys Fine-nudge selected text, sticker, or badge layer
Delete / Backspace Delete selected overlay layer
Escape Clear overlay selection

Support #

This library is proudly supported by Humanize AI.

If photo_editor_studio powers your Flutter apps, please star the repository on GitHub, open issues or feature requests in the issue tracker, and visit Humanize AI.


License #

Released under the MIT License.

1
likes
150
points
--
downloads
screenshot

Documentation

API reference

Publisher

verified publisherhumanize.id

A modern & professional Flutter photo editor library for editing images with filters, cropping, adjustments, drawing, text, and stickers across all platforms.

Repository (GitHub)
View/report issues

Topics

#photo-editor #image-editor #image-cropper #image-filters #flutter

Funding

Consider supporting this project:

humanize.id

License

MIT (license)

Dependencies

flutter

More

Packages that depend on photo_editor_studio