Allusion Looks Abandoned: What to Use Instead in 2026

By refern | Last updated: June 2026

Allusion has not shipped a release since February 6, 2023. A GitHub issue filed April 2025 declared the project no longer maintained, 83 bugs sit open with no maintainer responses, and two critical unfixed problems (a 14.4 GB memory leak and a database failure at 120,000 or more images) make continued use increasingly painful. Your images are safe on disk. The tool that manages them is not.

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.

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

For Allusion users, the transition is low-friction on the file side. refern opens any existing folder as a workspace, indexes your images in place, and stores a sidecar database alongside your files. Nothing is moved or duplicated. Point refern at the same folders Allusion was watching and the indexer runs immediately.

What refern adds that Allusion never shipped:

Library metadata. Ratings (1 to 5 stars), color labels (9 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 with 14 or more inline operators. Queries like tag:anatomy rating:>=4 type:image or is:duplicate color:#3a5f8a run locally in milliseconds. Color search by hex input finds images by dominant hue, HSV histogram, and color layout with no API calls. Visual similarity search uses a local 512-byte descriptor to surface images that look like a selected reference. Duplicate detection via pHash identifies identical or near-identical copies across a large library. None of these exist in Allusion.

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.

Performance at scale. The streaming indexer is crash-resumable and designed around a bounded worker architecture, avoiding the all-in-memory-at-once pattern that causes Allusion's RAM collapse. A user with 27,000 images confirmed smooth performance at launch.

What refern does not have yet. No plugin ecosystem (planned post-launch). No local-model auto-tagging (planned). No cloud sync (Phase 2 roadmap). No AVIF support. No font management. If any of these are immediate requirements, weigh the other options below.

Price. $30 one-time at launch pricing, going to $35 about two months after launch. One license, up to 3 devices, commercial use included. 30-day free trial with no account required and no data locked on expiry.

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: it copies every file into a proprietary .library folder on import, so your disk usage doubles. Eagle's own documentation acknowledges this as a common question. No Linux client exists and none is planned. No canvas or moodboard. No relationship graph view. English-language support response times have been a consistent complaint across Capterra and Trustpilot reviews. Base license covers 2 devices vs refern's 3.

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 never copies your files. 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. They are exactly where you left them on disk. Allusion never copied them. Any alternative can point at the same folders.

Your tags. These live only in Allusion's local database. No maintained tool reads Allusion's database directly. You will need to recreate your tag hierarchy in whichever tool you choose. For heavily-tagged large libraries this is real work. For libraries with a flat or simple tag structure it is much faster.

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.