Installation and activation
How to download and install the app, activate your license, and set up your first models.
Downloading & installing
Download the app from the install page (you'll need to be signed in). Requirements: an Apple Silicon Mac on macOS 13 (Ventura) or later.
Choosing a bundle
Standard includes an LGPL build of FFmpeg with open codecs (OpenH264, VP9, and the common formats). For proprietary codecs the app uses macOS VideoToolbox instead, so hardware H.264 and HEVC encoding work out of the box.
No media library is a smaller download that installs FFmpeg and mpv through Homebrew on first launch. This adds software encoders the LGPL build cannot ship, such as ProRes, x264, and x265. First launch needs an admin password, an internet connection, and about 500 MB. Pick Standard unless you specifically need those encoders.
Install steps
- 1Open the downloaded
.dmgand drag Refocused into Applications, then eject the disk image. - 2Launch Refocused from Applications.
- 3On first launch the app checks its dependencies. If anything required is missing you'll see the System Dependencies panel. Click Install Dependencies, let it finish, then Check Install Status and Continue.
First launch
A fresh install opens onto the Dashboard with a setup card whose only ask is Activate. Installs that came with the Essentials bundle finish there; other installs add a second step, Models.
Step 1: Activate your license
- 1Click Activate. It opens refocused.ai/activatein your browser. Sign in if you haven't (Google, or a code emailed to you), and the page creates a software key for this install and shows it once. Click Copy.
- 2Back in the app, paste the key into Software key and click Activate. The app generates a license for this device and verifies it with the engine. This works the same for a free trial and for a purchased license; the account decides which you get.
- 3Already have a key (it starts with
rfcs_)? Use I have a software key under the Activate button and paste it. Keys live on your API Keys & Licenses page. - 4If you have an access code, redeem
RF-XXXX-XXXX-XXXXon your account page first, or later in the app under Settings → License Management → Redeem a Code. - 5Installing on a machine without internet access? Choose Air-gapped machine. The card shows this computer's Device ID with a Copy button and the three steps: create the license file for that ID from your API Keys & Licenses page on a connected device, bring the
.rflicfile over, and drop it on the card.
Step 2: Set up models
If you installed a Standard + Essentials package, the default models are already in place and this step does not appear. Otherwise the setup card offers four presets that follow the workflows: All, Enhance, Enhance without Diffusion (no Regenerate-Q, a smaller download), and Refine (segmentation, depth and denoise). Each installs one engine per model family, downloading the weights and building the engines for your hardware in one step with a single progress bar.
To pick individual weights and engines instead, click Open Model Library (covered on the Model Library page). On machines without internet access, Use local files points the app at a folder of models downloaded from the offline model packages page.
License status
The pill in the top bar shows your license state. Click it for status, expiry, and days remaining. On a trial, the pill also has an Upgrade button. After you purchase, the app detects the upgrade within a few seconds; if it doesn't, click Refresh License. Your saved key, license generation, and code redemption live in Settings → License Management.