refern vs Allusion: Active vs Stalled (2026)

TL;DR: Both refern and Allusion can index watched folders without moving the existing media during normal indexing, and both support hierarchical tags. Allusion's latest official release is 1.0.0-rc.10 from February 6, 2023; open issues report serious failures in particular setups, but they do not establish universal file-count ceilings. refern adds an infinite canvas, color and visual-similarity search, a relationship graph, and actively maintained browser extensions.

Quick verdict

Introduction

If you are looking at both tools, you are probably an artist who wants a local, folder-based reference library with hierarchical tags and in-place indexing for existing folders. Both refern and Allusion fit that description on paper. The practical question is whether the tool you choose will still work next year, and whether it can grow with your library.

This comparison is written from the refern team's perspective but cites Allusion's own GitHub record. We include Allusion's real strengths and send some readers there when it is the right call.

refern is a desktop reference manager for artists that combines Eagle-style organization with a PureRef-style infinite canvas and an Obsidian-style relationship graph. It costs $35 one time, runs on Windows, macOS, and Linux, and indexes existing folders in place.

What is refern?

refern is a local-first desktop visual reference manager. Normal workspace indexing leaves existing images in place and builds a local SQLite index and thumbnail cache; explicit imports can copy. The library view offers masonry, justified, and horizontal grids with full-text search across 21 user-visible operators (including color:, rating:, is:duplicate, tag:, and type:). An infinite canvas handles the PureRef overlay workflow. A relationship graph view connects images, folders, canvases, and groups, and a browser extension works across Chrome, Firefox, and Safari. It costs $35 one-time with a 30-day free trial and no account required.

What is Allusion?

Allusion is a free, GPL-3.0 desktop application for organizing visual reference libraries. It was released in April 2021 by Daniel Kreuter, Chi, and Remi van der Laan after two years of development [5][13]. It indexes images from watched folders on disk, supports hierarchical tags with color coding, and provides a saved-search feature added in an update from March 2022 [7]. It explicitly positions itself as a library layer designed to complement PureRef via drag-and-drop [1].

Allusion has genuine strengths: it is free under GPL-3.0, forkable, and officially packaged for Windows, macOS, and Linux. It watches existing folders instead of requiring a managed media copy. Its metadata import/export tools are also useful, although export can write keywords back to files and should be tested on backups first.

The central risk is the release gap: the latest official build remains 1.0.0-rc.10 from February 6, 2023 [7]. Community users have proposed forks and alternatives, and unresolved issues remain. Those signals justify caution, but they do not prove a formal discontinuation.

Organization and search

refern: The library supports hierarchical tags with tag groups, linked tags, and tag macros for bulk insertion. Metadata includes ratings, color labels, descriptions, notes, source URL, creator, and custom metadata. Smart folders save queries. Full-text search uses SQLite FTS5 BM25 with 21 user-visible operators. Color search, visual similarity, duplicate detection, and optional on-device tagging run locally without a search API; downloading a tagger model uses the network.

Allusion: Hierarchical tags with color coding are a core feature [1]. Saved searches were added in rc7 (March 2022) [7]. Basic multi-criteria filtering combines source folder, tags, and metadata. There is no color search, no visual similarity search, no duplicate detection, no ratings, and no color labels. The search system is functional for basic tag-based retrieval but does not approach the depth of refern's operator set.

Verdict: Both support hierarchical tags. refern adds color, visual similarity, duplicate detection, and 21 user-visible operators; Allusion remains a capable free folder-and-tag organizer.

Canvas and moodboard

refern: The infinite canvas supports layers and groups, text, 9 shape primitives, freehand drawing (via perfect-freehand), image filters, and non-destructive crop for canvas images. The canvas window can be pinned on top of other applications with configurable transparency and mouse click-through, which directly replicates the PureRef overlay workflow. The "find similar" radial menu works inside the canvas. Canvas files are saved as .refern-canvas JSON files in your folder alongside your images.

Allusion: There is no canvas or moodboard feature [1]. This is an intentional design decision: Allusion was positioned explicitly as a library layer to complement PureRef, not to replace it. Users who want to create reference boards must run PureRef as a separate application, manage two windows, and drag images between the two tools.

Verdict: refern. If a canvas is any part of your workflow, Allusion cannot help. This is not a gap that any fork or update can address without a significant rewrite.

Relationships and graph view

refern: Typed entity links connect images and files across the library. Link kinds include member-of (groups/fan cards), derived-from (crop provenance), placed-in-canvas, and cross-reference. A Linked References sidebar shows backlinks for any image. The relationship graph view at /graph renders a navigable force-layout graph across all folders, images, canvases, groups, and tags, functioning as an Obsidian-style knowledge graph for visual references.

Allusion: No entity linking, no cross-reference, and no graph view [1]. The data model is flat: tags are the only relational layer, and they connect images to label strings rather than to other images or canvases.

Verdict: refern. For users who want to trace where an image came from, which canvases use it, or how references relate to each other, Allusion has no answer.

Browser extension and import

refern: The browser extension works on Chrome, Firefox, and Safari with hover-save, right-click save, and batch save. Images can be tagged at the time of capture. Drag-and-drop and paste import work alongside a folder import with a staging area. The Eagle importer reads Eagle folders, tags, ratings, sources, and notes. On import, refern reads embedded EXIF, IPTC, and XMP metadata (keywords, ratings, descriptions, source, creator) and applies them automatically, preserving metadata from Lightroom, DigiKam, Bridge, or Immich libraries.

