NekoPhoto

Bring your work with you.
A kawaii photo editor and painting app for Linux and Windows that opens your Photoshop and Clip Studio files
with their layers, masks and text intact, paints with your own brushes, and saves back to layered PSD.

Download for Linux (AppImage) · Download for Windows (portable zip)
_{Linux: any x86_64 distribution from 2022 on, Wayland or X11. Windows: 10 version 1903 or later, x86_64.}

_{A layered document: styled type, a Curves adjustment layer and a masked Multiply layer warming the sky.
The Great Wave off Kanagawa, Katsushika Hokusai, c. 1830–32}

Features · Everything in the box · PSD · Agents · Get started · Docs · License · 日本語

📂 Your files, your brushes Photoshop PSD and PSB, Clip Studio .clip, Affinity and camera RAW open with their layers. Photoshop .abr, Procreate and Clip Studio brushes import with their dynamics. Your work goes back out as layered PSD.

⌨️ Photoshop habits work The tools, menus and shortcuts are Photoshop's, held keys and spring-loaded tools included. Lost? Edit › Search (Ctrl+F) finds any command, tool or filter by name.

🎨 Colour, done properly 8, 16 and 32 bits per channel. RGB, CMYK and Lab documents edited in their own colours, managed with ICC profiles, with the blend modes Photoshop offers in each mode.

🐾 Yours, on your machine A native Qt app with no account and no cloud. Remove Background and Select Subject run locally: nothing is uploaded. Open source under the GPL, in English and Japanese.

Features

Every screenshot here is the real app, rendered offscreen and set up through its automation socket. The artworks are public-domain prints and paintings from Wikimedia Commons unless a credit says otherwise.

Live type with a Stroke and a Drop Shadow, edited in the Layer Style dialog. Fine Wind, Clear Morning, Katsushika Hokusai, c. 1830–32 Type that stays type Click and type on the canvas, in any installed font, with Japanese input composing right in the line. Style single letters, set paragraphs in a box, and keep every word editable. Drop and inner shadows, glows, bevel and emboss, satin, overlays and stroke go on any layer from Photoshop's Layer Style dialog, drawn as Photoshop draws them and written back to PSD as its own. Import .asl styles, .pat patterns and .grd gradients.	Curves, Hue/Saturation and Color Balance adjustment layers over a print, with the Histogram panel. Sudden Shower over Shin-Ōhashi Bridge and Atake, Utagawa Hiroshige, 1857 Edit without regret Seventeen adjustment layers, from Levels and Curves to Black & White, Selective Color and Color Lookup, keep every change live: mask them, stack them, switch them off. Your pixels never change, and the layers go out to PSD as Photoshop's own (Grain, which Photoshop lacks, and a Gradient Map made here, as their result). Curves follows Photoshop's own curve and Exposure its tone curve, so a PSD's adjustments look the same here. Hold Alt on Levels or Curves to see exactly what clips, and read the Histogram panel's channels and statistics as you go.
Remove Background previews the cut-out before you commit; the background goes into a layer mask. Photo: Welchcorgipembroke.JPG by pmuths1956 (2008), CC BY-SA 3.0 Cut-outs that never leave your machine Remove Background, Select Subject and Quick Select run on your own computer, with models you download once. Nothing is uploaded and there is no account. Advanced settings refine edges, solve hair and fur, clean up the edge colours and run a detail pass on large photos. The background is hidden by a mask, never erased, so you can paint it back.	A map stamped with an imported Photoshop .abr set and a MyPaint watercolour coast. Brushes: “Myer Settlement Brushes” by K. M. Alexander, CC0 Paint with the brushes you already own Import Photoshop .abr, Procreate .brushset and .brush, and Clip Studio .sut brushes with their pressure curves, tapers and jitter, or turn any image into a tip. 196 MyPaint brushes come built in: pencils, inks, charcoal, oils and watercolours that follow pen pressure and tilt, with Photoshop's Smoothing and Pulled String Mode.
A poster converted to CMYK: its own channels in the Channels panel and CMYK Curves. Tournée du Chat Noir de Rodolphe Salis, Théophile-Alexandre Steinlen, 1896 Print-ready, natively Open CMYK and Lab PSDs in their own mode, or convert with Image › Mode through your working CMYK profile. Paint, retouch, adjust, filter, type and use layer styles right in CMYK and Lab, with the blend modes Photoshop offers there. Content-Aware Fill, Move and Scale and Remove Background work on the inks themselves. Color Settings, Assign and Convert to Profile, Proof Colors with Simulate Paper Color and Gamut Warning in every mode, and 16-bit and 32-bit HDR documents with HDR Toning.	Filter › Mosh › Halftone previewing live on the canvas. Cats in different poses, from Tatoe-zukushi no uchi, Utagawa Kuniyoshi, 1852 A Filter menu to get lost in Photoshop's Filter menu in its own submenus: blurs, distortions, noise, pixelate, render, sharpen and stylize, previewing on the canvas inside your selection. Many go on a smart object as Smart Filters you can reorder, mask and edit later. Plus the Camera Raw Filter (Shift+Ctrl+A), measured against Camera Raw 18.7 and loading your Lightroom and Camera Raw .xmp presets, more than 850 G'MIC filters when gmic is installed, and 54 glitch and retro effects under Filter › Mosh.
Edit › Search finds menu commands, tools and G'MIC filters by a few letters. The Starry Night, Vincent van Gogh, 1889 Works the way your hands expect Photoshop's tools and shortcuts, Shift+letter to step through a tool group, and its held keys: Ctrl for the Move tool, Alt for the Eyedropper while painting, a tool's letter held for a spring-loaded tool. Edit › Keyboard Shortcuts changes any key, with clashes caught as you type. Right-click menus that fit the tool and what is under the pointer, rulers, guides and smart guides, labels you drag to change a number, and File › Revert (F12). Tab hides the panels. Full Screen Mode (F) leaves only the canvas: the tools, the options bar and the panels slide out from the screen's edges when the pointer reaches them. The cursor tells you when a tool can't work on the layer, and why.	Export As with a preview of the encoded file and its size. Asakusa Ricefields and Torinomachi Festival, Utagawa Hiroshige, 1857 Ship it anywhere Export As writes PNG, JPEG, GIF, WebP, TIFF or TGA with a live preview, the file's size, a new size, a matte and sRGB conversion, remembered per format. Quick Export in the format you pick, Layer › Export As, artboards and slices to files in one go. Record Actions as you work and run them over a folder with File › Automate › Batch.

