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.05 · October 4, 2026 · Release notes · All releases

Windows releases are code signed by Seth A. Robinson; the macOS app is signed and notarized (Robinson Technologies Corporation); the Linux Flatpak repository is GPG signed. Every release is published on the GitHub Releases page with SHA-256 checksums.

Platform Package Download
Windows 10/11 (64-bit) Installer PatchyWindowsInstaller.exe (65 MB)
Windows 10/11 (64-bit) Portable ZIP (no installer) PatchyWindowsNoInstaller.zip (65 MB)
macOS 12+ (Apple Silicon) DMG - drag to Applications PatchyMacOS.dmg (70 MB)
Linux (x86_64) Flatpak, from our repository The command below, or com.rtsoft.patchy.flatpakref
Linux (x86_64) Flatpak bundle (single file) PatchyLinux.flatpak (35 MB)
Any modern browser Nothing to install patchyimageeditor.com or rtsoft.com/patchy

Linux

Paste this into a terminal. It installs Patchy for your user from the Patchy Flatpak repository and pulls the shared KDE runtime from Flathub. No root needed.

flatpak install --user -y https://rtsoft.com/flatpak/com.rtsoft.patchy.flatpakref

Patchy then updates with flatpak update or through your software center, and starts from your application menu or with flatpak run com.rtsoft.patchy.

This needs the flatpak tool. If needed, install it first with sudo apt install flatpak.

The .flatpakref link in the table downloads a small file that a Flatpak-aware software center (GNOME Software, KDE Discover) can open to install Patchy. Ubuntu has none by default, and on Ubuntu 24.04 GNOME Software's Open button fails to start Flatpak apps, so use the terminal command above instead.

The single-file bundle is the same build, for when you would rather download a file first. Install it with flatpak install --user -y PatchyLinux.flatpak. It still fetches the KDE runtime from Flathub, and it updates from the same repository afterwards.

My flatpak knowledge is limited, so I hope all this makes sense. I hope to submit Patchy to Flathub eventually, but for now we have our own repository.

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.05 - October 4, 2026

  • Linux: Patchy now updates through flatpak update and the software center, from a signed Flatpak repository (issue 28). The Flatpak moved to the current KDE runtime, and iPhone HEIC photos open without installing an extra codec package
  • Open from Clipboard: File > Open from Clipboard (Ctrl+Alt+Shift+N) opens the copied image as a new document
  • Clicking a palette swatch recolors the selected text and shape layers (issue 61)
  • Type tool: pressing on a text layer and dragging selects text in one gesture, without a second click to enter editing first
  • Windows installer: Patchy now appears under Explorer's "Open with" for the image types it opens, without changing any default program
  • Fixed a freeze on KDE when a drag crossed the layer action buttons (issue 62)

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

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, Illustrator, 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.

Affinity is a trademark of Canva and its subsidiary Serif (Europe) Ltd. Patchy is not affiliated with, authorized, endorsed, or sponsored by Canva or Serif; Affinity is named only to describe which files Patchy can import.

All other product and company names, including Aseprite, Kai's Power Tools, Windows, macOS, and Linux, are trademarks of their respective owners. They are used only to identify file formats, plug-ins, and platforms Patchy works with, and no endorsement is implied.

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 agent to add the missing feature you want.

Just give it the link to this repo and say "Add .tiff support" and after a bit, it will be done and working on your computer. Amazing, right?

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

Whatever AI you use (the smarter the better), 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 2600+ 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

454 stars

Watchers

4 watching

Forks

Releases

Contributors

Languages