A powerful, feature-rich video editing application built with Flutter that provides professional-grade video editing capabilities on mobile devices. This is a modernized fork of open_director, completely migrated to Flutter 3.35.1 with null safety support and updated to use the latest dependencies.

📱 Screenshots & Demo

Screenshots coming soon...

✨ Features

🎥 Video Editing Capabilities

Multi-layer Timeline: Support for video, audio, image, and text layers
Video Trimming & Cutting: Precise frame-level video cutting and trimming
Video Merging: Combine multiple video clips seamlessly
Ken Burns Effect: Animated zoom and pan effects for images
Multiple Resolution Support: Export videos in various resolutions (SD, HD, etc.)
Real-time Preview: Live preview of edits with smooth playback

🖼️ Media Support

Video Import: Support for various video formats
Image Integration: Add images with smooth transitions
Font Library: 20+ beautiful fonts for text overlays
Custom Text: Rich text editing with positioning, colors, and effects

🎨 Advanced Editing Features

Layer Management: Independent control of video, audio, image, and text layers
Asset Management: Organized project structure with thumbnail generation
Timeline Navigation: Precise timeline scrubbing and positioning
Project Persistence: Save and resume projects with SQLite database

🚀 Modern Technical Features

Null Safety: Full null safety migration for better reliability
FFmpeg Integration: Powered by ffmpeg_kit_flutter_new for video processing
Reactive Architecture: Built with RxDart for responsive UI updates
State Management: Clean service locator pattern with GetIt
Modern Dependencies: All packages updated to latest stable versions

🛠️ Technical Architecture

graph TB
    A[User Interface] --> B[Director Service]
    B --> C[Layer Player]
    B --> D[Generator Service]
    B --> E[Project Service]
    E --> F[SQLite Database]
    D --> G[FFmpeg Kit]
    C --> H[Video Player]
    I[File System] --> J[Asset Management]
    J --> B
    
    subgraph "Core Services"
        B
        E
        D
    end
    
    subgraph "Data Layer"
        F
        I
    end
    
    subgraph "Media Processing"
        G
        H
    end
    
    %% Color coding by layer
    %% Presentation Layer - Blue
    classDef presentation fill:#e1f5fe,stroke:#0277bd,stroke-width:2px,color:#000
    class A presentation
    
    %% Core Services - Green
    classDef core fill:#e8f5e8,stroke:#2e7d32,stroke-width:2px,color:#000
    class B,D,E core
    
    %% Business Logic/Processing - Orange
    classDef processing fill:#fff3e0,stroke:#f57c00,stroke-width:2px,color:#000
    class C,J processing
    
    %% Data Layer - Purple
    classDef data fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000
    class F,I data
    
    %% Media/External - Red
    classDef media fill:#ffebee,stroke:#c62828,stroke-width:2px,color:#000
    class G,H media

📋 Video Editing Workflow

flowchart LR
    A[Create Project] --> B[Import Media]
    B --> C[Add to Timeline]
    C --> D[Edit & Trim]
    D --> E[Add Text/Effects]
    E --> F[Preview]
    F --> G{Satisfied?}
    G -->|No| D
    G -->|Yes| H[Export Video]
    H --> I[Save to Gallery]

🚀 Getting Started

Prerequisites

Flutter SDK (3.35.1 or later)
Dart SDK (3.9.0 or later)
Android Studio / VS Code
Android SDK (for Android builds)
Xcode (for iOS builds)

Installation

Clone the repository

git clone https://github.com/ShishirRijal/Flutter-Video-Editor-App.git
cd Flutter-Video-Editor-App

Install dependencies
```
flutter pub get
```
Run the app
```
flutter run
```

Platform-specific Setup

Android

Minimum SDK: API 21 (Android 5.0)
Permissions: Storage, Camera (automatically handled)

iOS

Minimum iOS: 11.0
Permissions: Photo Library, Camera (automatically handled)

📱 How to Use

Creating a New Project

Launch the app and tap "Create New Project"
Enter project name and description
Start adding media assets to your timeline

Adding Media

Videos: Tap the video icon to import video files
Images: Tap the image icon to add photos
Audio: Tap the audio icon to add background music
Text: Tap the text icon to add text overlays

Editing Videos

Trim: Select a video asset and use the trim handles
Cut: Position the playhead and tap the cut button
Delete: Select an asset and tap the delete button
Move: Drag assets along the timeline

Text Editing

Tap any text asset to edit content
Customize font, size, color, and position
Add borders, shadows, and background boxes

Exporting

Tap the save button in the app bar
Choose your desired resolution
Wait for processing to complete
Find your video in the generated videos list

🎯 Project Status

✅ Completed Features

✅ Video import and basic editing
✅ Image import with Ken Burns effects
✅ Video trimming and cutting
✅ Timeline management
✅ Project persistence
✅ Video export in multiple resolutions
✅ Text overlay system
✅ Multi-layer support
✅ Real-time preview

🚧 Work in Progress

🔄 Audio editing and mixing improvements
🔄 Advanced text effects and animations
🔄 More transition effects
🔄 Performance optimizations

📝 Planned Features

🎵 Advanced audio editing and mixing
🎨 More visual effects and filters
📱 Better mobile UI/UX optimizations
🔄 More video transition effects
📊 Performance analytics and optimization

🏗️ Architecture & Technical Details

Core Components

Director Service

The main orchestrator that manages:

Timeline state and playback
Asset management and manipulation
Layer coordination
UI state synchronization

Generator Service

Handles video processing:

FFmpeg command generation
Video rendering and export
Format conversion and optimization
Background processing management

Layer System

Three-layer architecture:

Layer 0: Raster layer (videos and images)
Layer 1: Vector layer (text and graphics)
Layer 2: Audio layer (background music and sound)

Dependencies

Package	Version	Purpose
`ffmpeg_kit_flutter_new`	^3.2.0	Video processing engine
`video_player`	^2.9.2	Video playback
`sqflite`	^2.4.2	Local database
`rxdart`	^0.28.0	Reactive programming
`file_picker`	^10.3.2	File selection
`path_provider`	^2.1.5	Directory access

🤝 Contributing

We welcome contributions! This project is actively maintained and open to pull requests.

How to Contribute

Fork the repository

Create a feature branch

git checkout -b feature/amazing-feature

Make your changes
Write tests (if applicable)

Commit your changes

git commit -m 'Add some amazing feature'

Push to the branch

git push origin feature/amazing-feature

Open a Pull Request

Development Guidelines

Follow Flutter/Dart best practices
Maintain null safety compliance
Add documentation for new features
Test on both Android and iOS
Update README if needed

Areas for Contribution

🎵 Audio editing improvements
🎨 New visual effects
📱 UI/UX enhancements
🔧 Performance optimizations
📖 Documentation improvements
🧪 Test coverage
🐛 Bug fixes

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Original project: open_director by jmfvarela
Flutter team for the amazing framework
FFmpeg team for the powerful video processing library
All contributors and community members

🚀 Migration Notes

This fork includes several major improvements over the original:

Technical Upgrades

✅ Flutter 3.35.1: Latest stable Flutter version
✅ Null Safety: Complete null safety migration
✅ Modern Dependencies: All packages updated to latest versions
✅ FFmpeg Kit: Migrated from deprecated flutter_ffmpeg to ffmpeg_kit_flutter_new

Code Improvements

✅ Better Error Handling: Comprehensive error handling and logging
✅ Performance: Memory management and performance optimizations
✅ Code Quality: Improved code structure and documentation
✅ Type Safety: Enhanced type safety throughout the codebase

Built with ❤️ using Flutter

Ready to create amazing videos? Download and start editing today!