Everything in the box

🗂️ Layers Folders, all 27 of Photoshop's blend modes plus Pass Through, Fill apart from Opacity (special modes included), layer and vector masks, clipping masks, fill and adjustment layers, Blend If and Advanced Blending's channel boxes, smart objects you can place, convert, edit and replace, and whole layers copied between documents.	✂️ Selections and retouching Marquees, lassos, an edge-aware Magic Wand, Quick Select, Select Subject, Quick Mask and alpha channels. Spot Healing, Healing Brush, Patch, Clone Stamp, Content-Aware Fill, Move and Scale, Liquify, Dodge, Burn and Sponge.	✒️ Vectors and transforms The Pen, live shapes with path operations, gradient and pattern fills and strokes, the Paths panel, text to path. Free Transform without losing resolution, distort, Warp Cage, and the Crop tool's ratio presets.
📁 Files PSD and PSB, Clip Studio .clip, Affinity, camera RAW through Camera Raw, SVG, PDF, GIF and Aseprite with their frames, PNG, JPEG, WebP, TIFF, TGA and ICO. Projects save as one .nekophoto file, up to a gigapixel of layers.	🎞️ Animation and automation A frame Timeline with animated GIF export, Actions and Batch, and an automation socket with an MCP bridge for scripts and agents.	🛟 Peace of mind Crash recovery that autosaves unsaved work in the background, several documents in tabs, an open project that reloads when its file changes on disk, and a CPU setting that leaves room for the other programs you run.

The full list, with every option, is in docs/features.md.

PSD that comes back

_{K.psd as Photoshop saved it: masks, adjustment layers and a smart object with its Smart Filters, all editable.
K by Nathan Lincoln, used with permission.}

_{Open a PSD, edit, save it as PSD, reopen: recorded headless from NekoPhoto 1.6.1 over its automation socket.
K by Nathan Lincoln, used with permission.}

