Skip to content

Repository files navigation

Patchy logo

Patchy Image Editor

A free, open-source image editor for Windows, macOS, Linux, and the browser. Built with a focus on accurate PSD compatibility, keeping text, vectors, masks, layer styles, and Smart Objects editable when working with layered Photoshop files.

Download · Try in your browser · Features · Full gallery

For bug reports and feature requests, please open an issue or post in Discussions. These are the best places to post because search engines can index them, helping others find the questions and answers. Want to chat? Join Seth's Discord.

Cyclist photo with color-wheel and Levels controls, an editable Levels adjustment layer, a Smart Filter stack and shared mask, grouped text, and a clipping mask

Designed to feel familiar if you're used to Photoshop's workflows and keyboard shortcuts.

Download

Latest release: 1.04 · October 3, 2026 · Release notes · All releases

Windows releases are code signed by Seth A. Robinson; the macOS app is signed and notarized (Robinson Technologies Corporation). Every release is published on the GitHub Releases page with SHA-256 checksums, and mirrored at rtsoft.com.

Platform Package Download
Windows 10/11 (64-bit) Installer PatchyWindowsInstaller.exe (59 MB)
Windows 10/11 (64-bit) Portable ZIP (no installer) PatchyWindowsNoInstaller.zip (59 MB)
macOS 12+ (Apple Silicon) DMG - drag to Applications PatchyMacOS.dmg (64 MB)
Linux Flatpak bundle PatchyLinux.flatpak (31 MB)
Any modern browser Nothing to install patchyimageeditor.com or rtsoft.com/patchy

Mirror: the same files are also at rtsoft.com/files (PatchyWindowsInstaller.exe, PatchyWindowsNoInstaller.zip, PatchyMacOS.dmg, PatchyLinux.flatpak).

Linux one-line install (paste into a terminal; fetches the bundle and installs it for your user, pulling the shared KDE runtime from Flathub automatically, no root needed):

curl -L -o /tmp/PatchyLinux.flatpak https://github.com/SethRobinson/Patchy/releases/latest/download/PatchyLinux.flatpak && flatpak install --user -y /tmp/PatchyLinux.flatpak

Optional: opening iPhone HEIC photos on Linux uses the shared Freedesktop codec extension, which bundle installs do not fetch on their own. Patchy will show this command if it is needed:

flatpak install --user -y flathub org.freedesktop.Platform.ffmpeg-full//24.08

Screenshots

See it in action. Click an image for the full-size capture.

Layer Style and gradient color controls over layered artwork.
Build up layer effects
Layer styles with multiple effects, blending controls, and Photoshop-compatible presets.
Kai's Power Tools 5 running in its own window over Patchy. Classic 32-bit and 64-bit 8BF filters work on Windows.
Bring your old plug-ins
Kai's Power Tools 5 running in its own window over Patchy. Classic 32-bit and 64-bit 8BF filters work on Windows.
Warp a Smart Object while its embedded source stays available in another tab.
Keep the original editable
Warp a Smart Object while its embedded source stays available in another tab.
Editable paths, gradient and pattern paint, dashed strokes, rounded corners, and a Paths panel.
Edit the paths
Editable paths, gradient and pattern paint, dashed strokes, rounded corners, and a Paths panel.
Editable warped text, a paragraph with inline bold, italic, color and mixed fonts, tracked lettering, and vertical Japanese columns.
Give type its own voice
Warped text, mixed fonts and styles in one paragraph, letter spacing, and vertical Japanese.
Tilt-Shift Blur with on-image controls and live preview in the Filter Gallery.
Shape the focus
Comes with many filters and a filter gallery, like Tilt-Shift Blur with live previews.

See the full gallery for painting, palette mode, seamless textures, Camera Raw, long shadows, scripting, and more.

Features

Workflow What you get
Layered Photoshop files PSD and PSB, editable text, groups, masks, clipping, blend modes, and layer styles.
Non-destructive editing Adjustment layers, embedded and linked Smart Objects, editable Smart Filters, and shared filter masks.
Paint and retouch Pressure-aware brushes, Mixer Brush, stroke smoothing, healing, cloning, Patch, Remove Object, selections, and Liquify.
Text and vectors Rich and vertical text, paragraph controls, Warp Text, Pen paths, shape layers, vector masks, SVG, and image tracing.
PDF documents Import pages as editable text, vectors, and images on desktop; export single or multi-page PDFs with editable or flattened content.
Photos and other formats Camera Raw development, HEIC/HEIF photos, layered Affinity import, and common image formats.
Pixel art and game assets Named palettes, indexed export, seamless tiling, sprite sheets, image sequences, and animated GIFs.
Extend your workflow Legacy Photoshop filters on Windows, JavaScript scripts, batch processing, command-line tools, and local MCP control.

Full feature list and format support · Scripting guide · AI control setup

