Docs · Get started
Install & first run
Install Sift with one line in Terminal, start it, add your license and AI key, and finish setup.
What you need
- A Sift license. Get one on your account page; you’ll need it the first time Sift opens.
- A Mac with Apple silicon (M1 or later) and macOS 13 Ventura or later.
- About 250 MB for the app and 0.6 GB for the speech-to-text model, plus room for Sift’s previews and working files.
- An AI key from OpenRouter or Anthropic. See AI keys & costs.
- Premiere Pro, to open what Sift exports.
Install
You install Sift by pasting one line into Terminal.
Terminal is the Mac app for typing commands. To open it, press Command-Space, type Terminal, and press Return. (It’s also in Applications → Utilities.)
Copy this line, paste it into the Terminal window, and press Return:
curl -fsSL https://siftmy.video/install.sh | bash
The installer:
- downloads the latest Sift for your Mac (about 111 MB);
- checks that the download arrived complete and unchanged, and stops if it didn’t;
- puts Sift in a folder in your home folder,
~/.local/bin, so you can start it by typingsift.
It doesn’t ask for your Mac’s password, and it changes nothing outside your home folder.
If it asks to add Sift to your PATH
Your PATH is the list of folders Terminal looks in when you type a command. The first time, the installer may say that ~/.local/bin isn’t on it and ask:
Add it to /Users/you/.zshrc? [y/N]
Type y and press Return. Then close the Terminal window and open a new one, so it picks up the change.
If you’d rather do it yourself, the installer prints the exact line to add instead. You can also always start Sift by its full location: ~/.local/bin/sift.
Start Sift
In Terminal, type sift and press Return. Sift opens in your web browser. There’s nothing to approve in System Settings.
The Terminal window shows that Sift is running. Leave it open while you work; closing it, or pressing Control-C in it, quits Sift. If Sift is already running, typing sift again brings up the running copy in your browser instead of starting a second one.
The first start takes a little longer while Sift unpacks the tools it uses to read and transcribe your footage.
Your license
The first time Sift opens, it asks for your license. There are two ways in:
- Sign in. Press Sign in. siftmy.video opens in your browser and shows a short code; check it matches the code in Sift, sign in with your passkey, and approve. Your license comes back to Sift on its own, and Sift greets you by name.
- Paste a license key. If you were sent a license key (it starts with
sift_lic_), paste it under Paste a license key and press Use this key.
Don’t have one yet? Get a license takes you to your account page.
Sift keeps the license on your Mac and checks it there, so it works offline. To see it, or to replace it with a new one, open Settings → License. If a license runs out, Sift says so and asks for a new one; your events, profiles and exports stay as they are.
The setup checks
Next comes Set up Sift: three checks, then point Sift at a folder of cards. A table shows the tools Sift found. Under it:

- AI key. Paste your OpenRouter or Anthropic key and press Test and save. Sift makes one small request to check it, then stores it in the macOS Keychain.
- Speech model. Press Download Whisper model (about 0.6 GB). This is the model that transcribes your footage on your Mac. You can keep using Sift while it downloads.
- Output location. Choose where exports go. Use _organizer/ next to the footage puts each export in an
_organizerfolder beside the card dump. Choose folder… picks one place for every event, and each export goes in a folder with the event’s name.
When all three are done, press Start with an event. Next: make a style profile or create an event.
Check your version
Open Settings → Diagnostics. The version is next to Copy diagnostics. In Terminal, sift --version shows it too.
Updating
Quit Sift first (close its Terminal window). Then run the same line again:
curl -fsSL https://siftmy.video/install.sh | bash
It replaces Sift with the latest version. Your events, profiles and settings are kept. If Sift is still running, the installer says so and changes nothing.
To install a particular version, add it at the end:
curl -fsSL https://siftmy.video/install.sh | bash -s -- --version v0.1.0
Uninstalling
Quit Sift, then run:
curl -fsSL https://siftmy.video/install.sh | bash -s -- --uninstall
This removes Sift. Then it asks whether to delete your Sift data too: your events, style profiles, settings and the speech model, in your Library folder under Application Support → Sift. Answer N to keep them. Your footage and your exports are never touched.
Install from the .zip instead
You can also download Sift from the Download page as a .zip of about 111 MB. Double-click it to unpack it, then move the Sift folder into your Applications folder. Inside is Sift itself, the file named sift, and a short README. Double-click sift to start it: it opens a Terminal window, then Sift opens in your browser.
macOS asks you to approve a program you downloaded with a web browser once before it runs:
- Double-click sift. macOS shows a warning instead of opening it: “sift” Not Opened (or “sift” can’t be opened). Click Done (or OK). Don’t move it to the Trash.
- Approve it in one of these ways:
-
System Settings (every macOS version). Open System Settings → Privacy & Security and scroll down to Security. Next to the line saying “sift” was blocked, click Open Anyway. Enter your Mac’s password, then click Open.
-
Right-click → Open (macOS 13 and 14). In Finder, Control-click sift and choose Open. The warning now has an Open button. macOS 15 removed this shortcut, so use System Settings there.
-
Terminal. Type the command below up to the space, drag sift into the Terminal window to fill in its location, and press Return:
xattr -d com.apple.quarantine /path/to/sift
-
After that, Sift opens without a warning. Each new version you download this way needs the same approval once. To update, quit Sift, download the new release and replace the old Sift folder with the new one; your events, profiles and settings are kept.