Skip to content

An easy-to-use iOS app for editing photos with layers.

Notifications You must be signed in to change notification settings

lukaszbielawski/Media-Editor

Repository files navigation

Media-Editor

The Media Editor app is a versatile tool for editing photos, built with SwiftUI, CoreData, CoreGraphics, Swift Concurrency, CoreImage, PhotoKit and Combine frameworks. It empowers users to manipulate images with ease, offering a range of editing features.

Features

  • Project Management: Create and manage multiple projects.
  • Layer Manipulation: Easily manipulate multiple layers within a project by relocating, resizing, rotating, and flipping them.
  • Filters: Apply a wide range of filters to individual layers to enhance or modify their appearance.
  • Cropping and Clipping: Crop layers to remove unnecessary parts of picture. Additionally, you can clip layers into various shapes such as ellipses or hexagons.
  • Merging: Combine multiple layers into a single layer, simplifying your project.
  • Magic Wand: Quickly select and manipulate specific areas of your image with the magic wand tool.
  • Adding Text: Insert and customize text layers with various fonts, sizes, and colors.
  • Background Editing: Resize the background canvas and change its color to suit your preferences.
  • Auto-save Feature: Your progress is automatically saved to ensure you never lose your work.
  • Undo/Redo: Seamlessly revert or reapply changes with the undo and redo feature.
  • Exporting: Export the final edited media content in format of choice to your device's photo library.

Presentation

Media-Editor-Preview-v.1.2.0-light.mp4

Requirements

  • Xcode 13.0+
  • Swift 5.5+
  • iOS/iPadOS 15.0+

Installation

  1. Clone the repository:
git clone https://github.com/lukaszbielawski/Media-Editor
  1. Open the project in Xcode.
  2. Build and run the app on a simulator or a physical device running iOS 15.0 or later.

Usage

Project Creation

  1. Launch the Media Editor app on your device.
  2. Click Plus icon to display a menu from which you can select images to start your project with.
  3. Slide the slider to create a new project with the currently selected images.

Project Management

  1. Launch the Media Editor app on your device.
  2. Select the Three dots icon to open project options sheet.
  3. You can change the current title of the project.
  4. Create a new project or open an existing one to begin editing your media content.
  5. Alternatively, you may remove the project from the disk.

Layer Manipulation

  1. When you first encounter a project, the initially selected layer will be displayed.
  2. Simply tap once on a layer to select it from the screen.
  3. A dedicated frame will appear, enabling relocation, resizing, rotation, and deletion.

Filter Application

  1. Tap once on a layer to select it from the screen.
  2. Select the Filters tool option from the toolbar.
  3. Explore a variety of filters available within the app to customize your media content.
  4. Adjust the slider to modify the filter settings if possible.
  5. A preview of the filter effect will be displayed.
  6. Press Checkmark icon to save your filter, or choose to go back to discard it.

Cropping and Layer Resizing

  1. Tap once on a layer to select it from the screen.
  2. Select the Crop tool option from the toolbar.
  3. Drag the cropping frame to select the part of the image you want to retain.
  4. Resize the cropping frame to ensure that your crop size matches your desired dimensions.
  5. You can drag the slider to set a fixed aspect ratio for the cropping frame, allowing you to retain the aspect ratio when resizing the frame.
  6. You can change the clip shape from the default rectangle to other shapes such as ellipses or hexagons.
  7. Press the Checkmark icon to perform the crop, or choose to go back to discard it.

Layer Background Editing

  1. Tap once on a layer to select it from the screen.
  2. Select the Background tool option from the toolbar.
  3. Customize the layer background color by choosing from a list of predefined colors or selecting a custom color using the system color picker.
  4. You can adjust the opacity value using the slider.
  5. A preview of the applied background color will be displayed.
  6. Press the Checkmark icon to save the background color change, or choose to go back to discard it.

Flipping image

  1. Tap once on a layer to select it from the screen.
  2. Select the Flip tool option from the toolbar.
  3. Select one of the two flipping options available, each corresponding to one axis.

Copying layer

  1. Tap once on a layer to select it from the screen.
  2. Select the Copy tool option from the toolbar.
  3. The layer will be copied and become active for further manipulation.

Adding photo to project

  1. Make sure that you do not have any layer selected, or deselect currently selected layer.
  2. Select the Add tool option from the toolbar.
  3. Click Plus icon to display a menu from which you can select images to add to your project.
  4. After selecting images, tap on the icon of the image to display it on the screen.
  5. Alternatively, you can press the Trash icon to remove it from the project.

Merging Layers

  1. Make sure that you do not have any layer selected, or deselect currently selected layer.
  2. Select the Merge tool option from the toolbar.
  3. Select layers to merge by tapping them on the screen or choose from the list of available layers below.
  4. Slide the slider to execute the merge operation.

Project Background Resizing

  1. Make sure that you do not have any layer selected, or deselect currently selected layer.
  2. Select the Resize tool option from the toolbar.
  3. Adjust the background canvas size by manipulating dedicated sliders or by entering specific dimensions into the provided text fields.

Project Background Color

  1. Make sure that you do not have any layer selected, or deselect currently selected layer.
  2. Select the Background tool option from the toolbar
  3. Customize the background color by choosing from a list of predefined colors or selecting a custom color using the system color picker.
  4. You can adjust the opacity value using the slider.

Undo/Redo

  1. Tap the Undo icon located at top of the screen to revert the most recent action.
  2. Tap the Redo icon located at top of the screen to reapply the action that was previously undone.
  3. Please note that when you exit a project, the undo/redo history will be lost.

Exporting

  1. Tap the Export labeled button located at the top right of the screen to export layers to a file.
  2. In the newly displayed view, you can see a preview of your artwork.
  3. You can choose an image format for exporting.
  4. You can select a smaller export size.
  5. Press the export button to export the final result to the device's photo library.
  6. You can continue editing a project.

License

Media-Editor by Łukasz Bielawski is licensed under CC BY-NC-ND 4.0

About

An easy-to-use iOS app for editing photos with layers.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published