abr-brush-importer

ABR Brush Importer — Krita Plugin

A Krita Python plugin that imports Adobe Photoshop .abr brush files directly into Krita with full dynamics, dual brush support, and 17 traditional paint medium modes — from pixel brushes to oil, watercolour, charcoal, and more.

---

Table of Contents

• Features
• Paint medium modes
• Comparison with GIMP's built-in ABR importer
• Comparison with Photoshop
• Requirements
• Installation
• Usage
  • Drop-folder (automatic)
  • Interactive dialog
  • Import from a URL
  • Automatic Import settings
• Import options
• Standalone converter
• Running the tests
• Cache and settings locations
• Security notes

---

Features

• Parses ABR versions 1, 2, 6, 7, 9, and 10
• Every imported brush produces both a full preset and a brush tip:
  • .kpp → paintoppresets/ — Krita Preset (preserves dynamics: spacing, opacity, flow, scatter, jitter, pressure curves, smoothing, wet edges, …). Appears in the Brush Presets docker.
  • .gbr → brushes/ — GIMP Brush v2 (recognized by Krita as a brush tip). Appears in the Predefined Brush Tips tab.
  • .png — optional plain image of the brush tip
• 17 paint medium modes — import any ABR brush as a pixel brush, pencil, chalk, charcoal, ink, marker, airbrush, spray paint, gouache, oil, acrylic, tempera, watercolour, encaustic, fresco, or more (see table below)
• Dual brush support — ABR dual brush settings are mapped to Krita's masking brush with correct composite mode, scatter, spacing, and flip. Sampled dual brush tips are resolved by name and written as separate .gbr files; computed tips are generated automatically as fallback
• Full dynamics mapping — ABR brush dynamics (opacity, flow, scatter, size/angle/roundness jitter, pressure curves, color dynamics, purity/fg-bg mixing, noise, wet edges, smoothing, airbrush, flip) are all mapped to Krita's native sensor system
• 17 PS blend modes mapped to Krita composite operations (multiply, darken, screen, overlay, soft light, hard light, vivid light, etc.)
• Texture / pattern support — ABR texture settings are mapped to Krita's pattern overlay system; noise is approximated with a grain texture
• Auto-generated .bundle — a Krita resource bundle containing all presets, brush tips, and patterns is created automatically on every import for easy backup and sharing
• Automatic drop-folder — place .abr files in a watched folder and they are imported on every Krita startup, or continuously in the background
• Online ABR — paste a URL pointing to a .abr file or a .zip archive; the plugin downloads, caches, and loads the brushes automatically
• Import tracking — an on-disk database skips files that have not changed since the last import
• Multi-directory replication — brush files, presets, and bundles are automatically copied to all detected Krita resource directories (Flatpak, Snap, native)
• All background work runs on a dedicated thread — Krita's UI is never blocked
• Live preview with per-brush metadata
• Batch import of all or selected brushes
• Exports embedded Photoshop patterns as PNG files

---

Paint medium modes

The plugin offers 17 paint engine modes, selectable from a dropdown in the import dialog. Any ABR brush shape can be imported as any medium type.

Dry media (paintbrush engine)

Wet / mixing media (colorsmudge engine)

Note: Photoshop ABR files only store brush tip shapes and dynamics — they do not contain paint medium information. These modes apply Krita engine parameters tuned from Krita's own built-in reference presets to give the imported brush shape the feel of each medium.

---

Comparison with GIMP's built-in ABR importer

Overall fidelity: ~95% vs GIMP's ~5% — GIMP extracts only the raw stamp shape; this plugin preserves virtually all ABR brush behaviour.

---

Comparison with Photoshop

Photoshop is the native ABR format, so it reads its own presets at 100% fidelity. This plugin can't beat that. But it goes beyond what Photoshop does with ABR files:

---

Requirements

• Krita 5.x with Python scripting enabled
• Python 3.8+
• PyQt5 (bundled with Krita)

---

Installation

Linux — native Krita

git clone https://github.com/kennethyork/abr_brush_importer.git
cd abr_brush_importer
bash install_local.sh

Installs to ~/.local/share/krita/pykrita/abr_brush_importer/.

