Switch From Eagle to refern (Migration Guide, 2026)

By refern | Last updated: June 2026

Switching from Eagle to refern takes about ten minutes. Your original files never move. The Eagle importer reads your library metadata directly and maps folders, tags, ratings, source URLs, and notes into refern. You can run both apps on the same folder at the same time during the transition.

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.

This guide covers why artists leave Eagle, exactly what transfers, the step-by-step import process, running both apps in parallel, what you give up, and how to decide if the switch is right for you.

Why artists leave Eagle

Eagle is a mature, well-made tool with genuine strengths: 99 to 108 native format previews (as of 2026), a mature plugin ecosystem, font management, and years of community tutorials. If those features are central to your workflow, the honest answer is to stay on Eagle or run both apps.

That said, a few structural issues push artists toward alternatives:

Eagle copies every file you import. Eagle physically moves your files into a proprietary .library folder. Eagle's own support FAQ addresses the common complaint "Why does the Eagle library take up more disk space than the actual files?" because this behaviour doubles disk usage for anyone with an existing organized folder structure. AlternativeTo user feedback confirms disk doubling as the most frequently cited frustration. If you have 200 GB of references, Eagle wants another 200 GB to store its copy.

No Linux. Eagle officially confirms: "Eagle currently only provides Windows and macOS versions, and has not yet released a client application for the Linux platform." (Eagle Linux FAQ) Wine workarounds are unstable. There is no planned Linux release.

No canvas or moodboard. Eagle is purely a library manager. Artists who want to compose references into a layout, pin a reference window over their painting app, or sketch alongside their image collection must switch to PureRef or Figma and lose the library context.

No relationship graph. There is no way in Eagle to see how images, folders, canvases, and tags connect to each other or to trace which canvas an image appears on.

If any of these match why you are looking to switch, read on.

What transfers from Eagle to refern

Before you run the importer, know exactly what comes across and what stays behind.

What the Eagle importer preserves

What does not transfer

Your originals are read exactly where they sit on disk. Nothing is moved, renamed, or duplicated.

Step-by-step: importing your Eagle library

Before you start

• Download refern at refern.app. The 30-day free trial includes the full importer.
• Make sure your Eagle library is accessible (local drive, not inside an encrypted vault).
• You do not need to close Eagle before importing. Both apps can read the same files.

Step 1: Open refern and create a workspace

Launch refern and choose "New Workspace." Point it at any folder. If you want refern to index your existing files exactly where they live, point the workspace at the root folder that contains your files (not the Eagle .library folder, but the original source folder if your originals were elsewhere before Eagle copied them).

refern will scan the folder and build an index. For large libraries this takes a few minutes the first time.

Step 2: Run the Eagle importer

1. Open Settings (gear icon, bottom-left sidebar).
2. Go to Import and choose Import from Eagle.
3. Select your Eagle .library file or point to the Eagle library folder on disk.
4. refern reads the Eagle metadata database directly. It maps Eagle folders to refern folders, tags to refern tags, star ratings to refern ratings, source URLs to refern source fields, and notes to refern notes.
5. Review the import summary and confirm. The importer is non-destructive: if you run it again it will not create duplicates.

The process runs in the background. A progress indicator shows in the bottom bar. For libraries with tens of thousands of items, allow 5 to 20 minutes depending on drive speed.

Step 3: Verify the import

After the importer finishes:

• Browse your folder tree and confirm nested folders carried over.
• Open the tag panel and confirm your tags appear.
• Select a few images and check that ratings, source URLs, and notes populated correctly.
• Search for a tag you know exists in Eagle and confirm results return.

If any tags or ratings are missing on specific files, check whether those files were inside Eagle's own generated .library folder (Eagle copies). If Eagle stored the originals elsewhere on disk before you imported them, they may be at a different path than refern expects. Point refern's workspace at the folder where the actual files live.

Step 4: Run both apps in parallel

You do not need to quit Eagle or commit to refern immediately. Because refern indexes files in place and never modifies originals, Eagle and refern can read the same files at the same time without conflict.

