Guide · Open source
How to use Compositor: install, layers and key tools
Updated · written with AI from the project's own documentation and checked against our catalogue data
Compositor is a free, open source image editor for Mac that aims to cover the layer-based workflow people use in Photoshop. This guide is for Mac users who want to try it, and it walks through installing it, the main tools and how to export your work. After reading it you should be able to install Compositor, set up a layered project, make selections and retouch, and export a finished image.
Quick start
- 1Check your Mac. Confirm you have an Apple silicon Mac running macOS 26.0 or later.
- 2Install the app. Download Compositor from robbietilton.com/compositor or GitHub Releases, or run the Homebrew cask command from the README.
- 3Create or open a project. Open a project and import images as JPEG, PNG, HEIC, TIFF, WebP, SVG, PDF, GIF, camera RAW or PSD files.
- 4Build with layers. Stack images into layers and folders, and set opacity and blend modes.
- 5Select and retouch. Use the selection tools, Brush, Spot Healing Brush and Clone Stamp to refine the image.
- 6Export. Use Export PNG, Export JPEG or Export As to save the finished file.
Check the requirements before you install
Compositor runs on macOS 26.0 or later on a Mac with Apple silicon. The author's README says it is macOS only, so Windows and Linux users should look at the unofficial ports listed in the README, which the author does not review or support.
Intel Macs and older macOS versions are not covered by the README's requirements.
- macOS 26.0 or later
- A Mac with Apple silicon
- Xcode 26 or later, only if you want to build from source
Install Compositor on macOS
You can download the latest release from the author's site at robbietilton.com/compositor, or from the GitHub Releases page for the project. The README also gives a Homebrew command for installing the app as a cask.
- Download from robbietilton.com/compositor or GitHub Releases
- Or install with Homebrew using the command shown here
brew install --cask robbietilton-compositorWork with layers, masks and blend modes
Compositor is built around layers and folders. Each layer has opacity and Photoshop's full set of blend modes, and a folder's opacity dims everything inside it. Layer masks can be painted, filled, inverted, blurred and feathered, and they can extend past the layer's own pixels.
Layer effects such as Drop Shadow, Stroke and Outer Glow stay editable at any time. You can merge layers with Merge Down (⌘E for Merge Layers and Merge Group as well) and duplicate, rename, reorder or nest layers by drag and drop.
- Layers and folders with opacity and blend modes
- Layer masks, clipping masks and folder masks
- Adjustment and filter layers
- Merge Down, Merge Layers and Merge Group (⌘E)
- Copy and paste whole layers or folders with ⌘C and ⌘V
Make selections and transform layers
The selection tools include Rectangle and Ellipse Marquee, Freehand and Polygonal Lasso, and the Magic tool, where Wand selects by color and Object traces whatever you click. Tab switches between them. You can also use Select Subject, and Expand, Contract or Feather any selection.
Transforms are non-destructive, so images keep their full resolution. You can move, scale, rotate and flip layers, use free distort with ⌘-drag on a handle, and align or distribute layers from the Move tool's bar or the Layer menu.
- Marquee, Lasso and Magic selection tools
- Select Subject and Expand, Contract or Feather
- Free distort with ⌘-drag, Shift to lock to an axis
- Snapping to canvas and layer edges, plus guides
Paint, retouch and add text
The Brush has adjustable size, hardness, opacity and smoothing, and switches between Paint and Erase with B and E. Shift draws straight lines. If you use a graphics tablet, pen pressure can control the Brush's size and opacity.
Retouching tools include the Spot Healing Brush, Clone Stamp and Blur tool. The Type tool (T) supports multiline text in paragraph boxes, and text can be used as a clipping mask.
- Brush with Paint and Erase modes (B and E)
- Spot Healing Brush and Clone Stamp
- Gradient tool and Shape tool with editable shapes
- Type tool (T) with paragraph boxes
Use adjustments, filters and export your image
Adjustments include Levels, Curves, Hue/Saturation, Exposure and Color Balance, and the Camera Raw filter provides light, color and detail controls in a panel beside the canvas. Filters include Gaussian Blur, Sharpen, Vignette and Lens Effects. Live previews are limited to the selection when there is one.
To save your work as an image, use Export PNG (⇧⌘E), Export JPEG (⇧⌥⌘S) or Export As (⇧⌥⌘W). Export As can also produce a one-page PDF or an animated GIF when a GIF layer is present.
- Export PNG: ⇧⌘E
- Export JPEG: ⇧⌥⌘S
- Export As: ⇧⌥⌘W, for PNG, JPEG, PDF or animated GIF
What people use it for
- Compositing several photos into one image using layers and masks
- Post-processing photos with Camera Raw, Curves and Levels adjustments
- Making game textures with Channel Pack in Export As
- Editing Photoshop PSD files, with the conversion report shown before changes are applied
- Reading or modifying the editor's Xcode source
Frequently asked questions
Is Compositor free?
Yes. The README describes it as completely free and open source, and the project is licensed under the MIT license.
What are the system requirements for Compositor?
The README requires macOS 26.0 or later on a Mac with Apple silicon. Intel Macs and older macOS versions are not covered.
Does Compositor work on Windows or Linux?
The author says Compositor is macOS only. Unofficial ports exist for Windows and Linux, but they are made by others and not supported by the author.
How do I install Compositor with Homebrew?
Run brew install --cask robbietilton-compositor in Terminal, as shown in the README. You can also download the app from the author's site or GitHub Releases.
Can Compositor open Photoshop files?
Yes, it can import Photoshop PSD and PSB files at 8-bit RGB. The README says CMYK is not supported, so print workflows that need CMYK are not a good fit.
How does Compositor compare to GIMP or Photopea?
The author built Compositor to feel closer to Photoshop than GIMP, with Photoshop-style layout and shortcuts. The README does not compare it to Krita, Photopea or Affinity Photo, so check those directly if you need a feature comparison.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Compositor suits Mac users with Apple silicon who want a free, Photoshop-style editor for compositing and photo post-processing, or developers who want to change its source. If you use Windows or Linux, need CMYK for print, or run an Intel Mac or older macOS, pick another editor such as GIMP, Krita, Photopea or Affinity Photo.
Install options & downloads