点击查看中文版 · 日本語版はこちら

A UXP plugin for realistic pigment mixing in Adobe Photoshop, with dual physical mixing engines.

Real subtractive pigment mixing — yellow + blue = green, not muddy gray.

Layered watercolor strokes blend naturally — wet edges, soft transitions, adjustable concentration (1–100).

Smudge tool blends colors directly on the canvas, just like mixing paint on a palette.

Picks a color, the ruler shows its perceived brightness. Great for keeping values under control.

Drag the handles on either side of the black panel to resize the mixing canvas (480–2000px).

Both engines are calibrated to produce visually similar results in most cases. Switch anytime via the MB/KM button in the top-left. Canvas auto-repaints from stroke history.

• KM — Default. Self-implemented. 32³ LUT maps RGB to 38-wavelength reflectance spectra (data from spectral.js, MIT), then Kubelka-Munk mixing in spectral space. GPL v3. More physically accurate and more sensitive — small differences in pigment RGB produce visibly different mixing behavior, closer to how real paints respond to subtle variations. Algorithmically more prone to producing greens in certain blue/yellow combinations.
• Mixbox (MB) — Mixbox LUT-based algorithm, CC BY-NC 4.0. Hand-tuned anchor pigments → coarser but more uniform — produces consistent results across a wide range of inputs. Lower precision than KM, higher stability.

The two engines now produce comparable results — pick KM (default) for higher precision and sensitivity, switch to MB for a more uniform feel or to avoid the GPL license. Differences are most visible at 25–75% concentration and on certain blue+yellow composites.

Try the KM Tuner to compare side by side.

• 4 professional palettes — Winsor & Newton Cotman, Schmincke Horadam, Kuretake Gansai, Digital Artist
• 6 brush presets — Circle, Soft, Watercolor, Splatter, Flat, Dry; brush and smudge each remember their last preset
• Right-click paint — drag to paint with background color
• Eyedropper — Alt + Left/Right Click for foreground/background
• Transfer to Photoshop — export a region of the mixing canvas directly to your active layer
• Bidirectional color sync — plugin ↔ Photoshop, including PS color picker, swatches, X swap, D reset
• Zoom — 60%–150% via top-right dropdown
• Undo/Redo — up to 50 steps, GPU-backed canvas snapshots
• Auto-save — canvas, settings, and history persist automatically
• Multilingual — English / 中文 / 日本語, auto-detects system language

1. Visit MixBox Watercolor Palette on Adobe Marketplace
2. Install and open from Photoshop Plugins menu

1. Download the latest .ccx file from Releases
2. Double-click the .ccx file to install
3. Open from Photoshop Plugins menu

1. Clone this repository
2. Open Adobe UXP Developer Tool
3. Load the uxp-host/ directory (NOT the root directory)
4. Open from Photoshop Plugins menu

1. Select a palette — click the "Palette" button to switch paint brands
2. Pick a color — click a swatch to set as foreground color
3. Paint — draw on the mixing canvas to blend colors
4. Use in Photoshop — selected colors sync to PS automatically; PS color changes sync back

1. Select an area on your Photoshop canvas
2. In the plugin, switch to the rect select tool
3. Draw a region on the mixing canvas — selected pixels transfer to the active layer

WebView hybrid: UI and mixing engines hosted remotely (Cloudflare Pages, GitHub Pages fallback). The local UXP host is a minimal bridge that loads the remote UI and syncs colors to Photoshop. Updates roll out automatically without reinstalling. Service Worker caches everything for offline use after first load.

• Mixing Engines: Mixbox (LUT-based, CC BY-NC 4.0) + KM (38-wavelength Kubelka-Munk, spectral data from spectral.js MIT, GPL v3)
• Rendering: WebGL (mixing) + Canvas 2D (cursor, overlays)
• Platform: Adobe UXP + WebView
• Hosting: Cloudflare Pages (primary) / GitHub Pages (fallback)
• Offline: Service Worker, Cache-First strategy
• Storage: localStorage for canvas, history, and settings

Two licenses in this project:

• Original code (KM engine, UI, etc.) — GPL-3.0
• Mixbox library (js/mixbox.js) — CC BY-NC 4.0 (non-commercial only, by Secret Weapons)

When using the Mixbox engine, the CC BY-NC 4.0 restriction applies. The KM engine has no such restriction.

Adobe and Photoshop are either registered trademarks or trademarks of Adobe in the United States and/or other countries.

See Changelog for version history.

• ⭐ Star this project
• 💬 Join our Discord — bug reports, feedback, and discussion
• 🐛 Report bugs
• 💡 Suggest features
• ☕ Support my open-source work: Alipay food211@qq.com / WeChat 172660507

