bobuk.io
← All apps

Ting / Data & privacy

Your shortcuts. On your Mac.

How the GitHub-distributed version of Ting handles settings, links, micro-apps, and updates.

Local settings

No accounts, analytics, or project servers. Settings and bindings stay in the local JSON file at ~/.config/ting/config.json. Launch at login uses the macOS login item service. launcha keeps successful Ting launch times and the folder-access choice separately in ~/Library/Application Support/Ting/launcha-history.json and launcha-consent.json. It does not track launches outside Ting.

Micro-apps are your files in ~/.config/ting/micro/; micro-errors.log next to the config file lists their mistakes. Ting stores the SHA-256 of each approved file in ~/Library/Application Support/Ting/micro-approvals.json and the last parameter values of each micro-app as plain text in micro-values.json there, unless the file says remember: false. Do not type secrets into a remembered micro-app.

Micro-app commands

Ting runs shell commands only from micro-app files you approved in the approval panel, and asks again after any change of the file. The command runs with /bin/sh -c as your user, with your full rights and the PATH of your login shell. Ting puts no limit on what it does: there is no sandbox, it can read and change your files, use the network and start other programs; only the run time is limited (60 seconds by default, at most 300). Parameters reach it only as TING_* environment variables and the clipboard only as stdin. The same applies to python steps; url and ai steps send what the file says to the server it names, with keys from your environment or keychain. A micro-app is approved together with the libraries it uses. Approve only commands you understand.

Anyone who can write the micro-apps folder can offer a command; the approval stands between that file and a run. Keep the micro-apps folder, config.json and ~/Library/Application Support/Ting/ writable only by your user account. App and URL bindings run no commands and pass no arguments to apps.

Permissions

Ting uses the standard macOS hotkey API for its leader. It does not request Accessibility or Input Monitoring permission. launcha scans app folders at startup and on opening; background scans while open run at most once per minute. Spotlight searches indexed home files only for a non-empty query with no app matches. Hidden paths, ~/Library and app bundles are excluded. Desktop, Documents and Downloads require your explicit consent, then may prompt for macOS folder access.

Network use

Apart from what your approved micro-apps do (their commands and their url and ai steps), Ting’s only network access is Sparkle: it checks the public GitHub release feed and downloads updates from GitHub. GitHub may process ordinary request data, including your IP address, under its privacy policy.

Ting opens the URLs you configure using the system default app. The destination service’s privacy policy applies. Copy Agent Prompt, Ting --check and ting-micro check send nothing. Downloads and support are hosted on GitHub; this website uses GitHub Pages.

Deleting data

Turn off launch at login, quit Ting, and delete /Applications/Ting.app. To remove settings, bindings and micro-apps too, delete ~/.config/ting/. Delete ~/Library/Application Support/Ting/ to remove launcha history, the folder-access choice, micro-app approvals and remembered values.

Privacy and security questions

Use Support for questions. Public issues must not contain private URLs or tokens. For sensitive security reports, use https://github.com/bobuk-io/ting/security/advisories/new as described in SECURITY.md.

GitHub privacy statement ↗

Based on the public project documentation. Before a store release, verify this page against that build’s behavior and App Privacy declarations. Full documentation on GitHub ↗