Guide

Using FaceSwap

Everything from the first install to the finer settings. If you only read one section, read FaceSwap Camera: that’s how your video apps see the result.

Install

FaceSwap needs macOS 14 Sonoma or later on a Mac with Apple silicon. It’s signed with Developer ID and notarized by Apple, so it opens like any other downloaded app.

  1. Open the latest release on GitHub and download one of the following:
    • FaceSwap-1.0.dmg: open it and drag FaceSwap to Applications.
    • FaceSwap-1.0.zip: unzip it and move FaceSwap to Applications.
    • FaceSwap-1.0.pkg: an installer that puts FaceSwap in Applications for you.
  2. Make sure the app is in /Applications. macOS only installs camera extensions from there.
  3. Open FaceSwap and allow camera access when macOS asks.
  4. Click Install FaceSwap Camera to add the virtual camera. See FaceSwap Camera.

Blur, Pixelate and Blackout work immediately. Swap and the face touch-ups need the models, which aren’t publicly available.

Updates. FaceSwap tells you when a newer release is out: an Update button appears over the picture. To check yourself, choose FaceSwap › Check for Updates…. It opens the release page and never downloads or installs anything on its own. After an update, a short note lists what changed.

Models

Swapping and touch-ups run on Core ML models that aren’t inside the app. Their upstream licences allow only non-commercial research and personal use (see Privacy and licences), so they aren’t part of the public download and can’t be shared openly. Without them, Blur, Pixelate, Blackout, lighting, backgrounds and every call tool still work, and Swap falls back to Blur.

If you’ve been given access to the model files, the app adds them like this:

FeatureEnablesDownload
Face swapThe Swap style, the gallery, Mix and looksabout 380 MB
Face and hair touch-upsHair and lip colour, teeth, eyes, skin (Swap and Touch Up)about 45 MB
Enhanced face detailFace detail: Enhancedabout 40 MB
Best face detailFace detail: Best and Best every frameabout 175 MB
  1. On first launch, the Set up FaceSwap window lists the features with their sizes and terms. You can open it again later from Settings › Models or ••• › Install Models….
  2. Click Download beside each feature you want. Your browser fetches that feature’s files. This needs a GitHub account that has been given access; otherwise the page shows “Page not found”.
  3. FaceSwap notices the files when they reach your Downloads folder. It checks each one against its expected size and hash, compiles it for your Mac, and turns the feature on without a restart.

If the files are somewhere else, for example on a drive or fetched by hand from the release page, click Files Are Somewhere Else… and choose their folder. Picking Swap, or opening a panel whose models are missing, offers the same list. A model shared by two features is downloaded only once.

FaceSwap Camera

FaceSwap Camera is a virtual camera that shows other apps exactly what the FaceSwap window shows: faces hidden or swapped, background, cards and reactions.

  1. In FaceSwap, click Install FaceSwap Camera.
  2. macOS asks for approval. Open System Settings › General › Login Items & Extensions, then under Extensions › By Category › Camera Extensions turn on FaceSwap.
  3. In Zoom, Meet, FaceTime, Teams, Slack or your browser, choose FaceSwap Camera as the camera.
  4. Keep FaceSwap running. When it isn’t, FaceSwap Camera shows a placeholder card instead of your picture.

The green camera button at the top right of the window shows the camera’s status. Click it for setup help, the output resolution and mirroring. When something needs doing, such as Approve in System Settings or Restart your Mac to finish, the button turns into words that say so.

Mirroring. Your preview is mirrored, like a mirror. FaceSwap Camera sends the true picture, so text behind you reads correctly to everyone else. You can change this under the camera button or in Settings › Camera.

The window

The picture fills the window and the controls float over it. They fade when the pointer leaves the window and come back when you move or click. To keep them on screen, turn off Settings › General › Hide the controls when the pointer is away.

The FaceSwap window in Swap mode, with the status bar, the face shelf and the dock
The status bar is at the top left, the camera and Adjust buttons at the top right, the face shelf above the dock, and the dock along the bottom.

Styles

Blur style
Pixelate style
Blackout style
Touch Up style

Blur, Pixelate and Blackout

