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.

lowkey saved-site metadata

Only while lowkey is installed, Ting reads ~/.config/lowkey/config.json for saved-site metadata. It never reads lowkey cookies or website-data stores, changes browser settings or fetches site favicons. Sites open only after you choose a result or invoke its binding. lowkey:// links go explicitly to io.bobuk.lowkey rather than an arbitrary URL handler. Successful launcha opens use stable site IDs in the normal local launch history.

Clipbawd history

Opt-in persistent history uses ~/Library/Application Support/Ting/Clipbawd/ without additional encryption, with user-only permissions and exclusion from backups. Disabling persistence deletes the archive but keeps the current session; Clear History or Use Clipbawd off deletes both. Deletion cannot erase filesystem snapshots or existing backups. The size limit includes archive metadata; Settings shows usage and actual disk size. A private temporary file allows video pasting via file URLs; the next video replaces it and clearing/disabling history removes it. Generic files remain references, not backups. Uninstall data removal includes this directory.

Ting 0.7.16 and earlier: history stays in memory until quit or Use Clipbawd is turned off, with 200 entries by default. Copies marked secret and copies during Secure Keyboard Entry are skipped. Private-window detection is best-effort: Firefox needs Accessibility and a matching title; Chromium browsers need Automation; Safari private windows are not detected. Exclude sensitive apps yourself. Link previews are off by default; enabling them sends GET requests without cookies, credentials or scripts. Public-address checks do not prevent DNS rebinding, so leave previews off on sensitive networks. Approved micro-apps may save or transmit history they read.

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 unless you turn on Rank by apps you use, which records app switches locally in app-usage.json and deletes that file when turned off.

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 current clipboard as stdin. Since 0.7.6, explicit ${clipboard[-1]} templates can also supply history through env: or other step fields. The context a file lists (the active app, the Finder selection, the browser tab, the selected text, the front window) reaches code as TING_CONTEXT_* variables; Ting reads nothing a file does not list. keys and paste steps and the app output send key presses and text to the app that was in front. 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 and never requests Input Monitoring permission. It asks for Accessibility only when a micro-app reads the selected text or the front window, presses keys or pastes into an app, and for Automation of Finder or a browser only when a micro-app reads the Finder selection or the browser tab. To read selected text that an app does not give through Accessibility, Ting presses Command-C in that app and puts the clipboard back. 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 approved micro-apps and optional Clipbawd link previews, Ting uses the network for Sparkle updates: it checks the update feed at https://bobuk.io/apps/ting/appcast.xml (Ting 0.6.1 and older: the public GitHub release feed) and downloads updates from GitHub. The bobuk.io server sees ordinary request data of each check, including your IP address; GitHub may process the same for downloads under its privacy policy. Turn automatic checks off in Settings › General to check only when you choose.

Ting opens configured URLs with the system default app, except lowkey:// links, which go explicitly to lowkey. 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 is hosted at bobuk.io, with a copy on 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 ↗