refern vs Allusion: Active vs Stalled (2026)

By refern. Last updated: June 2026.

TL;DR: Both refern and Allusion index your images in place without copying them and both support hierarchical tags. The difference is what has happened since 2023. Allusion released its last update on February 6, 2023, has a documented 14.4 GB RAM leak triggered by as few as 358 images, and fails to display libraries larger than roughly 120,000 images with no fix shipped. refern launched in 2026 with an infinite canvas, color search, visual similarity, a relationship graph view, and active development.

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 no file copying. 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 $30 one time, runs on Windows, macOS, and Linux, and does not copy your files.

What is refern?

refern is a local-first desktop visual reference manager. It indexes your images in place inside any folder you point it at, stores a SQLite index and thumbnails alongside your files, and never copies or moves your originals. The library view offers masonry, justified, and horizontal grids with full-text search across 14 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 $30 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 forever with no upsell, it is GPL-licensed and forkable, it supports Linux alongside Windows and macOS, and it shares refern's philosophy of referencing files in place rather than copying them. Its "never lose another reference" promise is clean and memorable.

The central problem is that it has not been updated since February 6, 2023 [7]. A community issue filed April 16, 2025, is titled "Project no longer maintained - Try these forks instead" and directs users to the RafaUC fork and OneFolder as active alternatives [6]. AlternativeTo lists it as discontinued as of 2026 [16]. The 83 open GitHub issues include documented bugs with no maintainer responses [2].

Organization and search

refern: The library supports hierarchical tags with tag groups, linked tags, and tag macros for bulk insertion. Metadata includes ratings (1 to 5 stars), color labels (9 colors), descriptions, notes, source URL, creator, and custom metadata. Smart folders save any search query as a persistent folder. Full-text search uses SQLite FTS5 BM25 with 14 inline operators. Color search finds images by dominant color, HSV histogram, and color layout using a local hex or color-picker input. Visual similarity search uses a local 512-byte descriptor, and duplicate detection uses pHash. All search is local and runs with no API calls.

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 tools support hierarchical tags, which is table stakes. refern's search depth (color, visual similarity, duplicates, 14 operators) is in a different category. For users who need more than tag filters, the gap is large.

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 (scan, thumbnail, reconcile) with a bounded worker architecture. A user with 27,000 images has confirmed smooth performance. The pipeline is crash-resumable: if the app closes mid-index, it resumes from where it stopped. Periodic backups with one-click restore are built in. A reconcile command re-syncs the index with disk when files change outside the app.

Allusion: Three documented performance failures exist in the GitHub issues with no fixes shipped:

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.

The memory leak alone (14.4 GB at 358 images) is severe enough to affect users with modest libraries on any modern machine. The database ceiling makes Allusion unsuitable for photographers, concept artists, and 3D artists building large collections over time.

Verdict: refern, significantly. The documented Allusion failures are not edge cases; they occur at library sizes that active working artists accumulate within months.

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 $30. 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 $30 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]. The community fork is a more viable option than the abandoned main project.

Be aware that choosing Allusion means accepting that known bugs (including the RAM leak and the database ceiling) will not be fixed by the original maintainers.

Switching from Allusion to refern

Because both tools reference files in place, the migration is simpler than it might seem. Your image files are already on disk exactly where Allusion left them. refern can open any folder that Allusion was watching, and it will build its own index from your existing files.

What transfers automatically:

• All image files (refern re-indexes them from the same folders on disk).
• 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 tag database (tags are stored in Allusion's own SQLite file, not embedded in the images). You will need to re-apply tags in refern or use refern's EXIF metadata import to pick up any keywords embedded in the files.
• Allusion's saved searches (you recreate them as smart folders in refern).

If your images came from Eagle originally, refern's Eagle import reads folders, tags, ratings, sources, and notes directly, which may be a faster path than rebuilding from Allusion.

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