NekoPhoto is tested against real Photoshop files, and the numbers are published with the commands to check them yourself:

• Round trip: all 117 PSD and PSB files of the test corpus, nearly all saved by Photoshop 2026 (text, smart objects and Smart Filters, layer styles, shapes, masks, PSB), open, export and reopen with nothing lost; 3,675 blocks NekoPhoto does not edit go back byte for byte. Converted to 16 bits, they come back too.
• Against Photoshop's own render: 61 of 72 files render within 2 levels of what Photoshop shows on 99% of their pixels, compared with Photoshop's own flatten or the merged image it stored. Two public corpora check the same way: 179 of the 258 files Photoshop saved for PhotoCraft's corpus, and 220 of the 285 psd-tools test files with a merged image, each compared in its own colour mode and depth. Shape and fill layers show Photoshop's own pixels until you edit them.
• Colour: the ICC profile of all 64 tagged RGB PSDs in the corpus is written back byte for byte.
• No surprises: what PSD cannot carry is listed before you export, and an unedited 16-bit layer goes back byte for byte.

The counts, the known gaps and how to rerun every check are in Compatibility & correctness; how export works is in docs/psd-export.md and docs/psd-roundtrip.md.

Built for scripts and agents

Everything an agent or a script does goes through the same editor session you see, lands in the undo history, and shows on screen. 185 automation methods cover documents, layers, pixels, selections, painting and export.

Let Claude Code, or any MCP client, drive the editor:

claude mcp add nekophoto -- uv run /path/to/nekophoto/mcp/nekophoto_mcp.py

Then ask for something like “open photo.jpg, remove the background, put a dark gradient behind it and export result.png”.

From a shell, send one request to the running editor, or run a file of requests in a windowless instance:

nekophoto --call layers.list
nekophoto --call render --params '{"path": "/tmp/check.png", "maxSize": 800}'
nekophoto --headless --batch grade.jsonl

{"method": "document.open", "params": {"path": "/path/to/photo.jpg"}}
{"method": "layers.add", "params": {"kind": "adjustment", "adjustmentKind": "Vibrance", "settings": {"vibranceSettings": {"vibrance": 35}}}}
{"method": "document.export", "params": {"path": "/path/to/photo-graded.png"}}

The protocol, every method and the MCP tools are in docs/automation.md.

Get started

Linux: download the AppImage from the Releases page, make it executable and run it. It works on any x86_64 Linux from 2022 on, under Wayland or X11.

chmod +x NekoPhoto-*.AppImage
./NekoPhoto-*.AppImage

To add it to your app launcher, open .nekophoto and .comp projects by double-click and offer it for .psd files, run the integration script once (no root needed; --remove undoes it):

curl -fsSL https://raw.githubusercontent.com/vomitselfie/nekophoto/main/tools/integrate-appimage.sh | bash -s -- NekoPhoto-*.AppImage

Windows (10 version 1903 or later, x86_64): download NekoPhoto-<version>-windows-x86_64.zip from the same page, unzip it anywhere and run nekophoto.exe. It is portable: nothing is installed, and settings live in your user profile. The G'MIC filters need gmic.exe on PATH.

Good to know

• Remove Background is off until you turn it on in Edit › Preferences, which downloads the model once. Quick Select's click mode downloads its own model from the options bar.
• The interface is in English and Japanese: it follows the desktop's language, and Edit › Preferences › Language picks one (at the next launch).
• It dresses in Goth Kitty out of the box, an original kawaii-goth look: plum-black panels, candy pink and lavender, heart-shaped slider handles and a bow on every panel title. Prefer something plainer? Edit › Preferences › Theme also offers System, Dark and Light, and switches at once.
• NekoPhoto began as a Linux port of Compositor for macOS and was called compositor-linux until 1.0; your settings, brushes and downloaded model move over by themselves. .comp project folders from older versions and the Mac app still open and save as they are.

Build from source

