ControlPlane

controlplane

A macOS menu-bar app that automatically switches your Mac's configuration based on where you are and what's happening around you.

Detected by ControlPlane | macOS |www.controlplaneapp.com

Sync rules

What travels, what stays, what never leaves

ControlPlane in your home directory Every rule on this page, by file

· ~/Library/Application Support/ControlPlane/ Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/controlplane.tomlThe file this page is generated from

id = "controlplane"

name = "ControlPlane"

homepage = "http://www.controlplaneapp.com"

description = "A macOS menu-bar app that automatically switches your Mac's configuration based on where you are and what's happening around you."

# The source art for the app's own icon, from its repository —

# controlplaneapp.com publishes no icon.

icon = "https://raw.githubusercontent.com/dustinrue/ControlPlane/main/Resources/cp-icon-source.png"

# ControlPlane ships no command-line tool, so `detect` carries the name of the

# executable inside the app bundle rather than a binary on $PATH.

detect = ["ControlPlane"]

platforms = ["macos"]

# Sources/ControlPlaneApp/AppDatabase.swift says it on the type itself: "The

# database file lives in ~/Library/Application Support/ControlPlane/ (or inside

# the sandbox container when the app is sandboxed — FileManager resolves the

# correct path automatically in both cases)", and its appSupportDirectory()

# builds that path from FileManager's .applicationSupportDirectory plus

# "ControlPlane". Sources/ControlPlaneApp/SensorConfigStore.swift writes into

# the same directory — "Persists sensor option values to a JSON file in

# Application Support", sensor-config.json. On macOS, the only platform this

# app runs on, that directory is [appData].

# The profiles, rules and actions are rows in the SQLite database next to the

# JSON, so the directory is listed whole rather than file by file.

paths = ["[appData]/ControlPlane/"]

# Caches and logs are not written here; there is nothing to carve out.

exclude = []

# Nothing in this directory is a whole-file credential: the JSON holds sensor

# option values (an SSID, a USB vendor id) and the database holds profiles and

# rules. An action that needs a secret runs a Shortcut or a shell script, which

# keeps its own elsewhere.

secret = []

# No machine_lines: a rule matches on an SSID, a Bluetooth device name or a USB

# id, which is exactly what a user wants to carry to the next Mac, and the rules

# live in a SQLite database that prefix and key_path matching cannot read.

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/controlplane. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.