← Back to FLOATING

Beta · macOS

Install guide — macOS

Thanks for testing FLOATING. This takes about two minutes.

This guide covers the beta only. It will be replaced by a proper installation guide when FLOATING ships publicly.

What you need

To check which Mac you have: Apple menu → About This Mac. Anything listing an Apple M1/M2/M3/M4 chip is Apple Silicon; anything listing an Intel processor cannot run FLOATING.

1. Run the installer

Double-click FLOATING-macOS-latest-beta.pkg.

macOS will refuse to open it the first time. This is expected — see the next section for the two clicks that get past it.

Once the installer opens, click through it. You’ll be asked for your Mac password, because the plug-ins install into the shared system plug-in folders that every DAW already scans.

2. Getting past the macOS warning

You’ll see something like “FLOATING…pkg cannot be opened because it is from an unidentified developer” or “Apple could not verify it is free of malware”.

Why: Apple’s Gatekeeper only recognises installers that have been signed with a paid Apple Developer ID and submitted to Apple for notarization. FLOATING doesn’t have that yet — the developer account gets set up before the public release, not during a beta. macOS isn’t reporting that anything is wrong with the file; it’s reporting that it doesn’t recognise who published it. Every unsigned beta from every small developer behaves this way.

Two ways through it — try the first, fall back to the second:

Option A — Control-click → Open

  1. Control-click (or right-click) the .pkg file in Finder

  2. Choose Open

  3. In the dialog that appears, click Open again

Option B — Privacy & Security (needed on macOS 15 Sequoia and later)

  1. Double-click the .pkg normally and let macOS block it. Click Done.

  2. Open System Settings → Privacy & Security

  3. Scroll down to the Security section. There’ll be a line saying FLOATING was blocked, with an Open Anyway button. Click it.

  4. Authenticate with Touch ID or your password, then click Open in the confirmation dialog.

The warning appears once, for the installer file itself. The installed plug-ins are not affected by it and load normally afterwards.

3. Where it goes

The installer puts exactly two things on your Mac:

FormatLocation
Audio Unit/Library/Audio/Plug-Ins/Components/FLOATING.component
VST3/Library/Audio/Plug-Ins/VST3/FLOATING.vst3

Nothing else is installed — no background processes, no login items, no licensing service.

4. Confirm it worked

In Ableton Live

  1. Restart Live if it was already open — it only scans for new plug-ins at launch.

  2. In the browser, go to Plug-Ins. FLOATING appears under Floaudio in both the Audio Units and VST3 lists.

  3. If it isn’t there, open Settings → Plug-Ins and click Rescan Plug-Ins. Make sure Use Audio Units and Use VST3 Plug-In System Folders are both switched on.

In Logic Pro

FLOATING appears as an audio effect under Floaudio. Logic validates new Audio Units at launch, so give it a few seconds on first start.

From the Terminal (optional, if a DAW isn’t finding it)

ls -d /Library/Audio/Plug-Ins/Components/FLOATING.component /Library/Audio/Plug-Ins/VST3/FLOATING.vst3

Both paths should print. To check that macOS itself considers the Audio Unit valid:

auval -v aufx Flt1 Floa

The last line should read AU VALIDATION SUCCEEDED.

5. If FLOATING doesn’t show up

6. Uninstalling

There’s no uninstaller — deleting the two files is the whole job:

  1. In Finder, press Cmd-Shift-G and go to /Library/Audio/Plug-Ins/Components

  2. Drag FLOATING.component to the Trash

  3. Go to /Library/Audio/Plug-Ins/VST3 and drag FLOATING.vst3 to the Trash

  4. Restart your DAW

You’ll be asked for your password, since these are shared system folders.

Terminal equivalent:

sudo rm -rf "/Library/Audio/Plug-Ins/Components/FLOATING.component" "/Library/Audio/Plug-Ins/VST3/FLOATING.vst3"

Removing FLOATING will leave existing projects that used it with a missing plug-in, but won’t damage them — the settings come back if you reinstall.

7. Installing a newer beta

Just run the newer .pkg. It replaces both plug-ins in place. You don’t need to uninstall first, and your saved projects and presets are unaffected.

New in this build

Earlier work still applies: prints that start where the loop starts, the first-run tour (replayable from the corner menu), keyboard access across both AU and VST3, and the Command-click recovery gesture.

Verify what you downloaded (optional)

Every release carries a SHA256SUMS.txt. Download it into the same folder as the installer — SHA256SUMS.txt — then:

cd ~/Downloads && shasum -a 256 --ignore-missing -c SHA256SUMS.txt

It should print FLOATING-macOS-latest-beta.pkg: OK.

--ignore-missing is not optional. The sums file covers every payload on the release — both platforms, the manual, and each one under two names — so without that flag it reports FAILED open or read for the files you did not download and exits non-zero, which reads as verification failing when nothing is wrong.

Known issues on this beta

Intel Macs are not supported

FLOATING is Apple Silicon only and Intel support is not planned. The installer declines to run on an Intel Mac rather than install a plug-in that would not load.

The installer is unsigned

macOS blocks it once, on first open. That is expected and section 2 above covers the two clicks that get past it — it is not a sign that anything is wrong with the file.

Reporting problems

When something goes wrong, the most useful things to send are:

Thanks — the point of this round is to find exactly this kind of thing.

Reach me on Instagram or Telegram at @floamusic / @floamusic. Full details on the contact section.

Download for macOS