# Arch / Manjaro
sudo pacman -S cmake ninja qt6-base qt6-svg qt6-wayland qt6-imageformats qt6-webengine libpng libmypaint libraw zstd opencv
# Ubuntu 24.04
sudo apt install cmake ninja-build qt6-base-dev qt6-svg-dev qt6-pdf-dev qt6-wayland qt6-image-formats-plugins libpng-dev libmypaint-dev libraw-dev libzstd-dev libsqlite3-dev libgl1-mesa-dev libopencv-dev

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
./build/src/app/nekophoto

Windows builds with MinGW-w64 in MSYS2 (UCRT64); the packages and steps are in docs/linux-port.md, as are build options, command-line flags and keyboard shortcuts.

Documentation

What NekoPhoto can do	every feature, menu by menu
Compatibility & correctness	what is tested against Photoshop, and what still differs
Colour modes · Bit depth · Colour management	CMYK, Lab, 16 and 32 bits, ICC profiles
Layer styles · Smart objects · Vector tools	how they are drawn and kept in PSD
Brush engine · Camera Raw · Remove Background	painting, RAW development, cut-outs
Actions · Automation and MCP	recording, batches, scripts and agents
Legal boundaries	the few features that deliberately work differently from Photoshop

Contributing

Building, the code's layout, the rules a change has to follow and how CI checks a pull request are in CONTRIBUTING.md. Report security problems privately as SECURITY.md describes. Adding a language is explained in docs/translating.md.

License and credits

NekoPhoto is GPL-3.0-or-later; see LICENSE. It is based on Compositor by Wonder Assembly LLC, whose code keeps its MIT licence (LICENSES/MIT-Compositor.txt). Third-party components and their licences are listed in THIRD-PARTY-NOTICES.md.

Artwork in this README: K by Nathan Lincoln, used with permission; the corgi photo Welchcorgipembroke.JPG by pmuths1956 (2008), Wikimedia Commons, CC BY-SA 3.0; the CC0 “Myer Settlement Brushes” by K. M. Alexander; and public-domain prints and paintings by Katsushika Hokusai, Utagawa Hiroshige, Utagawa Kuniyoshi, Théophile-Alexandre Steinlen and Vincent van Gogh from Wikimedia Commons, each linked under its screenshot.

_{Adobe and Photoshop are trademarks of Adobe Inc. NekoPhoto is not affiliated with or endorsed by Adobe; Photoshop is named only to describe compatibility. Clip Studio Paint is a trademark of CELSYS, Inc. and Procreate of Savage Interactive Pty Ltd. A few features deliberately work differently from Photoshop: see docs/legal-boundaries.md.}

---

日本語

English · 日本語

作品をそのまま持ってこられます。
Linux・Windows 向けの、かわいい写真編集・お絵描きソフトです。Photoshop とクリップスタジオのファイルを
レイヤー・マスク・テキストを保ったまま開き、手持ちのブラシで描き、レイヤー付きの PSD に保存し直せます。

Linux 版をダウンロード(AppImage) · Windows 版をダウンロード(ポータブル zip)
_{Linux: 2022 年以降の x86_64 ディストリビューション(Wayland・X11)。Windows: 10 バージョン 1903 以降(x86_64)。}

_{日本語表示で編集中のドキュメント: スタイル付きのテキスト、トーンカーブの調整レイヤー、マスクで空だけを温める乗算のレイヤー。
葛飾北斎『冨嶽三十六景 神奈川沖浪裏』(1830〜32 年頃)}

機能 · ほかにもいろいろ · PSD · エージェント · はじめかた · ドキュメント · ライセンス

📂 手持ちのファイルとブラシ Photoshop の PSD・PSB、クリップスタジオの .clip、Affinity、カメラ RAW をレイヤーごと開けます。Photoshop の .abr、Procreate・クリップスタジオのブラシはダイナミクスごと読み込めます。保存はレイヤー付きの PSD で。

⌨️ Photoshop の手癖のままで ツール・メニュー・ショートカットは Photoshop と同じ。押している間だけの一時切り替えにも対応しています。迷ったら 編集 › 検索(Ctrl+F)で、コマンド・ツール・フィルターを名前で探せます。

🎨 本物の色 8・16・32 ビット/チャンネル。RGB・CMYK・Lab のドキュメントをそのままの色で編集し、ICC プロファイルでカラーマネジメント。描画モードは各モードで Photoshop と同じものが使えます。

