Switch from PureRef to refern Without Losing Your Workflow (2026)

By refern. Last updated: June 2026.

TL;DR: refern imports the images straight out of your PureRef .pur boards (Settings > Import) and indexes any existing image folders in place. Your files stay put. You get a persistent library with full-text search, tags, and color search, plus the always-on-top overlay and click-through your painting workflow depends on. The one thing that does not carry over is the spatial board layout, so you rebuild the boards you actively use as refern canvases.

What transfers, what does not, and what gets better

PureRef is a genuinely excellent tool. It is free for personal use, extremely lightweight, and the best in class for putting references on screen while you paint. If you have used it for years, the overlay habit is real muscle memory.

The reason artists switch is almost always the same: PureRef has no search, no tags, and no persistent library. [pureref.com/handbook/features] Each .pur file is a standalone board. Once your reference collection grows past a few hundred images, finding anything specific requires scrolling through a spatial canvas by eye. There is no filename search, no color filter, no "show me everything tagged anatomy."

refern is the other side of that problem. It is a desktop reference manager that combines Eagle-style library organization with a PureRef-style infinite canvas and an Obsidian-style relationship graph. It costs $30 one-time and runs on Windows, macOS, and Linux.

What transfers easily: your image and video files, your folder structure, the images inside your .pur boards (refern's PureRef importer pulls them out), and any metadata embedded in the files (EXIF, IPTC, XMP is read automatically on import). The overlay habit transfers too because refern has pin-on-top, adjustable transparency, and mouse click-through.

What does not transfer automatically: the spatial layout of your .pur boards. refern's importer extracts the images from a .pur file, not their exact arrangement on the canvas. Boards you want to keep get rebuilt as refern canvases, which is quick because the images are already in your library.

What gets better: everything search-related, everything library-related, and anything involving references across more than one project.

Before you start

Here is what to check before migrating:

1. Gather your .pur files and any loose image folders. PureRef embeds images inside the .pur file, so some of your references may exist only inside those binary files with no corresponding folder of loose images. refern's PureRef importer reads the images out of a .pur directly, and it can index a folder of loose images and video in place. Collect both.
2. Decide what to import. You can point refern's PureRef importer at each .pur board to pull its images into your workspace, add folders of loose images as a workspace, or both.
3. Decide on a folder structure. refern treats a folder on disk as a workspace. A flat "all references" folder works, but folders by project, subject, or category give you more to search against later.
4. Download refern. The 30-day free trial requires no account. Download at refern.app.

Step 1: Create a workspace in refern

Open refern and choose "New Workspace." Point it at the folder that contains your reference images. If you already have a well-organized folder (by project, by subject, etc.), point refern at the root of that structure.

refern scans the folder and builds a SQLite index alongside your files. It writes a small database file and a refern-thumbnails/ folder next to your images. Your originals are never copied, never moved, and never modified. If you remove refern later, your files are exactly as you left them.

For very large collections (tens of thousands of images), the first index pass takes a few minutes. A progress card shows the scan, thumbnail generation, and estimated time remaining. After that, all queries are instant.

Step 2: Import the images from your .pur boards

Open Settings > Import and choose Import from PureRef. Point it at a .pur file and refern pulls the images embedded in that board out into your workspace. Repeat for each board you want to bring across. Any folders of loose images you added in Step 1 are already indexed.

A "Reuse files already in this workspace" option is on by default. When a board references an image that already lives inside your library (for example, a loose folder you indexed in Step 1), refern points to that file in place instead of writing a second copy, so you do not end up with duplicates. Images that live elsewhere are still copied into a new import folder.

Boards whose originals moved. If you renamed or relocated files after saving a board, the importer recovers those images anyway instead of skipping them, so boards you saved years ago still come across intact.

A note on source URLs. PureRef does not store source URLs per image in a machine-readable format. If you have notes on a board with URLs, copy them to refern's metadata sidebar manually for the images you care about. refern stores source URL, creator, description, and notes per image, all searchable.

Step 3: Recreate your overlay setup

This is the step most PureRef users worry about most, and it is straightforward.

In refern, open any canvas file (or create a new one from the sidebar). Drag images from the library grid onto the canvas. Then:

• Pin on top: in the window frame controls, enable "always on top." The canvas window stays above Photoshop, Blender, ZBrush, or any other application.
• Window transparency: use the opacity slider to make the refern window semi-transparent, so you can see your painting underneath.
• Mouse click-through: enable click-through mode. Mouse events pass through the refern window to whatever is underneath. You can eye-drop colors from references without switching focus.

The result is functionally identical to the PureRef overlay workflow. The main difference is that you opened refern's canvas from a library that has search and tags, so you can find the specific references you want before opening them on the overlay.

One thing PureRef does slightly better here: the "pin above a specific application" feature (added in PureRef 2.0), which keeps the overlay on top of one target app only. [pureref.com/blog/pureref2] refern's pin-on-top keeps the window above all applications. For most single-monitor setups this does not matter, but if that specific feature is load-bearing for your workflow, it is worth noting.

Step 4: Tag and organize your imported references

Once refern has indexed your images, open the library and start tagging. This is optional but transforms the value of the tool, and you do not have to do it all by hand.

Auto Tagger. refern ships an on-device Auto Tagger that suggests tags, reads the text inside an image, and can describe it, so you can label a large imported library fast. It is fully offline and opt-in: nothing runs or downloads until you turn it on. Run it across the whole workspace or just selected folders, then accept or skip suggestions in a quick keyboard-driven review.

Tags. Click any image, open the metadata sidebar, and add tags. Tags are hierarchical (you can have "Character > Anatomy > Hands" as a nested structure), support tag groups, and linked tags. Once you have tags, tag:anatomy finds every anatomy reference across all folders instantly.

Smart folders. In the sidebar, create a smart folder with a saved search query. "All character references rated 4 or higher" or "all images from ArtStation" becomes a live folder that updates automatically as you add more images.

Directory presets. Right-click any folder and set a metadata preset. Any image you drop into that folder automatically gets the preset's tags and metadata applied. Useful if you have a "Lighting reference" folder where every incoming image should be tagged "lighting" without manual work.

Color labels and ratings. Use the five-star rating system and color labels (18 colors) to mark quality and category at a glance. Both are filterable via the search bar.

Step 5: Build your first canvas in refern

If you had PureRef boards you used regularly, rebuild the ones you want in refern. The images are already in your library from the import, so this is mostly arranging.

Create a new canvas file from the left sidebar. Drag images from the library onto the canvas. You can create layers (named, nestable, with optional background fill), group images, add text annotations, freehand draw with the pen tool, and use any of nine shape primitives.

On sharpness, the thing PureRef users check first: images on a refern canvas swap to full resolution as soon as you display them larger than their thumbnail, so a reference you zoom into stays crisp rather than going soft. Scaled-down images keep their contrast instead of looking washed out. If you work with pixel art or sprites, flag those files as Pixelated and they render with hard pixel edges everywhere in the app, canvas included.

For the overlay use case, keep the canvas as your current-project board. Add images from the library as you need them. Because the library is persistent and searchable, you do not need to pre-load everything onto the canvas at the start of a project the way you would with PureRef. Search for "anatomy hands," open the results, drag the three you want onto the canvas. Done.

What does not transfer (be honest with yourself)

The board layout does not carry over. refern's PureRef importer extracts the images from a .pur file, but not their exact positions on the canvas. You start from a fresh canvas in refern and arrange things again. For boards you actively use this is real work, though it is faster than it sounds because the images are already in your library. Prioritize the boards you use day to day; older ones can stay in PureRef as read-only archives.

The PureRef color picker. PureRef's transparent-to-mouse mode includes a built-in color readout (RGB, HSV, HEX values displayed live as you move the cursor). [pureref.com/handbook/features] refern's click-through mode lets you pick colors in your painting app, but refern itself does not display a color value overlay. If the specific HEX readout while in click-through is part of your muscle memory, you will notice its absence.

Session-scoped habit. PureRef's model (open a .pur, work, close it) has zero startup overhead and zero concept of a "library." refern adds a workspace concept. For artists who genuinely want a scratch pad with no persistence, PureRef is still the right tool. There is no shame in keeping both.

Should you keep PureRef alongside refern?

Yes, if any of these apply:

• You use PureRef for quick scratch boards that you discard after a session and do not want to manage in a library.
• You rely specifically on the "pin above one application only" feature.
• You are on a team where others use PureRef and share .pur files.
• You are comfortable with both tools running side by side.

Many artists settle on this split naturally: refern for the persistent searchable library and anything that crosses project boundaries, PureRef for a single focused session where you want zero overhead and a familiar canvas feel.

Quick comparison