Linux — Flatpak Krita

git clone https://github.com/kennethyork/abr_brush_importer.git
cd abr_brush_importer
bash install_flatpak.sh

Installs to ~/.var/app/org.kde.krita/data/krita/pykrita/abr_brush_importer/.

Tip: If you're not sure which you have, run flatpak list | grep krita. If it prints a result, use install_flatpak.sh.

macOS

git clone https://github.com/kennethyork/abr_brush_importer.git
cd abr_brush_importer
bash install_macos.sh

Installs to ~/Library/Application Support/Krita/pykrita/abr_brush_importer/.

Windows

git clone https://github.com/kennethyork/abr_brush_importer.git
cd abr_brush_importer
install_windows.bat

Installs to %APPDATA%\krita\pykrita\abr_brush_importer\.

Manual (any platform)

1. Locate your Krita pykrita folder:
   • Linux (native): ~/.local/share/krita/pykrita/
   • Linux (Flatpak): ~/.var/app/org.kde.krita/data/krita/pykrita/
   • macOS: ~/Library/Application Support/Krita/pykrita/
   • Windows: %APPDATA%\krita\pykrita\
2. Create a sub-folder named abr_brush_importer/ inside it.
3. Copy abr_brush_importer.desktop into the pykrita root.
4. Copy all abr_brush_importer/*.py files into the sub-folder.

Enable in Krita

1. Open Krita.
2. Go to Settings → Configure Krita → Python Plugin Manager.
3. Tick ABR Brush Importer and click OK.
4. Restart Krita.

---

Usage

Drop-folder (recommended — fully automatic)

The simplest way to use the plugin: create a folder called abr_brushes inside Krita's resource directory, drop your .abr files into it, and restart Krita. The plugin scans this folder automatically on every startup and imports any new or changed brushes — no dialog required.

Imported brushes appear as full presets in the Brush Presets docker and as brush tips in the Predefined Brush Tips panel. A .bundle file is also created automatically. Files that have not changed since the last import are skipped automatically.

Interactive dialog

Open the importer via Tools → Scripts → Import ABR Brushes…

1. Click Open ABR File… and select a .abr file.
2. Browse the brush list; click any brush to preview it.
3. Select the brushes you want (Select All / Select None as needed).
4. Choose the Paint engine from the dropdown (Pixel, Chalk, Oil, etc.).
5. Adjust import options (invert, pressure sensitivity).
6. Click Import Selected.

Import from a URL (Online ABR)

1. Paste a URL into the Online ABR text box. Supported formats:
   • Direct .abr link: https://example.com/my_brushes.abr
   • .zip archive containing one or more .abr files: https://example.com/brushpack.zip
2. Click Download — a progress bar shows download status. If the archive contains multiple .abr files, a dialog lets you pick one.
3. The downloaded brushes load automatically; proceed as with a local file.
4. The file is cached locally; click Force Refresh to re-download.
5. Click Clear Cache to remove all cached downloads.

Automatic Import settings (in the dialog)

The Automatic Import section of the dialog configures background importing:

Settings are saved automatically and restored on the next launch.

---

Import options

Imported presets are written to <krita-resources>/paintoppresets/ and brush tips to <krita-resources>/brushes/. A .bundle containing everything is placed in the resource root. If brushes are not visible immediately, go to Settings → Manage Resources or restart Krita.

---

Standalone converter (no Krita required)

python3 standalone.py <file.abr> [output_dir]

Converts every brush in file.abr to .gbr, .png, and .kpp files and writes them to output_dir (defaults to ./abr_output). No Krita installation is needed.

---

Running the tests

The test suite (70 tests) runs with plain Python and has no external dependencies:

python3 test_plugin.py

---

Cache and settings locations

All plugin data is stored under <krita-resource-dir>/abr_importer_cache/:

To free space, click Clear Cache in the plugin UI or delete the abr_importer_cache/ folder manually.

---

Security notes

• Downloads are capped at 200 MB by default to prevent runaway transfers.
• Only .abr files are extracted from zip archives; all other entries are ignored.
• Zip-slip path traversal attacks are blocked: extracted files are always placed directly inside the cache directory, regardless of the path stored in the archive.