🐾 あなたのマシンの中で アカウントもクラウドも不要なネイティブ Qt アプリです。背景を削除・被写体を選択は手元で動作し、画像はどこにも送信されません。GPL のオープンソースで、英語と日本語に対応。

機能

スクリーンショットはすべて実際のアプリを画面なしで起動し、自動操作ソケットで準備して撮影したものです。作品は、クレジットに 別記がない限り Wikimedia Commons のパブリックドメインの版画・絵画です。

境界線とドロップシャドウを付けたテキストを、レイヤースタイルのダイアログで編集。 葛飾北斎『冨嶽三十六景 凱風快晴』(1830〜32 年頃) 文字はずっと文字のまま カンバスをクリックしてそのまま入力。インストール済みのどのフォントでも使え、日本語入力も行の中で変換できます。1 文字ずつのスタイル、ボックスでの段落組みも可能で、文字はいつでも編集し直せます。 シャドウ、光彩、ベベルとエンボス、サテン、オーバーレイ、境界線を Photoshop と同じレイヤースタイルのダイアログで付けられ、Photoshop と同じように描画して PSD に書き戻します。.asl スタイル・.pat パターン・.grd グラデーションも読み込めます。	トーンカーブ・色相・彩度・カラーバランスの調整レイヤーとヒストグラムパネル。 歌川広重『名所江戸百景 大はしあたけの夕立』(1857 年) やり直しのきく補正 レベル補正・トーンカーブから白黒・特定色域の選択・カラールックアップまで、17 種類の調整レイヤーで補正をいつでも変更できます。マスクを付けても、重ねても、オフにしても元のピクセルは変わらず、PSD には Photoshop の調整レイヤーとして書き出されます(Photoshop にない粒子と、ここで作ったグラデーションマップは結果の画像として)。 レベル補正やトーンカーブで Alt を押しながらドラッグすると白飛び・黒つぶれする部分が見え、ヒストグラムパネルでチャンネルごとの分布と統計値を確認できます。
背景を削除は確定前に切り抜きをプレビューし、背景はレイヤーマスクで隠します。 写真: pmuths1956 による Welchcorgipembroke.JPG(2008 年、CC BY-SA 3.0) 切り抜きは手元のマシンで 背景を削除・被写体を選択・クイック選択は、一度ダウンロードしたモデルを使ってあなたのコンピューターの中で動きます。画像はどこにも送信されず、アカウントも要りません。 詳細設定では境界の調整、髪や毛並みの処理、境界の色の除去、大きな写真のための精細パスが使えます。背景は消すのではなくマスクで隠すので、描き戻すこともできます。	読み込んだ Photoshop の .abr ブラシセットと MyPaint の水彩で描いた地図。 ブラシ: K. M. Alexander による 「Myer Settlement Brushes」(CC0) いつものブラシで描く Photoshop の .abr、Procreate の .brushset・.brush、クリップスタジオの .sut を、筆圧カーブ・入り抜き・ジッターごと読み込めます。任意の画像をブラシ先端にすることもできます。 筆圧と傾きに反応する MyPaint ブラシ 196 種類(鉛筆、インク、木炭、油彩、水彩)を内蔵。Photoshop と同じ滑らかさとストリングを引くモードも使えます。
CMYK に変換したポスター。チャンネルパネルに各版が並び、トーンカーブも CMYK で。 テオフィル＝アレクサンドル・スタンラン『Tournée du Chat Noir de Rodolphe Salis』(1896 年) 印刷用データもそのまま CMYK・Lab の PSD はそのモードのまま開け、イメージ › モードで作業用 CMYK プロファイルを使って変換できます。描画・修正・色調補正・フィルター・文字・レイヤースタイルを CMYK・Lab のまま使え、描画モードも Photoshop がそのモードで用意しているものが使えます。コンテンツに応じた塗りつぶし・移動・拡大・縮小と背景を削除も、インキそのものに働きます。 カラー設定、プロファイルの指定・変換、どのモードでも使える色の校正(紙色・インキの黒をシミュレート)と色域外警告、16 ビット、HDR トーン付きの 32 ビット HDR ドキュメントにも対応しています。	フィルター › Mosh › ハーフトーンをカンバス上でプレビュー。 歌川国芳『たとえ尽の内』より、さまざまな姿の猫(1852 年) 試しきれないほどのフィルター Photoshop と同じサブメニューに並ぶフィルター(ぼかし、変形、ノイズ、ピクセレート、描画、シャープ、表現手法)は、選択範囲の中でカンバス上にプレビューされます。多くはスマートオブジェクトにスマートフィルターとして適用でき、あとから並べ替え・マスク・編集ができます。 さらに Camera Raw 18.7 と照らし合わせ、Lightroom・Camera Raw の .xmp プリセットも読み込める Camera Raw フィルター(Shift+Ctrl+A)、gmic をインストールすれば 850 種類以上の G'MIC フィルター、フィルター › Mosh の 54 種類のグリッチ・レトロ効果も使えます。
編集 › 検索 で、メニューのコマンド・ツール・G'MIC フィルターを数文字で探せます(画面は英語表示)。 フィンセント・ファン・ゴッホ『星月夜』(1889 年) 手が覚えている操作のままで Photoshop と同じツールとショートカット、Shift+キーでのツールグループの切り替え、押している間だけのキー(Ctrl で移動ツール、描画中の Alt でスポイト、ツールのキーを押し続けて一時的に切り替え)。編集 › キーボードショートカット でどのキーも変更でき、重複はその場で知らせます。 ツールとポインター下の対象に合わせた右クリックメニュー、定規・ガイド・スマートガイド、ドラッグで数値を変えられるラベル、ファイル › 復帰(F12)。Tab でパネルを隠せます。フルスクリーンモード(F)ではカンバスだけを表示し、ポインターを画面の端に寄せるとツール・オプションバー・パネルがスライドして現れます。ツールがそのレイヤーに使えないときは、カーソルが理由とともに知らせます。	書き出し形式。書き出したファイルのプレビューとサイズを確認できます。 歌川広重『名所江戸百景 浅草田甫酉の町詣』(1857 年) どこへでも書き出せる 書き出し形式で PNG・JPEG・GIF・WebP・TIFF・TGA を、プレビュー・ファイルサイズ・画像サイズ・マット・sRGB 変換を確認しながら書き出せ、設定は形式ごとに記憶されます。選んだ形式でのクイック書き出し、レイヤー › 書き出し形式、アートボードとスライスの一括書き出しも。 作業をアクションとして記録し、ファイル › 自動処理 › バッチでフォルダーごと処理できます。

