PhotoSuite
A desktop image editor faithfully replicating classic Adobe Photoshop with 1:1 native PSD/PSB compatibility.
Quick Start •
Downloads •
Screenshots •
What This Is •
Features •
Supported Formats •
Documentation •
Building & Testing
Quick start
# Clone with submodules included
git clone --recursive https://github.com/eolix/photosuite.git
cd photosuite
# Install dependencies and start in development mode
npm install
npm run dev
Note: If already cloned without --recursive, initialise submodules before starting:
git submodule update --init --recursive
Downloads
Pre-built binary packages are available on the Releases page:
| Platform |
Package Format |
Architecture |
| macOS |
Universal .dmg |
Apple Silicon (arm64) & Intel (x86_64) |
| Linux |
.deb, .rpm |
x86_64 |
| Windows |
NSIS installer (.exe) |
x64 |
Screenshots
Click any image for the full-resolution version.
Start screen & New Project |
Layer Style |
Camera RAW develop |
Lens Correction |
Filter Gallery |
Adjustments menu |
What this is
PhotoSuite is a full-featured desktop raster and vector graphics editor designed with fidelity in mind rather than reinterpretation. Panels sit where you expect them, shortcuts match your muscle memory, dialogs expose identical fields, and tools behave exactly like the originals, right down to modifier keys. If you know Photoshop ~CS6, you already know PhotoSuite.
- PSD/PSB Native Format: PSD is the native format, not a lossy import filter. Documents round-trip cleanly through the binary format: layer records, masks, blending modes, channel data, descriptors, layer effects, smart-filter stacks, text engine data, vector paths, slices, and colour profiles. A file saved in PhotoSuite opens in Photoshop with its layer tree intact, and vice versa. PSB is supported for large documents.
- Offline-First & Private: Built as a Tauri v2 application. The editor runs HTML5, WebAssembly, and WebGL inside the system webview, backed by a lightweight Rust host for filesystem access, native menus, dialogs, clipboard, and printing. Everything stays local on your machine with zero telemetry or cloud requirements.
Disclaimer: Not affiliated with or endorsed by Adobe. Photoshop is a registered trademark of Adobe Inc., referenced here solely to describe the interface and behavioral specifications this project aims to replicate.
What this is not
Gimp. Or Affinity. I'm certain they have great features, but my goal is not to make a mega-app with a billion functions (however, feel free to create any plugins you want!) - but to offer graphic designers a legal way to edit PSDs for free.
Key features
Layer Engine & Styles:
- Raster layers, vector layers, layer groups, clipping masks, and layer masks.
- 1:1 Photoshop layer styles: Drop Shadow, Inner Shadow, Outer Glow, Inner Glow, Bevel & Emboss, Satin, Color Overlay, Gradient Overlay, Pattern Overlay, and Stroke.
- Smart Objects and Smart Filter stacks with non-destructive editing.
- Layer Comps palette and tracker.
Tools & Canvas Experience:
- Complete toolset: Marquee, Lasso, Magic Wand, Crop, Brush, Clone Stamp, Healing Brush, Eraser, Gradient, Blur/Sharpen, Dodge/Burn, Pen, Type, Shapes, Hand, Zoom, and Eyedropper.
- Full canvas panning, zooming, rotation, pixel grid, rulers, and custom guides.
- Deep History palette with snapshot support.
Filters & WebAssembly Acceleration:
- Classic Filter Gallery with multi-band runner and live thumbnails.
- Liquify with interactive mesh warping.
- Lens Correction backed by the Lensfun database.
- WebAssembly-powered image processing (blur, median, WebP encode/decode, zstd compression, etc.).
Vector Geometry & Advanced Typography:
- Vector path geometry and boolean operations powered by Paper.js.
- High-fidelity font parsing via Typr.js, complex text shaping via HarfBuzz (WASM), and bidirectional text layout via FriBidi (WASM).
- Type along path, text warp, OpenType ligatures, kerning, and character/paragraph palettes.
Automation, Scripting & Extensibility:
- Photoshop Actions (
.atn) parser and playback engine.
- JavaScript/JSX scripting engine powered by Acorn.
- Sandboxed sidebar plugins using plain HTML, CSS, and JavaScript communicating via IPC (see PLUGINS.md).
Native Desktop Integration:
- Native OS menus via Tauri.
- Direct printing support (CUPS on macOS/Linux, Windows Spooler on Windows).
- Drag-and-drop file loading and native OS file dialogs.
PhotoSuite opens and exports a comprehensive range of raster, vector, and digital design formats:
| Category |
Supported Formats |
| Native & Adobe |
PSD, PSB, Adobe Illustrator (.ai), Adobe XD (.xd) |
| Standard Raster |
PNG, APNG, JPEG, WebP, AVIF, TIFF, GIF, BMP, TGA, OpenEXR (.exr) |
| Vector & Document |
SVG, PDF, PostScript (.ps), EPS, EMF, WMF, DXF |
| Digital Design |
Sketch (.sketch), Figma (.fig), Affinity Photo/Designer (.af - WIP), GIMP (.xcf) |
| Camera RAW |
DNG, CR2, NEF, ARW, and standard camera RAW formats |
Documentation
Comprehensive architecture guides and development documentation are located in docs/:
| Document |
Description |
| docs/ARCHITECTURE.md |
Codebase architecture, module layering rules, directory layout, and design principles. |
| docs/PLUGINS.md |
Guide to writing sidebar plugins using standard HTML, CSS, and JavaScript. |
| tests/README.md |
Behavioural test suite documentation, test harness, and mocking guidelines. |
| src/vendor/README.md |
Complete third-party vendor provenance, pinned commits, upstream licenses, and build scripts. |
Building & testing
Prerequisites
- Node.js: v25 or newer
- Rust: Current stable toolchain (
rustup)
- Tauri Prerequisites: Platform dependencies for Tauri v2
Commands
npm run dev # Launch the app from source with Tauri
npm run build # Build the production application bundle for your current platform
npm test # Run the behavioral test suite (1,600+ tests)
npm run verify # Verify imports, cyclic dependencies, static bindings, and bootstrap
npm run lint # Run ESLint across src/
Automated cross-platform builds (macOS universal, Linux deb/rpm, Windows x64) are run on every release tag via GitHub Actions.
Inspiration and prior art
The primary inspiration for this project is Photopea, Ivan Kutskir's browser-based editor, which demonstrated that a desktop-class image editor with complete PSD fidelity is achievable in a web runtime. The author has also open-sourced many format libraries utilised by this project. An archive snapshot is available at ruanjiyang/Photopea-Offline.
Open source used here
Attribution and licence notices for everything bundled — vendored libraries, WebAssembly modules, icons, and the Rust crates linked into the binary — are collected in THIRD-PARTY-NOTICES.md, which ships with the application alongside its own licence.
All third-party libraries live in src/vendor/ as pinned git submodules with their respective upstream licenses:
- From the Photopea Author: UPNG.js (PNG/APNG), UTIF.js (TIFF), UZIP.js (ZIP/deflate), Typr.js (font parsing & shaping), UTEX.js (TeX typesetting). All MIT.
- Core Libraries: pako (zlib, MIT), Paper.js (vector geometry, MIT), omggif (GIF, MIT), js-sha1 (MIT), acorn (JS parser, MIT), linear-solve (MIT), parse-exr (OpenEXR, MIT), pdf.js (JPEG/JPX/JBIG2 codecs, Apache-2.0), PDFI.js (PDF/PS/EMF/WMF, MIT).
- WebAssembly Modules: HarfBuzz (text shaping, MIT), FriBidi (bidirectional text, LGPL-2.1+), libwebp (BSD-3), zstd (BSD-3), stb_image (Public domain / MIT), libheif (LGPL-3.0+).
- Data & Assets: Lensfun for camera and lens profile data (LGPL / CC), and Tabler Icons (MIT).
PhotoSuite 是一款桌面图像编辑器，致力于忠实复刻经典的 Adobe Photoshop，原生兼容 PSD/PSB 文件。