Skip to content

About

paint.js is a proof-of-concept, cross-platform raster graphics editor written in JavaScript. It’s a port of Paint.NET v3.36.7, bringing the best Windows painting tool to macOS, Linux, and the web via Electron and the browser.

Topics

Resources

Stars

83 stars

Watchers

4 watching

Forks

Repository files navigation

header.png

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+.

Why?

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.

License

Desktop application

Web application

Installation

Web

Use paint.js directly at paintjs.net. No installation is required.

Arch Linux

Install paintdotjs-bin from the AUR with an AUR helper, for example:

yay -S paintdotjs-bin

Flatpak

Download the latest .flatpak bundle from GitHub Releases, then install it with:

flatpak install --user ./paintdotjs-*-linux-x86_64.flatpak

The bundle uses the Freedesktop runtime from Flathub, but paint.js itself is installed directly from the downloaded file.

macOS

Download the latest universal .dmg from GitHub Releases, open it, and drag paint.js into the Applications folder.

Differences from Paint.NET

paint.js is largely feature-complete and closely reproduces the Paint.NET experience, but there are still some additions and limitations worth noting.

Added in paint.js

  • 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 .xaml files 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.

Missing or limited compared with Paint.NET

  • 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.

Image formats

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.

Icon Packs

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.

Plugin API

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

Development requires Node.js 22 or newer. Install the dependencies first:

npm ci

Run the web version

Run the development build in watch mode:

npm run web-watch

In a second terminal, start a local web server and open http://127.0.0.1:8773/:

npx http-server . -p 8773

Do not open index.html directly from the filesystem because browser security restrictions disable required functionality.

Run the Electron app

npm run app

Build the Flatpak

The 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.Paintjs

License

paint.js is licensed under the MIT License. See the attribution notice for details about Paint.NET and the JavaScript port.

About

paint.js is a proof-of-concept, cross-platform raster graphics editor written in JavaScript. It’s a port of Paint.NET v3.36.7, bringing the best Windows painting tool to macOS, Linux, and the web via Electron and the browser.

Topics

Resources

Stars

83 stars

Watchers

4 watching

Forks

Releases

Packages

Contributors

Languages