These cover every face in the picture. Strength sets how heavy the effect is, and Coverage sets how far it reaches past the face. They use Apple’s built-in face detection and need no downloads. When a face is lost for a moment, it stays covered at its last position for 1.5 seconds.

Swap

Swap replaces your face with the one you choose while keeping your expression, head angle and lighting. It works at any head angle. If a frame can’t be swapped, that face is blurred rather than shown. Until the models are loaded or a face is chosen, Swap falls back to Blur.

Touch Up

Touch Up shows your own face, improved by the settings on the Adjust card’s Look page. Its dock button turns orange because it hides nothing. The strip offers quick Light and Smooth sliders.

Faces and the gallery

In Swap, the shelf above the dock holds every face you can wear. The face you’re wearing is larger, and its name is shown above the row.

The Choose a face gallery with a grid of named portraits
The gallery. Under it, Portraits from… points to a folder of your own.

Your own portraits folder

In the gallery, click Change… to choose a folder of portraits. Use one front-facing, well-lit person per file. FaceSwap reads them and tells you how many faces it found, and which files it skipped and why: no face, several faces, a face that’s too small, or a turned head. Click Refresh (⌘R) after you add or remove files. The file name becomes the face’s name, so old-sailor.jpg becomes “Old Sailor”.

Use faces you have the right to use. The bundled gallery contains only generated portraits. When you add your own, don’t impersonate a real person without their consent.

Mix

The Mix panel with a Strength slider and a row of faces to blend in

Click Mix on the shelf. Mix only changes the identity given to the swap model, so it doesn’t slow anything down.

The Adjust card

Click the Adjust button at the top right or press ⌘I. The card opens over the picture, so you can see each change as you make it.

Adjust card, Face page
Face
Adjust card, Look page
Look
Adjust card, Background page
Background
Adjust card, Speed page
Speed

Face

Your photo, your portraits folder, Mix, and the swap’s finish. The finish settings are folded shut by default:

Look

Light my face, smooth skin, hair colour, lip colour, whiten teeth and brighten eyes. Lighting works in every style. Hair, lips, teeth and eyes need the Face and hair touch-ups models. Turn All Off resets the page.

Background

Keep the room, or replace it with your picture, grey, white, black or a green screen, and blur it as much as you like. Hide other people shows or swaps only you, and blurs anyone else who comes into the picture. This page also has scenes and picture styles (Noir, Vintage, Cool, Vivid, Faded).

Speed

Face detail trades frame rate for sharpness:

SettingWhat it doesRoughly, on an M4 Pro
OffThe swap as the model makes itabout 18–20 fps
EnhancedRedraws the face at 256 × 256about 14.5 fps
BestRedraws at 512 × 512 every other frame, blended so motion stays cleanabout 14 fps
Best every frameThe sharpest result, using the Neural Engine alongside the GPUslower on older Macs

Under Advanced, you can choose where the swap model runs and how many faces it swaps.

Looks and scenes

A look saves the face you’re wearing, including a mix or a random face, along with its strength and your look and background settings. Click Save Look on the shelf, or use Looks › Save Current Look….

Tools for calls

These are in the ••• menu, and most have a shortcut that works from any app. Everything they add appears in FaceSwap Camera, so everyone on the call sees it.

Quick cards ⌃⌥⌘K

Put a message in your picture. Back in covers the picture and counts down. Lost my audio, Listening, can’t talk, Bad connection and your own words appear as a strip along the bottom.

Follow Me ⌃⌥⌘F

The picture crops and pans gently to keep you in the middle as you lean, stand up or move around.

Presenter Mode ⌃⌥⌘P

Choose Show a Window in My Picture… and pick a window: slides, a document or a browser tab. It becomes your picture, with you in a corner tile or cut out in front of it. This works in any meeting app, even ones without screen sharing.

React to hand signs

Away card

With Away Card When I Step Out on, the picture becomes a blurred card saying you’ll be back whenever you leave the frame. It disappears as soon as you return.

Mark swapped video “Altered”

Adds a small Altered label in a corner whenever a swap is going out, for when you want to use a swap openly.

Borrow a Face From a Call