ほかにもいろいろ

🗂️ レイヤー グループ、Photoshop の 27 種類の描画モードと通過、不透明度とは別の塗り(特殊な描画モードにも対応)、レイヤーマスクとベクトルマスク、クリッピングマスク、塗りつぶしレイヤーと調整レイヤー、ブレンド条件と高度な合成のチャンネル指定、配置・変換・編集・置き換えのできるスマートオブジェクト、ドキュメント間でのレイヤーのコピー。	✂️ 選択と修正 長方形・楕円選択、なげなわ、輪郭を読み取る自動選択、クイック選択、被写体を選択、クイックマスク、アルファチャンネル。スポット修復ブラシ、修復ブラシ、パッチ、コピースタンプ、コンテンツに応じた塗りつぶし・移動・拡大・縮小、ゆがみ、覆い焼き・焼き込み・スポンジ。	✒️ ベクターと変形 ペン、パスの結合ができるライブシェイプ、グラデーション・パターンの塗りと線、パスパネル、テキストのパス化。解像度を落とさない自由変形、ワープケージ、比率プリセット付きの切り抜きツール。
📁 ファイル PSD・PSB、クリップスタジオの .clip、Affinity、Camera Raw で開くカメラ RAW、SVG、PDF、フレームごとの GIF・Aseprite、PNG・JPEG・WebP・TIFF・TGA・ICO。プロジェクトは 1 つの .nekophoto ファイルに保存し、1 ギガピクセルまでのレイヤーを扱えます。	🎞️ アニメーションと自動化 フレームタイムラインとアニメーション GIF の書き出し、アクションとバッチ、スクリプトや AI エージェントのための自動操作ソケットと MCP ブリッジ。	🛟 安心して使える 未保存の作業をバックグラウンドで自動保存するクラッシュからの復元、タブで複数のドキュメント、ファイルが外部で変更されると開いているプロジェクトを再読み込み、ほかのプログラムに CPU を譲る設定。

