Download refern.
Free 30-day trial. $30 once for a lifetime license. Windows, macOS and Linux.
Version 1.4.1
Installing refern
Windows
Run the .exe installer. If Windows shows a SmartScreen warning (the app is new and not yet widely downloaded), click More info → Run anyway.
macOS (12 or later)
Open the .dmg and drag refern into Applications. The first time you open it, right-click (or Control-click) the app and choose Open. macOS will ask whether you're sure you want to open an app downloaded from the internet — click Open to confirm. If macOS says the app is "damaged", run xattr -cr /Applications/refern.app in Terminal, then reopen.
Linux
For the AppImage, mark it executable: right-click → Properties → allow executing, or run chmod +x refern-1.4.1-anylinux-x86_64.AppImage then launch it. The native packages install with your package manager: sudo apt install ./refern.deb (Debian, Ubuntu) or sudo dnf install ./refern.rpm (Fedora, RHEL, openSUSE). On a recent distribution where the AppImage shows a blank or white window, install the .deb or .rpm instead.
If the AppImage flashes a white window and immediately closes (common on Wayland with an Nvidia GPU, sometimes with a Failed to register AppImage in system via libappimage error), force X11 and disable WebKit compositing when launching: WEBKIT_DISABLE_COMPOSITING_MODE=1 GDK_BACKEND=x11 ./refern-1.4.1-anylinux-x86_64.AppImage. If that works, the native .deb or .rpm avoids the issue without the extra flags.
What's new
All updates →- v1.4.1Latest
Video Playback, Thumbnails & Network Drives
- Added a 'Viewer Backdrop' setting so the area around an image or video can be a solid background, translucent, or black. It now defaults to a solid background: the old frosted glass tinted whatever you were looking at with the page behind it
- Hold Alt (Option on macOS) and scroll over a video to scrub the timeline, one second per notch. Scrolling on its own still zooms. Both are listed in the ? shortcuts sheet
- Copying a file now behaves the way your file manager does: paste it into another app as the file itself, or into an image editor as the picture. Videos can be copied too
- refern now recognizes 11 more video file types, so clips it used to skip are indexed with everything else
- v1.4.0
Native Video, Hidden Folders & a Unified Viewer
- Added native video support: import and organize videos alongside your images, with a player built for reference work. Step frame by frame, scrub a storyboard preview straight from the timeline, read the waveform and filmstrip, set speed and volume, loop, resume where you left off, and pop the video out into picture-in-picture. Videos your system can't play are converted to a playable copy automatically
- Mark an A and a B point on a video to define a section, then loop it, export it as an .mp4 clip, cut it losslessly with no re-encode, save it as an animated .webp loop (up to 30 seconds), or trim the original (undoable)
- Add labelled markers anywhere on a video, save any marker's frame as an image, and export your markers and section to .otio and .edl timeline files for your editing app
- Copy or save the current frame, pull a color palette from it (and search your library by those colors), set a custom thumbnail or display image, and build a canvas board from a video or from its markers
- v1.3.1
Multi-Root Workspaces & a Smarter Auto Tagger
- A workspace can now hold several separate content folders at once instead of exactly one. Add, rename, re-point, or remove each root from workspace settings, and browse, search, and import across all of them together. Useful when your references live in more than one place on disk
- Upgraded the Auto Tagger's models: general tags, art tags, and 'Search by meaning' all got a big quality boost, text recognition now reads longer lines more accurately, and noisy filler tags (like '1girl' or 'no-humans') are filtered out automatically. Run a fresh pass from the Pipeline tab to re-tag and re-index with the new models
- Added a Configure tab to the Auto Tagger: browse every tag the models can produce, then block the ones you don't want or rename them to fit your library, so you can shape suggestions instead of accepting raw output
- You can now re-tag items that were already tagged (a Pipeline option), and wipe all suggested tags from a single item or a whole selection in the metadata sidebar, so refreshing or clearing tagging data no longer means starting over
Support
Community Discord: the fastest way to get help, share feedback, and report bugs. Join the Discord.
Email: reach the founder directly at jackson@refern.app.
License & purchases: manage activations and find your key in the customer portal.