Allusion Looks Abandoned: What to Use Instead in 2026

Allusion has not shipped an official release since February 6, 2023. Community issues report memory and database problems and point users toward forks. Those are useful maintenance signals, but they do not prove permanent abandonment or predict how every library will behave.

This page explains what happened, which alternatives are genuinely maintained, and what you will and will not carry with you when you switch.

What happened to Allusion?

Allusion launched in April 2021 as a free, open-source reference library manager. It filled a real gap: it indexed images in your existing folders without copying them, supported hierarchical tags, and ran on Windows, macOS, and Linux. For a free tool it was unusually good.

Active development continued through mid-2022, then stopped. The last official release, v1.0.0-rc.10, appeared on February 6, 2023. On April 16, 2025, GitHub user Zeragamba filed issue #649 titled "Project no longer maintained. Try these forks instead," pointing to the RafaUC fork and OneFolder as maintained alternatives. Zero maintainer response. AlternativeTo now lists Allusion as discontinued.

The project still has 886 GitHub stars and 73 forks as of June 2026. Community interest is real. But interest is not maintenance.

The memory leak (issue #640)

In November 2024, a Windows 11 user on Allusion rc.10 documented 14.4 GB of RAM consumed generating thumbnails for just 358 images. Memory is never reclaimed; only a full restart helps. The issue sits open with no response. For anyone actively collecting references, this makes the app unreliable on any library of real size.

The database failure (issue #604)

A separate issue documents Allusion stopping display of images once the database file reaches roughly 81 to 82 MB, corresponding to about 120,000 images. Users describe repeated backup-restore cycles with the problem recurring. For a tool meant to grow with a creative library, this is a hard ceiling with no fix available.

Beyond those two bugs: the Chrome extension was removed from the Chrome Web Store in June 2023 (it had 560 users at the time), leaving Chrome users with no browser clipper from the official project. macOS builds reportedly lack Gatekeeper signing (issue #643, December 2024), requiring users to manually bypass Apple's security warnings. None of these are fixed, and with no active maintainer, none will be.

Should you stay on the RafaUC fork?

The RafaUC fork (documented on LinuxLinks, March 2026, and referenced in issue #649) adds video and GIF playback, implied-tag relationships, and custom properties to Allusion's codebase. It is the most actively developed free option that stays close to Allusion's design.

The fork does not resolve the memory leak or database-size failure. Those issues are architectural, not configuration problems. It is also a solo community effort, not a commercially backed project, so it carries the same continuity risk as the original.

The video and GIF playback the fork is best known for is no longer a reason to stay on it. refern indexes video alongside images and opens it in a player with frame-by-frame stepping, A to B section looping, labelled markers, saving any frame as a PNG, and search by duration, frame rate, and codec. Animated GIFs step frame by frame too, both in the viewer and on the canvas.

If you need free, open-source, and you have a library under 50,000 images, the RafaUC fork is a reasonable short-term choice. If you are hitting the memory or database issues or you want new features, you need something else.

The maintained alternatives in 2026

A side-by-side view before the details.

Option 1: refern

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.

For Allusion users, the transition is low-friction on the file side. During normal workspace setup, refern indexes an existing folder in place and stores a sidecar database alongside, or in a configured data location associated with, the workspace. That normal indexing path leaves existing source files where they are. refern also has a dedicated Allusion importer (Settings > Import): export a backup from Allusion and refern recreates the supported folder and colored, nested-tag structure. That explicit import can copy supported external-source media into the workspace, so it has a different file-handling boundary from normal indexing.

What refern adds that Allusion never shipped:

Library metadata. Ratings (1 to 5 stars), color labels (18 colors), descriptions, notes, source URLs, creator fields, and smart folders. Directory metadata presets that auto-apply tags when images arrive in a folder.

Search depth. SQLite FTS5 full-text search supports 21 user-visible operator keywords. Queries such as tag:anatomy rating:>=4 type:image and is:duplicate color:#3a5f8a run on the device. Color search, visual similarity, and duplicate detection are local search tools that do not require uploading the library to a refern cloud service. This is not a claim that the whole application makes zero network requests.

Canvas. Allusion has no canvas; the standard workaround is to drag images into PureRef as a separate app. refern ships an infinite canvas with layers and groups, text, shapes, freehand drawing, image filters, and non-destructive crop. The pin-window-on-top mode with transparency and mouse click-through replaces the PureRef overlay workflow inside the same application.

Relationship graph. A navigable force-directed graph spanning folders, images, canvases, groups, and tags. Typed entity links (grouped, derived-from, placed-in-canvas, cross-reference) and a Linked References sidebar let you trace where images came from, where they were used, and how they connect to other assets. No equivalent exists in Allusion, Eagle, or TagStudio.

Browser extension. Chrome, Firefox, and Safari with hover-save, right-click save, batch save, and tag-on-save. Allusion's Chrome extension was removed from the Web Store in June 2023. The Firefox extension shows 173 users and was last updated July 2022. refern ships all three browsers.

Indexing architecture. refern uses a streaming indexing pipeline. This page does not publish a numerical capacity, memory, or speed comparison because no controlled cross-product benchmark is available.

What refern does not have yet. No plugin ecosystem or cloud sync today; both are planned without published dates. No AVIF support. No font management. If any of these are immediate requirements, weigh the other options below.

Price. $35 one-time. One license, up to 3 devices, commercial use included. The 30-day free trial requires no account. After 30 days, the app interface is gated by activation, while normal files and workspace data remain accessible on disk through the operating system.

Option 2: Eagle

Eagle is a mature digital asset manager developed by a Taipei-based team with a self-reported 400,000 or more users. It costs $34.95 one-time (as of 2026, up from $29.95 in November 2024) for 2 device activations with a 30-day free trial.

Eagle's genuine strengths: 99 to 108 native file format previews covering fonts, audio, video, 3D formats, and design source files. A plugin ecosystem with hundreds of community tools including AI auto-tagging via the AI Action plugin (available in the Plugin Center as of 2026). Active development through v4.0. A large, established user community with years of tutorials and write-ups.

Eagle's honest limitations for Allusion users: its standard import copies media into a managed .library. If source originals remain, media bytes exist in both locations, plus generated data; total storage is not universally or exactly doubled. Eagle has no official Linux client as of August 31, 2026. It also has no integrated canvas or relationship graph. The base license covers two devices, compared with up to three for one refern user.

Use Eagle if you need the broadest file format preview, font management, or access to a mature plugin ecosystem. Not the right fit if you want to keep files in their current folder structure without copying them, or if you are on Linux.

Option 3: TagStudio

TagStudio is a free, GPL-3.0-licensed Python application built around a rich hierarchical tag system. Like Allusion and refern, it indexes existing workspace files in place. It runs on Windows, macOS, and Linux and has 7,000 or more GitHub stars as of mid-2026.

TagStudio's genuine strength is its tag model. Tags are objects with names, aliases, colors, namespaces, and parent-child inheritance, and Boolean AND/OR/NOT search with glob path syntax gives real query power. It is free and open-source with a community-driven roadmap.

TagStudio's honest limitations: it is in alpha as of 2026 and users report sluggishness on large libraries. Python and PySide6 do not match the performance of a Rust-based tool at scale. There is no canvas, no color search, no visual similarity search, no duplicate detection, no browser extension, and no Eagle import. A GitHub discussion from May 2026 asks "Is this project still alive?" after a gap between releases. The single-root library constraint means files across multiple drives cannot be unified in one library (multi-root is planned, not shipped).

Use TagStudio if free and open-source is a hard requirement and you primarily need tag-based organization without a canvas or visual search tools. Not the right fit if you need a production-ready tool, a canvas, or any of the visual search features.

What you can and cannot take when you leave Allusion

Your image files. Allusion's normal watched-folder setup exposes images from their existing locations and does not document a managed media copy. The app can write EXIF and tag metadata, so it should not be described as read-only. Back up the folders before changing tools.

Your tags. These live in Allusion's local database. refern's dedicated importer recreates the folder tree, colored hierarchical tags, and provenance from an exported backup. Eligible sources already inside a content root can be reused; other supported sources are copied. PSD, KRA, and EXR entries are skipped.

Source URLs. If Allusion stored source URLs in image EXIF data, refern's metadata import reads EXIF/IPTC/XMP on import and populates the source URL field automatically.

Saved searches. Not portable. Recreate as smart folders in the new tool.

If your library originally came from Eagle. refern has a dedicated Eagle importer that reads folders, tags, ratings, source URLs, and notes. You do not need to retag from scratch if Eagle was your starting point.

There is no proprietary lock-in on either side. Both Allusion and refern let you walk away with all your files intact.

The verdict

Allusion earned its place in the artist community from 2021 to 2023. The non-destructive file philosophy, hierarchical tags, and cross-platform support were genuinely useful. The abandonment is the ordinary outcome of a small open-source project when maintainers move on, not a sign the tool was poorly designed.

In 2026, the practical choice breaks down cleanly by constraint:

Free and open-source: the RafaUC fork for Allusion-adjacent behavior, or TagStudio for a more actively developed option.

Widest file format preview and plugin ecosystem: Eagle at $34.95 one-time (Windows and macOS only).

Library plus canvas in one app, Linux support, in-place indexing for existing folders, color search, relationship graph: refern.

For a broader look at the options, see the best Allusion alternatives for artists roundup. For a direct side-by-side, see refern vs Allusion. For context on what to look for in any reference tool, see what is a reference manager.