機能の一覧は docs/features.md にあります。

PSD はそのまま戻ってくる

_{Photoshop で保存されたままの K.psd: マスク、調整レイヤー、スマートフィルター付きのスマートオブジェクトをすべて編集できます(画面は英語表示)。
作品: Nathan Lincoln『K』(許可を得て使用)}

_{PSD を開いて編集し、PSD に保存して開き直す: NekoPhoto 1.6.1 を画面なしで起動し、自動操作ソケット経由で記録。
作品: Nathan Lincoln『K』(許可を得て使用)}

NekoPhoto は実際の Photoshop ファイルで検証しており、その数値を確認用のコマンドとともに公開しています。

• 往復: テスト用の PSD・PSB ファイル 117 個(ほぼすべて Photoshop 2026 で保存。テキスト、スマートオブジェクトとスマートフィルター、 レイヤースタイル、シェイプ、マスク、PSB を網羅)は、開いて書き出し、開き直しても何も失われません。NekoPhoto が編集しない 3,675 個のブロックはバイト単位でそのまま戻ります。16 ビットに変換しても同様です。
• Photoshop 自身の描画と比較: 72 個中 61 個のファイルが、ピクセルの 99% で Photoshop の表示と 2 レベル以内に収まります (Photoshop で統合した画像、またはファイルに保存された統合画像と比較)。公開されている 2 つのテスト用ファイル群でも同じ方法で 確認しています。PhotoCraft のコーパスの Photoshop で保存された 258 個中 179 個、 psd-tools の統合画像付きテストファイル 285 個中 220 個で、それぞれのカラーモードと ビット数のまま比較しています。シェイプレイヤーと塗りつぶしレイヤーは、編集するまで Photoshop が保存したピクセルをそのまま表示します。
• 色: テスト用ファイルのうちプロファイル付きの RGB PSD 64 個すべてで、ICC プロファイルがバイト単位でそのまま書き戻されます。
• 想定外なし: PSD で表現できない要素は書き出す前に一覧表示され、編集していない 16 ビットのレイヤーはバイト単位でそのまま戻ります。

集計値・既知の差異・検証の再実行方法は 互換性と正確さ に、書き出しのしくみは docs/psd-export.md と docs/psd-roundtrip.md(英語)にまとめています。

スクリプトと AI エージェントから使う

エージェントやスクリプトの操作は、画面に見えているのと同じ編集セッションを通り、取り消し履歴に残り、画面にも表示されます。 185 個の自動操作メソッドで、ドキュメント・レイヤー・ピクセル・選択範囲・描画・書き出しを扱えます。

Claude Code などの MCP クライアントから操作するには:

claude mcp add nekophoto -- uv run /path/to/nekophoto/mcp/nekophoto_mcp.py

あとは「photo.jpg を開いて背景を削除し、後ろに暗いグラデーションを敷いて result.png に書き出して」のように頼むだけです。

シェルからは、起動中のエディターにリクエストを 1 つ送ったり、リクエストを並べたファイルを画面なしのインスタンスで実行したりできます (ファイルの例は英語版の Built for scripts and agents にあります)。

nekophoto --call layers.list
nekophoto --call render --params '{"path": "/tmp/check.png", "maxSize": 800}'
nekophoto --headless --batch grade.jsonl

プロトコル、全メソッド、MCP のツールは docs/automation.md(英語)をご覧ください。

はじめかた

Linux: Releases ページから AppImage をダウンロードし、 実行権限を付けて起動します。2022 年以降の x86_64 Linux であれば、Wayland と X11 のどちらでも動作します。

chmod +x NekoPhoto-*.AppImage
./NekoPhoto-*.AppImage

アプリランチャーに登録し、.nekophoto と .comp をダブルクリックで開けるようにして .psd の「別のアプリで開く」にも 表示させるには、統合スクリプトを一度実行します(root 権限は不要、--remove で元に戻せます):

