Thanks to visit codestin.com
Credit goes to github.com

Skip to content

mirarr-app/editt

Repository files navigation

Editt - Photo Editor & Viewer

A fast and feature-rich photo editing and viewing application for Linux desktop, built with Flutter.

Features

Image Viewing

  • Fast image loading with zoom and pan capabilities
  • Support for multiple image formats (JPG, PNG, WebP, GIF, BMP)
  • Responsive layout optimized for desktop window resizing
  • Interactive viewer with pinch-to-zoom and pan gestures

Omarchy Linux Integration

  • Dynamic Theme Support: Automatically adapts the app's color scheme to match your current Omarchy Linux theme
  • Reads the active theme from omarchy-theme-current command
  • Updates colors in real-time when you change themes (checks every 2 seconds)
  • Supports Yaru color variants: blue, red, green, yellow, purple, orange, pink, teal, cyan, indigo, lime, amber, brown, grey, magenta, sage, and olive
  • Gracefully falls back to default blue theme on non-Omarchy systems

Image Editing

  • Crop: Crop images with various aspect ratio options
  • Rotate: Rotate images at any angle
  • Flip: Flip images horizontally or vertically
  • Filters: Apply various filters and adjustments
  • Paint/Draw: Draw and paint on images
  • Text: Add text overlays
  • Stickers & Emojis: Add stickers and emojis

Advanced Options

  • Format Conversion: Convert between JPG, PNG, and WebP formats
  • Resolution Reduction: Scale down image dimensions
  • Quality Adjustment: Lower image quality to reduce file size
  • Save Options: Choose to save as a new file or overwrite the original

Installation

Prerequisites

  • Flutter SDK (3.5.3 or higher)
  • Linux desktop environment

Setup

  1. Clone the repository

  2. Install dependencies:

    flutter pub get
  3. Build and run:

    flutter run -d linux

Usage

Opening Images

Method 1: File Picker (GUI)

  1. Launch the application
  2. Click the "Open Image" button
  3. Select an image from the file picker dialog

Method 2: Command Line

You can open an image directly from the command line:

flutter run -d linux imagename.jpg

Or after building:

./build/linux/x64/release/bundle/editt /path/to/image.jpg

Editing Images

  1. Once an image is loaded in the viewer, click the "Edit Image" button
  2. Use the built-in tools to edit your image:
    • Crop, rotate, flip
    • Apply filters
    • Draw or add text
    • Add stickers/emojis
  3. Click the settings icon (top-right) for advanced options:
    • Change output format
    • Adjust image quality
    • Reduce resolution
  4. When finished, click the save/done button
  5. Choose whether to save as a new file or overwrite the original

Project Structure

lib/
├── main.dart                    # App entry point with command-line args
├── screens/
│   ├── viewer_screen.dart       # Image viewing screen
│   └── editor_screen.dart       # Image editing screen
├── services/
│   ├── image_service.dart       # Image processing utilities
│   ├── file_service.dart        # File operations
│   └── theme_service.dart       # Omarchy theme detection
└── widgets/
    ├── image_viewer.dart        # Image display widget
    └── save_dialog.dart         # Save options dialog

Dependencies

  • pro_image_editor - Comprehensive image editing features
  • file_picker - File selection dialog
  • image - Image format conversion and manipulation
  • path_provider - File path handling
  • path - Path utilities

Building for Release

To build a release version:

flutter build linux --release

The executable will be located at:

build/linux/x64/release/bundle/editt

License

This project is licensed under the MIT License.

About

Beautiful Image Viewer and Editor. With Omarchy styling support!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published