A practical parallel-running approach:

• Continue saving new references through Eagle's browser extension while you evaluate refern's extension.
• Use refern's canvas for any new moodboards you create.
• After two weeks, check whether you are opening Eagle at all.

The only thing to watch: if you move files in Eagle (which moves them inside the .library folder), refern will not automatically detect that move. Run a "Sync with disk" reconcile in refern after any major reorganization in Eagle to keep the index current.

Step 5: Switch your browser extension

refern ships browser extensions for Chrome, Firefox, and Safari (Edge and Brave via the Chrome extension). Install the refern extension and unpin Eagle's extension. The refern extension supports hover-save, right-click save, batch save, and per-site controls.

You do not need to do this on day one. Switch when you are comfortable.

After the switch: what refern adds

Once your library is in refern, a few features become available that Eagle does not have.

Infinite canvas. Drag images from your library onto a canvas, arrange them in layered groups, add text and shape annotations, draw freehand, and crop non-destructively. Pin the canvas window on top of your painting app with transparency and mouse click-through enabled (the PureRef overlay use case, built into the same app). See the canvas feature overview.

Relationship graph view. Every image, folder, canvas, group, and tag appears as a node in a navigable full-screen graph. Connections between them (which images appear in which canvas, which images are grouped together, which were cropped from which source) are drawn as edges. The graph works like Obsidian's graph view but for visual assets.

Search operators. refern's search goes beyond keyword and color. Operators include type:image, rating:>=4, tag:landscape, is:duplicate, derived:, linked:, and color: (by hex). You can chain multiple operators in one query. All search runs locally with no API calls.

No disk lock-in. refern stores its index as a refern-db.sqlite file and a thumbnails folder alongside your originals. If you stop using refern at any point, your files are exactly as they were before. Delete the index and thumbnails and the folder is clean.

What you give up

Be honest with yourself about the gaps before switching.

Font management. Eagle can preview and categorize font files without installing them. refern does not have this. If your Eagle workflow centers on managing a large font collection, you either keep Eagle running for fonts or use a dedicated font manager.

Format preview breadth. Eagle previews 99 formats on Windows and 108 on macOS (as of 2026). refern previews images, video, and PDF natively. Creative source files like PSD, AI, and Sketch files are indexed with full metadata but are not rendered as thumbnails. If you rely on thumbnail previews for non-image formats every day, Eagle has a real advantage here.

Plugin ecosystem. Eagle's Plugin Center has hundreds of community plugins for format conversion, AI tools, downloaders, and workflow automation. refern has no plugin system at launch. A plugin system is planned for a future release, but it is not shipped today.

Local auto-tagging. Eagle's AI Action plugin (announced March 2026 for Eagle 4.0) can auto-name and auto-tag images on import. refern's equivalent (a local-model auto-tagging feature) is planned but not yet shipped.

Established community. Eagle has years of YouTube tutorials, forum posts, and third-party write-ups. refern's community is smaller and newer.

Feature comparison: Eagle vs refern

Who should switch now

Switch to refern if:

• Eagle's disk doubling is eating your storage and you want your files indexed in place without a copy.
• You are on Linux, where Eagle has no native client.
• You use PureRef for moodboards and want the canvas and library in the same app.
• You want Obsidian-style graph navigation across your image collection.
• You want to track which images appear in which canvas, or which images were cropped from which source.
• You want more search operators: linked:, derived:, is:duplicate, and others Eagle does not have.
• You want three device activations at the base price (Eagle's base is two).

Who should stay on Eagle (or run both)

Stay on Eagle, or continue running both, if:

• Font preview and categorization is a core part of your daily workflow.
• You need thumbnail previews for audio, 3D, or design source files that refern does not render.
• You rely on Eagle's plugin ecosystem for format conversion, AI batch operations, or specialized downloaders.
• You have a very large, stable Eagle library and workflow you do not want to disrupt.
• The AI Action plugin's automatic tagging on import is something you use every day and do not want to give up while refern's equivalent is still in development.