Click here for English version · 日本語版はこちら

Adobe Photoshop UXP 调色板插件，内置双物理混色引擎，模拟真实颜料混合效果。

真实减色混合 —— 黄+蓝=绿，不是糊成灰。

水彩叠笔自然过渡，湿边、柔和衔接，浓度可调（1–100）。

涂抹工具直接在画布上混色，就像在调色盘里调颜料。

吸取颜色，标尺自动显示该颜色的感知亮度，控制画面明度关系很顺手。

拖拽黑色面板两侧的 handle 调整混色画布宽度（480–2000px）。

两个引擎已完成校准，多数场景下视觉效果接近。左上角 MB/KM 按钮随时切换，画布自动用笔画历史重绘。

• KM —— 默认引擎。自研。32³ LUT 把 RGB 映射到 38 波长反射率光谱（光谱数据来自 spectral.js，MIT），在光谱空间应用 Kubelka-Munk 公式混色。GPL v3。计算更精确、对颜料 RGB 更灵敏 —— 颜料 RGB 的细微差异会带来可见的混色差异，更接近真实颜料对细微变化的响应。算法特性使某些蓝+黄组合更容易混合出绿色。
• Mixbox (MB) —— 基于 Mixbox LUT 算法，CC BY-NC 4.0。人工调校的锚点颜料 → 较粗糙但更均一 —— 在更广的输入范围内产出一致结果。精确度低于 KM，但稳定性更好。

两个引擎现在效果接近 —— 默认用 KM 获得更高精度和灵敏度，想要更均一的手感或需要规避 GPL 许可时切换到 MB。差异在 25–75% 浓度区间和某些蓝+黄复合色上最明显。

可使用 KM Tuner 对比两引擎效果。

• 4 套专业调色盘 —— 温莎牛顿 Cotman、施美尔 Horadam、吴竹 Gansai、数字艺术家
• 6 种笔刷预设 —— 圆形、柔和、水彩、飞溅、平头、干笔；画笔和涂抹工具各自记忆上次使用的笔刷
• 右键绘制 —— 右键拖拽使用背景色绘制
• 吸管工具 —— Alt + 左键/右键 取色为前景/背景
• 传输至 PS —— 将混色画布的区域传输到 Photoshop 活动图层
• 双向颜色同步 —— 插件 ↔ Photoshop，包含拾色器、色板、X 交换、D 复位
• 缩放控制 —— 右上角下拉菜单，60%–150%
• 50 步撤销/重做 —— 直接保存画布快照，使用 GPU 显存记录增量
• 自动保存 —— 画布、历史和设置自动保存
• 多语言支持 —— English / 中文 / 日本語，自动跟随系统语言，可手动切换

1. 访问 MixBox Watercolor Palette - Adobe Marketplace
2. 安装后从 Photoshop 插件 菜单打开

1. 从 Releases 下载最新 .ccx
2. 双击 .ccx 文件安装
3. 从 Photoshop 插件 菜单打开

1. 克隆本仓库
2. 打开 Adobe UXP Developer Tool
3. 加载 uxp-host/ 目录（注意不是根目录）
4. 从 Photoshop 插件 菜单打开

1. 选择调色盘 —— 点击"Palette"按钮切换颜料品牌
2. 选取颜色 —— 点击色块设置为前景色
3. 混色 —— 在混色画布上绘制
4. 同步到 PS —— 选取的颜色自动同步到 Photoshop；反之 PS 改色也会同步回插件

1. 在 Photoshop 画布上用任意选区工具选好区域
2. 在插件中切换到矩形选取工具
3. 在混色画布上框选 —— 所选像素自动传输到活跃图层的选区范围

WebView 混合架构：UI 和混色引擎托管在远端（Cloudflare Pages，GitHub Pages 备用）。本地 UXP Host 是个最小桥接，负责加载远端 UI 和同步颜色到 Photoshop。更新自动下发不需要重装。首次加载后 Service Worker 缓存全部内容供离线使用。

本项目包含两种许可证的代码：

• 自研代码（KM 引擎、UI 等）— GPL-3.0
• Mixbox 库（js/mixbox.js）— CC BY-NC 4.0（仅限非商业用途，由 Secret Weapons 提供）

使用 Mixbox 引擎时，整体使用受 CC BY-NC 4.0 限制；KM 引擎无此限制。

Adobe 和 Photoshop 是 Adobe 在美国和/或其他国家/地区的注册商标或商标。

查看 更新日志 了解版本历史。

• ⭐ Star 本项目
• 💬 加入 Discord 社区 — 反馈问题、提出建议、日常交流
• 🐛 提交 Bug
• 💡 提出功能建议
• ☕ 支持开源：支付宝 food211@qq.com / 微信 172660507