xposed Docs

INSTALL · MACOS

Install on macOS.

xposed runs on Intel and Apple Silicon Macs. It installs for your user account only, so it needs no password and no administrator access. You need curl, which every Mac has.

The one-line installer#

Open Terminal and run:

curl -fsSL https://getxposed.link/install.sh | sh

It downloads the latest release for your Mac, checks it against the release's SHA256SUMS, puts xposed and xposedd in ~/.local/bin, then adds the Finder action and the start-at-login item. It ends with something like this (your version number will differ):

Downloading xposed 0.6.0 (xposed_0.6.0_darwin_arm64.tar.gz)
Installed the Finder action: right-click a file, Quick Actions > Share with xposed.
The daemon now starts at login.

Installed xposed 0.6.0.
Next, sign in:  ~/.local/bin/xposed login

If ~/.local/bin isn't on your PATH yet, the installer prints the line to add to ~/.zshrc, and then a new Terminal window finds xposed. Run the installer again any time to update, or use xposed update. To install a specific release, set XPOSED_VERSION:

curl -fsSL https://getxposed.link/install.sh | XPOSED_VERSION=0.6.0 sh

Why the script, and not a download in your browser#

xposed isn't signed with an Apple developer certificate yet. A file you download in a browser carries a quarantine flag, and macOS refuses to open an unsigned program with that flag ("Apple could not verify..."). The installer downloads with curl, which sets no flag, so nothing is blocked. If you downloaded the tarball in a browser anyway, clear the flag before you run it:

xattr -dr com.apple.quarantine ~/Downloads/xposed_*_darwin_*.tar.gz

Sign in#

Run this once on this Mac:

xposed login

It shows a short code and opens your browser, where you sign in with GitHub or Google. Then share a file.

Sharing from Finder#

Select a file, folder or several, then right-click and choose Quick Actions, then Share with xposed. The same action is under Finder in the menu bar, in Services. The command line works everywhere: xposed share ~/Desktop/photo.jpg.

If something goes wrong, for example you haven't signed in yet, a notification says what happened. If the action isn't listed, run the installer again; it is safe to repeat.

Starting at login#

The installer adds a login item, link.getxposed.daemon, that runs xposed daemon start when you log in, so your open links come back after a restart. The first time, macOS shows a Background Items Added notice: that is this item. You can turn it off under System Settings, General, Login Items & Extensions.

The dashboard and control panels are at http://xposed.localhost:9767 on a Mac: macOS doesn't let a normal user program listen on port 80. Only you can open them.

Updating#

Run xposed update, or the installer again. xposed update --check only reports whether a newer release exists. An update keeps your account and shares, and refreshes the Finder action.

Uninstalling#

Remove the program, the Finder action and the login item:

$ xposed daemon stop
$ launchctl bootout gui/$(id -u)/link.getxposed.daemon
$ rm ~/.local/bin/xposed ~/.local/bin/xposedd ~/Library/LaunchAgents/link.getxposed.daemon.plist
$ rm -rf ~/Library/Services/"Share with xposed.workflow"

That keeps your sign-in and share history. To remove those too:

rm -rf ~/Library/"Application Support"/xposed ~/Library/Caches/xposed

You can also remove this computer from your account's dashboard.

Where xposed keeps things#

  • ~/Library/Application Support/xposed/install.json holds this computer's sign-in.
  • ~/Library/Application Support/xposed/data/ holds your shares and download history, and daemon.log.
  • ~/Library/Caches/xposed/ is a cache. Deleting it is always safe.

See the troubleshooting page if something doesn't work, or write to us on the support page.