photosuite README

The project's README from github.com/eolix/photosuite. As one markdown file: README.md.

PhotoSuite Logo

PhotoSuite

A desktop image editor faithfully replicating classic Adobe Photoshop with 1:1 native PSD/PSB compatibility.

Build Status Tauri v2 Platform Support Open Source

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 and New Project
Start screen & New Project		 Layer Style
Layer Style		 Camera RAW develop
Camera RAW develop
Lens Correction
Lens Correction		 Filter Gallery
Filter Gallery		 Adjustments menu
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.

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

Supported formats

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

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:

photosuite (eolix/photosuite)

Searching Database…

1.2K ·GitHub
Photosuite
Что это?PhotoSuite — настольный редактор изображений, созданный, чтобы точно воспроизвести классический Adobe Photoshop, с нативной совместимостью с файлами PSD/PSB.
Это нативное десктоп-приложение или оно работает в браузере?Это нативное десктоп-приложение на Tauri v2: интерфейс редактора работает как HTML5/WebAssembly/WebGL внутри системного webview, а лёгкий хост на Rust отвечает за доступ к файловой системе, нативные меню, диалоги и печать.
Как его запустить?Возьмите готовый пакет со страницы Releases (Universal .dmg для macOS, .deb/.rpm для Linux, NSIS .exe для Windows) или склонируйте репозиторий с --recursive и соберите сами с помощью инструментария Tauri.
Каким редактором он не пытается быть?Он явно не стремится стать мега-приложением в духе GIMP или Affinity, забитым всеми возможными функциями; цель — просто дать дизайнерам бесплатный и легальный способ редактировать настоящие PSD-файлы, а дополнительную функциональность оставить плагинам.
Отправляются ли мои данные при редактировании с моего компьютера?Нет, всё работает локально, без телеметрии и без требований к облаку, поскольку проект сделан с расчётом на офлайн-режим и приватность.
Поддерживает ли PhotoSuite плагины или скрипты?Да, в нём есть движок скриптов JavaScript/JSX на базе Acorn, он умеет разбирать и воспроизводить файлы Photoshop Actions (.atn) и поддерживает изолированные плагины боковой панели на обычном HTML/CSS/JS, которые общаются с хостом через IPC.
Какие форматы файлов он открывает помимо PSD?Широкий набор: стандартные растровые форматы (PNG, JPEG, WebP, TIFF, GIF, BMP...), векторные и документные форматы (SVG, PDF, Adobe Illustrator, EPS, DXF...), файлы дизайнов (Sketch, Figma, GIMP XCF) и камерные RAW-форматы вроде DNG, CR2, NEF и ARW.
Поддерживается ли неразрушающее редактирование?Да, смарт-объекты и стеки смарт-фильтров неразрушающие, есть развитая палитра History с поддержкой снимков плюс палитра Layer Comps для отслеживания вариантов дизайна.
Что вдохновило этот проект?Автор называет главным вдохновением Photopea — браузерный PSD-редактор Ивана Куцкира, который уже выложил в open source многие библиотеки форматов, переиспользуемые PhotoSuite.
What are similar projects?photocraft, lightcraft, vectorcraft, pdfcraft, figcraft, PhotoGIMP, rembrandt, effectcraft
Which topics is it in?photo-editor, vector-graphics, webassembly, image-editing, typography, tauri, svg, plugin-system, graphics, wasm, design, image-processing
Creator
eolix
Size
93.8 MB
Stars
1.2K
Updated
CommitOct 14Releasev0.9.21Oct 14
Age
5mo
Commits · 90 Days