Wear the face of someone on your call. Swap must be installed.

  1. In FaceSwap, open the ••• menu and choose Borrow a Face From a Call….
  2. macOS’s window picker opens. Click the meeting window (Zoom, Meet, Teams, FaceTime or a browser tab).
  3. FaceSwap takes one picture of that window and shows every face it finds. Click the one to wear. If none are found, switch the call to speaker view so the person is large and facing the camera, then choose Pick Another Window….

The borrowed face is a loan. It lasts until you pick another face or quit, it can’t be saved to your gallery or kept as a look, and the picture is marked Altered the whole time, whatever the Altered setting says. The picture of the window is dropped as soon as the faces are read. Only do this with the person’s permission.

Photos and clips

The shutter saves a still photo, and File › Save Photo As… does the same. The red record button (⇧⌘R) records what the window shows, with faces already hidden or swapped, to an MP4 with sound from your microphone. Clips stop by themselves after 30 seconds.

When a clip ends, a window plays it on a loop with Share…, Save As… and Delete. Until you share or save it, it’s only a temporary file.

Blur faces in a photo

Choose ••• › Choose File… or Photos Library…, or drop a photo anywhere on the window. Every style works on the still photo, and the shutter saves the result. Click Back to camera to go back to the live picture.

With FaceSwap › Keep Running in Menu Bar on (the default), closing the window leaves FaceSwap running as a menu bar icon with no Dock icon, still feeding FaceSwap Camera. From the menu you can switch styles and looks, black out, pause the camera (which turns its light off), reopen the window or quit.

Keyboard shortcuts

ShortcutActionWorks
⌃⌥⌘BBlack out every face now; press again to go backFrom any app
⌃⌥⌘1–9Wear the faces in the rowFrom any app
⌃⌥⌘0Presentable MeFrom any app
⌃⌥⌘KQuick cardFrom any app
⌃⌥⌘FFollow MeFrom any app
⌃⌥⌘PShow a window in my picture / stop presentingFrom any app
1–9Wear the faces in the row (Swap)In FaceSwap
⌘IShow or hide the Adjust cardIn FaceSwap
⇧⌘RRecord a clipIn FaceSwap
⌘RRe-read your portraits folderIn the gallery
⌘,Settings (Camera, Models, Clips, General)In FaceSwap

iPhone and iPad

FaceSwap also runs on iPhone and iPad (iOS and iPadOS 17 or later) with the same styles, gallery, looks and clips. iOS doesn’t allow virtual cameras, so FaceSwap Camera is Mac-only. To add models on iPhone, use the download button in the top bar. There is no public iPhone or iPad download yet.

Troubleshooting

FaceSwap Camera doesn’t appear in my meeting app

Check that FaceSwap is in /Applications and that the extension is approved in System Settings › General › Login Items & Extensions. Then quit and reopen the meeting app; most apps only look for cameras when they start. If the camera button says Restart your Mac to finish, the camera extension was updated and macOS needs a restart to load the new version.

The meeting shows a placeholder card instead of me

FaceSwap isn’t running, or the camera is paused from the menu bar. Open FaceSwap, or choose Resume Camera.

Swap shows a blur instead of a face

The Face swap models aren’t installed (they aren’t in the public download) or are still loading, or no face is chosen yet. Open Settings › Models. A face the detector can’t see clearly, for example one that is very small or mostly hidden, is blurred instead.

The frame rate drops in a dim room

Many webcams halve their frame rate in low light to get longer exposures, whatever style you use. More light brings back 30 fps. Face detail settings above Off also cost frames; see Speed.

The swapped face looks soft

The swap model works at 128 × 128 pixels. Turn on Face detail: Enhanced or Best, and raise Sharpness on the Face page.

My uploaded photo was rejected

Use a clear, front-facing photo with one person, where the face fills a good part of the frame. FaceSwap says why it skipped a photo: no face, several faces, a face that’s too small, or a turned head.

Privacy and licences

FaceSwap processes every frame on your Mac. There’s no account, no analytics and no cloud processing. The only network requests are the optional update check, which reads a small version file, and the model downloads you start yourself.

The face models keep their upstream terms, which is why they’re downloaded separately:

Be decent with it. FaceSwap is made for privacy and fun. Don’t use a swap to deceive or impersonate a real person. The Altered label is there for when you want to be open about it.