Allusion: The Firefox browser extension communicates with Allusion via a local server on port 5454 and saves the source URL in EXIF data [10]. The Chrome extension was removed from the Chrome Web Store on June 16, 2023 (it had 560 users at removal) [11]. The Firefox extension has 173 users and was last updated July 12, 2022 [9]. There is no Eagle import and no EXIF/IPTC/XMP metadata auto-import. Screenshot capture pastes directly into Allusion [10].

Verdict: refern for Chrome users (who have no Allusion extension available at all), for Eagle migrators, and for users with existing metadata in their files. The Firefox extension situation is a coin flip for Firefox users who only need basic capture.

Performance and reliability at scale

refern: The streaming indexing pipeline processes images in phases and can resume an interrupted scan. Periodic backups with restore are built in, and reconcile re-syncs the index with disk. A controlled cross-product scale benchmark is still pending.

Allusion: Several GitHub issues report performance or reliability failures in particular setups:

1. GitHub issue #640 (November 5, 2024): 14.4 GB RAM consumed generating thumbnails for 358 images on Windows 11, running rc.10. Memory is never reclaimed without a restart. No maintainer response. [14]
2. GitHub issue #604: The app stops displaying images once the database exceeds approximately 81 to 82 MB, which occurs around 120,000 images. The user had to restore from backups repeatedly with no permanent fix. [15]
3. GitHub issues #389 and #423: Crashes in the image viewer with large tag collections, and crashes at startup file-check at library sizes ranging from 40,000 to 300,000 files.

These reports are meaningful risk signals, but they are not a controlled benchmark and do not establish a universal file-count ceiling across operating systems and hardware.

Verdict: Test Allusion with a backup of your real library before committing. No numerical comparison is published here until both products are tested under the same protocol.

macOS experience

refern: Signed and distributed as a standard macOS application. No Gatekeeper bypass required.

Allusion: GitHub issue #643 (December 28, 2024) is titled "Is there no Gatekeeper-signed build for MacOS?" and reports that Allusion builds do not appear to be Gatekeeper-signed. macOS users running default security settings must manually bypass Gatekeeper to launch the app. No maintainer response or fix has been shipped. [confirmed: GitHub issues list]

Verdict: refern for macOS users who do not want to modify security settings.

Pricing

Allusion's price advantage is real and significant. $0 is always less than $35. For artists on tight budgets or those who specifically want GPL software they can fork and modify, Allusion wins on price regardless of the other comparisons above.

Full feature comparison

Who should choose refern

Choose refern if any of the following describe you:

• You are hitting Allusion's RAM leak or database ceiling, or you are worried about hitting them as your library grows.
• You want a canvas for reference boards and do not want to run PureRef as a separate tool.
• You use Chrome and lost access to the Allusion web clipper.
• You want color search, visual similarity, or duplicate detection, none of which Allusion has.
• You are migrating from Eagle and want your folders, tags, ratings, and notes preserved.
• You want active bug fixes, new features, and a maintained tool you can rely on in two years.
• You use macOS and prefer a properly signed app.

Who should choose Allusion

Choose Allusion if any of the following describe you:

• Free is a hard requirement and $35 is genuinely out of reach right now. Allusion's zero price is its real, irreplaceable advantage.
• You want open-source GPL software you can fork, inspect, and modify yourself.
• Your library is small (under 50,000 images), your needs are limited to basic tag-based search, and you have no canvas or color search requirements.
• You specifically want to complement PureRef via drag-and-drop and prefer the two-app workflow.
• You use the RafaUC fork, which adds video playback and custom properties and was updated in early 2026 [4]. Check both the fork and main repository before deciding which maintenance path fits.

Be aware that Allusion's long release gap and unresolved issue reports create maintenance risk. Their future resolution is unknown.

Switching from Allusion to refern

refern has a dedicated Allusion importer. Export a backup from Allusion, then choose Import from Allusion in refern. It recreates the folder structure and colored nested tags. Files already indexed inside the workspace are reused in place; external files are copied into an Allusion Import folder. Keep the backup until you verify the result.

What transfers:

• All image files (refern re-indexes them in place when they already live in the workspace).
• Your folder structure and Allusion's colored, nested tags, via the Allusion backup importer.
• Any EXIF/IPTC/XMP metadata embedded in the images themselves (refern reads this on import).
• Source URLs that Allusion wrote into EXIF data on web clips [10].

What does not transfer:

• Allusion's saved searches (you recreate them as smart folders in refern).

If your images came from Eagle originally, refern also has a dedicated Eagle importer that reads folders, tags, ratings, sources, and notes directly.

For more on migrating from other tools, see the refern vs Eagle comparison or the best Eagle alternatives guide.

The verdict

Allusion set out to solve a real problem for artists, and its free GPL license, watched-folder model, and hierarchical tags remain a useful foundation. Its old release date and unresolved issue reports create maintenance and reliability risk, but users should assess the current repository and forks rather than treating a third-party discontinued label as definitive.

refern is not a drop-in replacement at $0. The decision is whether its maintained canvas, visual search, graph, and browser capture are worth $35 for your workflow. Performance should be evaluated with the same real-library test in either app.

If $35 is out of reach, the RafaUC fork is the better Allusion variant to use. If you are ready to evaluate the full picture, the 30-day trial costs nothing.