Local by design. No telemetry, tracking, or uploads of your images. The browser build runs the same editor locally through WebAssembly. Desktop builds have more memory available and add printing, scanner/camera import, and command-line automation. Optional update checks contact GitHub. Twelve interface languages, dark and light schemes, and importable themes are included.

PSD compatibility, measured

In the August 7, 2026 Testy run, Photoshop reopened all 64 Patchy saves, and all 312 text objects stayed editable. Patchy's perceptual render match was 98.83% across 63 measured files, using commit 879a3a8.

These are dated, corpus-specific results. Read the full comparison and methodology for tested versions, per-file results, preservation checks, and limitations.

Know the limits: editing is RGB/RGBA 8-bit; there is no GPU acceleration or CMYK/Lab/16-bit/32-bit editing. Unsupported Smart Filters can remain preview-locked, and Affinity import has format-specific limitations. See current compatibility.

What's New

1.04 - October 3, 2026

  • Edit shape appearance and layer styles across selected layers, with mixed-value indicators, live previews, and one undo step per edit
  • Merge selected vectors into one editable vector layer, with a preview and a choice to remove layer effects or use the effects from one source layer
  • Fixed caps on inside and outside dashed vector strokes, and pattern thumbnails in Shape Appearance
  • Windows installer: clearer status spacing and a visible version number

1.03 - October 2, 2026

  • Animated WebP import and export: open frames as layers, preview their timing, and export layers as an animation, with lossless output, partial transparency, and loop counts
  • Four more interface languages: Brazilian Portuguese, Russian, Polish, and Korean, plus translation improvements across all twelve languages
  • PSD compatibility: fixed legacy gradient fills and empty layer masks
  • Text fonts: clearer notices when an installed font cannot draw the text, and scripting warns whenever a requested font is replaced

Older releases

Photoshop plug-ins (.8bf, Windows only)

Choose Plugins > Open Plug-ins Folder, copy your .8bf files and their supporting files into it, then choose Plugins > Rescan Plug-in Folders. Both 32-bit and 64-bit filters appear under Plugins > Legacy Photoshop Plug-ins.

Filters run on the active pixel layer, respect the selection, and apply as one undoable step. A separate helper isolates plug-in crashes. Plug-ins still run with your user permissions, so install only ones you trust. KPT and other formerly full-screen filters get a bounded, movable window. Plug-in details.

Building it yourself

See build instructions for the core, Qt desktop app, macOS, Linux, and Windows packaging. Contributors and automation tools should read AGENTS.md first.

License

Patchy is released under the MIT License. Third-party runtime notices are tracked in NOTICE-THIRD-PARTY.md.

Trademark Notice

Adobe and Photoshop are either registered trademarks or trademarks of Adobe in the United States and/or other countries. Patchy is an independent project and is not authorized, endorsed, or sponsored by Adobe. References to Photoshop, its file formats (PSD, Smart Objects, Smart Filters) and its plug-in format (8BF) are only there to describe compatibility.

AI Disclosure

This project was developed with significant assistance from AI tools. I mean, you can still blame me (Seth) for bugs, but I just wanted to mention it.

Note: All included textures/materials are real images taken by humans, not AI generated

Missing features / contributions?

AI has reached the point where you can use your favorite AI to add the missing feature you want.

Just give it the link to this repo and say "Add .tiff support" and in about 10 minutes it will be done and working on your computer. Amazing, right?

I mean, that's kind of the power of open source.

Whatever AI you use, tell it (or more likely, it's reading this right now) to read AGENTS.md before doing anything else. It contains the build and repository-wide rules, then routes feature work to the relevant document under docs/.

There are 2200+ regression and benchmarking tests. AGENTS.md links agents to the testing guide that explains how to select and run them. Due to the size of some of the test files I use they aren't all included, it will skip tests that require missing files.

I probably don't want any major features coming from outside, as there are wrong and right ways to do things, some of it a bit subjective. Remember, you can always go crazy in your own fork, have some fun!

If you have a bug fix or feature you think fits this project's scope please open an issue or tweet/etc at me. If you want to submit a pull request, please look at the actual code and fully TEST IT YOURSELF before submitting, and if possible include screenshots of the actual changes so it's clear what you're doing. If you're using AI, use a good one (Fable/Astra+ class), we don't want barely working slop.

Don't trust AI to create and submit PRs with no oversight, I'll delete ones that have too much AI smell. Smell human. This is starting to sound weird but you know what I mean.

Also, note that certain features are crippled or not included due to Adobe patents. For example, our "quick select" tool doesn't update in realtime, you have to finish the stroke. We can revisit this around 2030 when the patents expire...

Credits

Created by Seth A. Robinson - Homepage | Blog | Twitter | Bluesky | Mastodon

Code contributions from mcapogna, csbun, ifloppy, and lucastucious

Photo "akiko_cycling_okinawa" (seen in the screenshots) by Seth A. Robinson

About

Open-source image editor focused on PSD compatibility and workflows familiar to Adobe Photoshop users.

Topics

Resources

Stars

444 stars

Watchers

4 watching

Forks

Releases

Contributors

Languages