paint.js is an unofficial, proof-of-concept, cross-platform JavaScript port of the Windows only raster graphics editor Paint.NET by Rick Brewster. This port is available for the web and as an Electron desktop application.
Its core editing model is based on Paint.NET 3.36.7, the last version released under the original MIT-compatible license, while the current interface and behavior follow Paint.NET v5.2+.
Paint.NET is one of the best image editors available on Windows, combining powerful features with a simple, intuitive interface. After switching to Linux, it became the application I missed most and one I had relied on every day. I have been developing paint.js since February 2024, with the goal of bringing that familiar editing experience to Linux, macOS, and the web.
Use paint.js directly at paintjs.net. No installation is required.
Install paintdotjs-bin from the AUR with an
AUR helper, for example:
yay -S paintdotjs-binDownload the latest .flatpak bundle from
GitHub Releases, then install it with:
flatpak install --user ./paintdotjs-*-linux-x86_64.flatpakThe bundle uses the Freedesktop runtime from Flathub, but paint.js itself is installed directly from the downloaded file.
Download the latest universal .dmg from GitHub Releases,
open it, and drag paint.js into the Applications folder.
paint.js is largely feature-complete and closely reproduces the Paint.NET experience, but there are still some additions and limitations worth noting.
- Runs on macOS, Linux, Windows, and the web through a shared JavaScript codebase, with an Electron desktop application for a more native experience.
- Supports touch input, including drawing and two-finger canvas pan and zoom.
- A Fonts settings page lets you add font files by picker or drag and drop, preview installed fonts, and remove individual fonts or clear them all. Added fonts are stored locally and are available in the Text tool.
- A Keyboard settings page lets you rebind, clear, and reset keyboard shortcuts.
- A versioned JavaScript plugin API lets extensions add effects, adjustments, and file formats.
- Native Paint.NET custom shapes can be installed as
.xamlfiles and appear in the Shapes tool's Custom category; see the custom-shapes guide. - An icon pack API can replace icons, images, cursors, and translations without modifying the application.
- Interface, canvas, tool, pen, window, and dialog preferences are stored locally and restored across sessions.
- The deployed web version can work offline and provides browser-oriented file, clipboard, and drag and drop workflows.
- Chromium is the supported browser family. Firefox and Safari are not regularly tested, and their file-system and clipboard capabilities differ.
- Open Recent, scanner/camera acquisition, and color-profile commands are not implemented yet.
- Native Paint.NET DLL plugins cannot be loaded. JavaScript plugins can provide effects and file types; see the plugin guide.
- Manual GPU/device selection and direct advanced-color management are not implemented.
- Very large documents, large-radius effects, and complex selections may still be slower or more memory-intensive than in Paint.NET.
- Some browser functionality requires HTTPS or localhost, including parts of the clipboard, file-system, and offline-app support.
| Format | Paint.NET open | Paint.NET save | paint.js open | paint.js save | Important differences |
|---|---|---|---|---|---|
Paint.NET (.pdn) |
Yes | Yes | Limited | Limited | paint.js supports bitmap layers and basic layer properties, with a maximum of 64 layers when saving. History, selections, plugin data, and some newer PDN features are not preserved. |
| PNG | Yes | Yes | Yes | Yes | — |
JPEG (.jpg, .jpeg, .jpe) |
Yes | Yes | Yes | Yes | — |
JPEG XL (.jxl) |
Yes | Yes | Yes | Yes | — |
| AVIF | Yes | Yes | Yes | Yes | — |
| HEIC/HEIF | With the Windows codec | With the Windows codec | Yes | No | The bundled paint.js codec can decode these files but cannot encode them. |
| WebP | Yes | Yes | Yes | Yes | — |
| DDS | Yes | Yes | Yes | Yes | paint.js saves uncompressed 32-bit images only. |
TIFF (.tif, .tiff) |
Yes | Yes | Yes | Yes | paint.js saves uncompressed RGBA images only. |
| GIF | Yes | Yes | Yes | Yes | paint.js saves a single static, palette-based image only. |
| BMP | Yes | Yes | Yes | Yes | paint.js saves 32-bit images with alpha only. |
| TGA | Yes | Yes | Yes | Yes | paint.js saves uncompressed 32-bit images only. |
JPEG XR (.jxr, .wdp, .wmp) |
Yes | Yes | Limited | No | paint.js can open RGB images with 8-bit, 16-bit, or 32-bit floating-point channels but cannot save JPEG XR. |
Animated and multi-page files are imported and exported as a single static image in paint.js.
paint.js uses AI-generated icons for its default icon pack because
we cannot redistribute the original Paint.NET icons.
You can install and activate custom icon packs from Settings → Icon Packs to
replace the default icons or add translations.
See docs/asset-packs.md for the pack format.
paint.js has a versioned JavaScript API for extensions that add effects, adjustments, or import and export formats. Plugins can include their own icons and other assets, use built-in configuration controls, and process either individual pixels or complete images.
Plugins are distributed as .paintjs packages. Install them from Settings → Plugins using the
plugin browser, file picker, or drag and drop. Start with the step-by-step
plugin API guide to build and package a plugin.
Maintained plugins live in the separate
paintdotjs-plugins repository. Its build creates
the plugin packages and catalog consumed by the in-app plugin browser.
Development requires Node.js 22 or newer. Install the dependencies first:
npm ciRun the development build in watch mode:
npm run web-watchIn a second terminal, start a local web server and open http://127.0.0.1:8773/:
npx http-server . -p 8773Do not open index.html directly from the filesystem because browser security restrictions disable
required functionality.
npm run appThe Flatpak manifest is in flatpak/net.paintjs.Paintjs.yml.
It builds the checked-out paint.js source with pinned dependencies, bundles the assets needed for
offline use, and keeps the application inside the Flatpak sandbox.
flatpak-builder --user --install --force-clean \
--install-deps-from=flathub flatpak-build flatpak/net.paintjs.Paintjs.yml
flatpak run net.paintjs.Paintjspaint.js is licensed under the MIT License. See the attribution notice for details about Paint.NET and the JavaScript port.