curl -fsSL https://raw.githubusercontent.com/vomitselfie/nekophoto/main/tools/integrate-appimage.sh | bash -s -- NekoPhoto-*.AppImage

Windows(10 バージョン 1903 以降、x86_64)では、同じページから NekoPhoto-<version>-windows-x86_64.zip をダウンロードし、好きな場所に展開して nekophoto.exe を起動します。インストール不要のポータブル版で、 設定はユーザープロファイルに保存されます。G'MIC フィルターを使うには gmic.exe に PATH を通してください。

知っておくと便利なこと

• 背景を削除 は、編集 › 環境設定 でオンにすると使えるようになります(モデルを一度だけダウンロードします)。クイック選択の クリックで選ぶモードは、オプションバーから専用のモデルをダウンロードします。
• 画面表示は 日本語と英語 に対応しています。デスクトップの言語に合わせて切り替わり、編集 › 環境設定 › 言語 で 選ぶこともできます(次回の起動から反映されます)。
• 初期設定の見た目は ゴスキティ。プラム色がかった黒のパネルにキャンディピンクとラベンダー、ハート型のスライダー、 パネル名にはリボンを添えた、オリジナルのかわいいゴス系テーマです。落ち着いた見た目がよければ、編集 › 環境設定 › テーマ で システム・ダーク・ライト にすぐ切り替えられます。
• NekoPhoto は macOS 版 Compositor の Linux 移植として始まり、バージョン 1.0 までは compositor-linux という名前でした。設定・ブラシ・ダウンロード済みのモデルは自動で引き継がれます。以前のバージョンや Mac 版の .comp プロジェクトフォルダーも、そのまま開いて保存できます。

ソースからビルド

必要なパッケージとビルド手順は、英語版の Build from source と同じです。 Windows では MSYS2(UCRT64)の MinGW-w64 でビルドします。手順とビルドオプション、キーボードショートカットは docs/linux-port.md(英語)にあります。

ドキュメント

機能の一覧	すべての機能をメニューごとに
互換性と正確さ	Photoshop と比べて検証している内容と、まだ異なる点
カラーモード · ビット数 · カラーマネジメント	CMYK・Lab、16・32 ビット、ICC プロファイル
Layer styles · Smart objects · Vector tools(英語)	PSD での描画と保存のしくみ
Brush engine · Camera Raw · Remove Background(英語)	ペイント、RAW 現像、切り抜き
Automation and MCP · Actions(英語)	記録、バッチ、スクリプトとエージェント
法的な制約	意図的に Photoshop と異なる動作をするいくつかの機能

開発に参加する

ビルド方法、コードの構成、変更が守るべきルール、プルリクエストで CI が確認する内容は CONTRIBUTING.md(英語)に、 セキュリティ上の問題の非公開での報告方法は SECURITY.md(英語)にあります。言語の追加方法は docs/translating.md(英語)をご覧ください。

ライセンスとクレジット

GPL-3.0-or-later です(LICENSE)。Wonder Assembly LLC の Compositor を元にしており、 その部分のコードは MIT ライセンスのままです(LICENSES/MIT-Compositor.txt)。 サードパーティー製コンポーネントとそのライセンスは THIRD-PARTY-NOTICES.md にまとめています。

この README の作品: Nathan Lincoln『K』(許可を得て使用)、pmuths1956 によるコーギーの写真 Welchcorgipembroke.JPG(2008 年、Wikimedia Commons、CC BY-SA 3.0)、 K. M. Alexander による CC0 の「Myer Settlement Brushes」、そして Wikimedia Commons のパブリックドメインの作品(葛飾北斎、歌川広重、 歌川国芳、テオフィル＝アレクサンドル・スタンラン、フィンセント・ファン・ゴッホ。出典は各スクリーンショットの下にリンクしています)。

_{Adobe と Photoshop は Adobe Inc. の商標です。NekoPhoto は Adobe とは関係がなく、Adobe の承認も受けていません。Photoshop の 名前は互換性を説明するためだけに使っています。CLIP STUDIO PAINT は株式会社セルシスの、Procreate は Savage Interactive Pty Ltd の商標です。いくつかの機能は意図的に Photoshop と異なる動作をします:docs/legal-boundaries.md}