Download refern.

Free 30-day trial. $30 once for a lifetime license. Your library stays on your machine.

Version 1.5.0 · Windows, macOS & Linux

Need help installing?

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. Some antivirus tools flag it for the same reason. Here's why.

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.5.0-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.5.0-anylinux-x86_64.AppImage. If that works, the native .deb or .rpm avoids the issue without the extra flags.

If your antivirus flags refern

This happens sometimes, and it is a false alarm. Every release is signed, and we scan each one before it ships.

Antivirus programs trust a file more once a lot of people have run it safely. refern is signed with a real certificate, but we are a small studio and our files are still new. Not many people have run them yet, so some scanners get nervous and guess. Nearly every small app gets this on release day, and it settles down as more people download.

If a scanner does flag refern, look closely at the name it gives. You will almost always see a catch-all label like Trojan.Generic or Wacatac. That is what a scanner says when it is guessing. It is not the name of a real virus that anyone has found.

When these come up, we send our installer to the antivirus companies so they can check it themselves. McAfee has already reviewed refern and added it to their safe list.

Two things inside refern do look a little odd to a scanner. We would rather tell you what they are than pretend they are not there.

The first is a small Microsoft add-on called the Visual C++ runtime. Our Windows installer carries a copy and sets it up quietly if your PC does not already have it, because refern crashes right away without it. Scanners watch for installers that run other programs quietly, so this one trips them up.

The second is ffmpeg and ffprobe. These are well known open source tools, and refern uses them to make thumbnails for your videos. They are large files, so they are also the reason the download is as big as it is.

You can go look at all of this yourself. On Windows, refern installs to C:\Users\[your name]\AppData\Local\refern by default. Everything refern ships is sitting right there in that one folder, next to refern.exe: the two video tools, named refern-ffmpeg.exe and refern-ffprobe.exe, plus the Microsoft runtime installer. Nothing is hidden, renamed to look like something else, or scrambled.

Other than that, refern stays on your computer. It only goes online for four things: checking for updates, turning on your license, downloading the optional Auto Tagger, and checking today's date so the free trial cannot be tricked. Your images are never uploaded anywhere.

If your antivirus already deleted the installer, you can restore it and tell your antivirus to skip refern's folder. Reporting it as a false alarm helps too, because that fixes it for everyone else who downloads next.

Still not sure? Ask us in Discord or email jackson@refern.app. Send us your scan report and we will go through it with you.

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.

back to home page