# interspace **Repository Path**: liyu2015/interspace ## Basic Information - **Project Name**: interspace - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Interspace A fast, customizable space switcher for macOS. Switching desktops on macOS is slow. Unbearably slow. The slide animation scales with your display's refresh rate, so on a 120Hz ProMotion display it takes twice as long as at 60Hz: a full second from the swipe until the desktop you landed on is responsive. The slide looks finished well before that, but your clicks and keys go nowhere until it has settled. macOS has exactly one animation for this, and no options to change it. Interspace is a small app that replaces that transition with one you choose, or with none at all. It follows your fingers, so one swipe can pass several desktops, and a key press in the middle of a transition starts the next one at once instead of being ignored. ## Install You need macOS 14 or newer. The app runs on Apple silicon and Intel. 1. Download [Interspace.dmg](https://github.com/cnrad/interspace/releases/latest/download/Interspace.dmg). 2. Open it and drag Interspace to Applications. - macOS blocks opening the app, because it is downloaded from the web and not notarized by Apple. Click **Open Anyway** in System Settings > Privacy & Security. The Open Anyway button next to the message about Interspace.dmg in Privacy & Security 3. Open Interspace from Applications. macOS stops it, because the app is not notarized by Apple. Click **Done**. 4. Open System Settings > Privacy & Security, scroll down to Security, and click **Open Anyway** next to the message about Interspace. Confirm with your password or Touch ID. Steps 3 and 4 are necessary one time only. ### Update Choose **Check for Updates…** in the menu bar menu. If there is a newer release, Interspace downloads it, installs it in the place of the old one, and opens again. Your permissions and settings stay. Interspace installs a download only if it has the same signature as the releases of this project and a newer version. If not, it changes nothing. ### Permissions Only you can do this part. Allow Interspace in System Settings > Privacy & Security, in two places: | Permission | Why | |---|---| | Accessibility | To take the swipe before macOS does, and to tell the Dock to switch spaces | | Screen & System Audio Recording | To take the pictures of your desktops that the transition shows | Then choose **Relaunch Interspace** in its menu bar menu. Until both are allowed, Interspace does nothing and the normal macOS swipe works as before. Interspace sends nothing about you off your Mac. The only time it uses the network is when you choose **Check for Updates…**: it asks GitHub for the newest release, and downloads it if you agree. ### Uninstall ```sh curl -fsSL https://raw.githubusercontent.com/cnrad/interspace/main/scripts/uninstall.sh | bash ``` This removes the app, its login item, its two permissions and its settings. ### Build it from source If you do not want to run a downloaded app, build it on your Mac. An app that is built on the Mac it runs on is not stopped by Gatekeeper, so steps 3 and 4 above are not necessary. You need the Xcode Command Line Tools (the installer asks for them if they are missing). ```sh curl -fsSL https://raw.githubusercontent.com/cnrad/interspace/main/scripts/install.sh | bash ``` Or ask your coding agent: > Install Interspace from https://github.com/cnrad/interspace. Clone it, read `scripts/install.sh` before you run it, then run it. When it finishes, tell me which two permissions to turn on in System Settings and where. The script gets the source into `~/.interspace`, builds it, makes a signing identity for your Mac, and puts `Interspace.app` in `/Applications`. Run the same command again to update: **Check for Updates…** tells you when there is a newer version, but a copy that you built has the signature of your Mac, so it does not replace itself with a download. The two permissions are the same as above. ## Transitions | Name | What it does | |---|---| | macOS Default | The standard transition. Interspace stays out of the way. | | Instant | No animation. The next space is there at once. | | Lightweight | The screens slide and pull back slightly. | | Magnetic | The screen shrinks and moves aside. The next one moves in and grows. | | Prism | The spaces are the sides of a prism that turns. | | Stack | A pile of screens. One slides on top, or off again. | Open **Settings…** from the menu bar icon to choose one. Each has a small moving preview. The same window has: - **Speed:** how fast the transition finishes after you let go. - **Swipe sensitivity:** how far the screens move for the same finger travel. Set high, one swipe can pass several spaces. - **Dock and menu bar move with the space:** on, they are part of each screen. Off, they stay in place as in macOS. - **Rounded corners:** each screen gets the corner shape of your display. The macOS keyboard shortcuts for "move left a space" and "move right a space" use the chosen transition too. ## How it works Interspace does not change macOS. The Dock still does every space switch. 1. An event tap takes the system's swipe events before the Dock sees them, so the built-in animation never starts. 2. Raw finger positions from the trackpad drive a full-screen overlay that shows pictures of your desktops. 3. When you let go, Interspace posts a synthetic swipe that the Dock completes in about one frame, below the overlay. 4. The overlay finishes its own animation and is removed when the real desktop below is ready. Quit Interspace and the normal macOS behaviour is back at once. ## Limits - **Private macOS behaviour.** The trackpad data, the synthetic swipe, the list of spaces and one of the screen captures are not public API. A macOS update can break any of them. It is developed and tested on macOS 27 only. - **No Mac App Store, not notarized.** That is why macOS stops the downloaded app the first time, and you must allow it in Privacy & Security. - **A short screen freeze at launch.** macOS only draws the active space, so Interspace visits each space once behind a frozen picture to capture it. It takes about a second. - **A new desktop** shows your wallpaper the first time you swipe to it. Use **Capture All Spaces Again** in the menu to avoid that. - **Mission Control.** A swipe while Mission Control is open is not handled well. - **macOS asks again for Screen Recording** from time to time. That is system policy for every app that captures the screen. ## Development ```sh scripts/setup-signing.sh # one time: a local signing identity, so permissions survive rebuilds scripts/bundle.sh # builds build/Interspace.app scripts/dmg.sh # builds build/Interspace.dmg, the universal download of a release ``` A release is `build/Interspace.dmg`, attached to a GitHub release with that exact file name. Each release must be signed with the same identity, or everyone must allow the two permissions again after an update. The app also refuses an update with a different signature: the one it accepts is in `Updater.swift`, and `scripts/dmg.sh` stops if the build does not have it. So keep a copy of `~/Library/Keychains/interspace-signing.keychain-db` and `~/.config/interspace/signing-keychain-password`. The tag of a release is the version in `Info.plist` with a `v` in front, for example `v0.2.0`. The app compares the two to know if a release is newer. Every tuning value is in `Sources/Interspace/Config.swift`. The math of each transition is in `TransitionMath.swift`, and both the real transition and its preview in the settings window use it. ## Credits The synthetic swipe and its macOS 27 event format come from [InstantSpaceSwitcher](https://github.com/jurplel/InstantSpaceSwitcher) by jurplel (MIT). ## License MIT. See [LICENSE](LICENSE).