bobuk.io
← All apps

Ting / Help

Let’s work it out.

Leader keys, bindings, and help from the project. Keep private URLs and tokens out of public reports.

Ting 0.7.19: color themes and BobukKit 0.5.0

Open Settings › General › Appearance to choose System, Light, or Dark mode and any of 18 built-in palettes with swatch dots and a live preview. Edit Panel, Accent, and Text directly, or expand More colors to customize Surface, Muted text, Border, Selection, Link, Success, and Danger with per-role Auto contrast reset and WCAG warnings.

Palettes are saved in ~/.config/ting/config.json and apply live to selecta, launcha, Clipbawd, and Settings. The bottom-right gear in selecta and launcha now uses BobukKit’s shared footer control.

Ting 0.7.18: fuzzy search, usage ranking and launcher shortcuts

launcha matches scattered letters and allows one typo from four letters (two from eight, or one in a three-letter query when nothing else matches) while keeping exact-substring matches first and highlighting matched letters. The same matcher works in micro-app choice fields and the Settings bindings filter.

Enable Rank by apps you use in Settings › Keys & Launch to include apps switched to outside launcha (recorded locally in app-usage.json at most once per app every 30 minutes; turning the option off deletes the file) and rank running apps higher or lower. Clipbawd now previews a single copied PNG or JPEG file while still pasting it as a file, and pressing ⌘, in selecta, launcha or Clipbawd closes the launcher and opens Settings.

Ting 0.7.17: Settings and Clipbawd

Settings now has General, Keys & Launch, Bindings, Clipbawd, Micro-apps and Advanced pages, plus search for individual parameters. Retention limits and privacy details are expandable. Tools groups config, reload and Copy Agent Prompt in the menu; Ting groups About and updates.

Keep history between launches is off by default. Enable it in Settings › Clipbawd; Retention limits offers 100 entries, 50 MiB and 30 days by default, with 0 days for no age limit. Cleanup is hourly; reuse does not renew copy age. Video previews show thumbnail and duration, not playback: one local MP4/MOV/M4V up to 30 seconds and 32 MiB per copy. Longer videos are skipped; Markdown never loads embedded images.

Ting 0.7.16

The release notes and the signed download are available on GitHub Releases.

Ting 0.7.15

Record the other key in Settings › General › Second leader. Double-tap either leader to open launcha when double tap is enabled.

Ting 0.7.14

Open launcha and type Finder or Safari. Finder also matches by its English filename when macOS displays a localized name. Safari appears when it is installed.

Ting 0.7.13

Open Ting and choose Check for Updates… to install this release.

Ting 0.7.12

Open Ting and choose Check for Updates… to install this release.

Leader or sequence not working?

  1. Choose a non-modifier key, optionally with modifiers. Right Option alone cannot be a leader; Home or F13 can.
  2. Check the sequence in Settings → Bindings. Finish recording with Done. Esc closes the menu and Delete goes back one group.
  3. Check the menu delay and unknown key behaviour in General. The default delay is 0.25 s; quick sequences may finish before the menu appears.

Ting 0.7.11: selecta delay

To keep selecta hidden during fast sequences, increase Settings › General › Show menu after. An explicitly configured delay is unchanged.

Ting 0.7.10: 1Password

Keep your existing binding or select 1Password in launcha. You do not need to quit 1Password first.

Ting 0.7.9: site automation

Install lowkey 0.1.1 or later in /Applications. Existing site bindings use lowkeyctl. For a micro-app, start with action: status; action: inspect requires an open site window. The CLI requires --allow-effects to run lowkey actions.

Ting 0.7.8: lowkey and shared picker UI

Install lowkey and save sites there first. Settings › Bindings › + › lowkey offers Open and Toggle for selecta; these are ordinary lowkey://alias/open and lowkey://alias/toggle URL bindings. Launcha searches site titles, aliases and hosts. Return opens a site in its lowkey profile; Command-Return does not reveal a deep link in Finder.

Lists refresh while open and on reopening. Removing lowkey removes its sites from search, not old bindings: edit or delete those normally. Purr becomes the default only when no sound was selected. ting-micro commands now start in their own session, fixing login-shell PATH fallback. Update with Check for Updates… or Update Ting via Homebrew…; settings, bindings, micro-apps and permissions stay.

Ting 0.7.7: recording new bindings

In Settings › Bindings, choose an action with +. The recorder starts empty: type your sequence and click Done to save it. Cancel or Escape leaves no new binding. Editing an existing binding keeps its current sequence. Update through Check for Updates… or Update Ting via Homebrew…; settings, bindings and micro-apps are preserved.

Ting 0.7.6: Clipbawd

Open launcha, search for Clipbawd and press Return. Settings › Clipbawd offers an optional hotkey, exclusions and Clear History. Use Clipbawd turns recording off, clears history and frees its hotkey. No separate hotkey is assigned by default. Return pastes into the previous app and needs Accessibility; Command-Return only copies. Approved micro-apps can read ${clipboard[-1]}, ${clipboard[-2]} and earlier entries; the guide explains snapshots and env:. Update through Check for Updates… or Update Ting via Homebrew…; settings and micro-apps are preserved.

Settings and configuration

General includes Light/Dark theme (dark by default), leader, menu delay, unknown key behaviour, launch at login, menu-bar icon, and sound. Show panel title lets you hide the Ting · selecta title row while keeping the tuning-fork leader symbol and sequence visible. Advanced offers the config path, reveal, reload, import, and export, and the micro-apps folder: the found micro-apps, their errors, Open Folder in Finder and Copy Agent Prompt.

Settings and bindings live in ~/.config/ting/config.json. Ting reloads changes; if the file has an error, it keeps the last good settings and shows the error in its menu.

Ting 0.7.4: Interactive steps and sound

Micro-apps can pause for text with ask or for one ready option with choose. ask supports default, placeholder, multiline and required; choose accepts lines or JSON items with title, subtitle and value. The next step gets the answer; an id also makes it available as ${steps.ID}. Esc cancels the run, waiting pauses execution timeouts including in libraries, and answers are not remembered. Return continues; in a multiline editor use Command-Return. ting-micro check validates these files, but headless run rejects them before any step runs.

In Settings › General, choose a macOS system sound and set Volume. Since 0.7.8 the default is Purr at 0.5; an explicit sound choice is kept; soundVolume accepts 0–1 in config.json. Choosing a sound or releasing the slider previews it. The launcher now stays open while its gear menu is shown.

Ting 0.7.4: Homebrew updates

A copy that Homebrew installed no longer runs Sparkle: it does not check for updates on its own and never shows the Sparkle window. Ting’s menu, the gear of selecta and launcha, and Settings › Updates offer Update Ting via Homebrew… instead of Check for Updates…. Ting runs exactly brew upgrade --cask --greedy bobuk-io/tap/ting with the brew of the prefix that installed it, shows the command, brew’s live output and the real result, and starts again after the update. A copy you downloaded yourself still updates with Sparkle.

A Homebrew copy of 0.7.3 or older still has the old Sparkle update: quit Ting, run brew upgrade --cask --greedy bobuk-io/tap/ting in a terminal and open Ting again. Settings, bindings, micro-apps and permissions are kept.

Ting 0.7.3: Launcher menu

A small gear in the bottom-right corner of selecta and launcha opens the same menu as the menu-bar icon, including Settings and Check for Updates. It works even when the menu-bar icon is hidden.

Ting 0.7.2: Selecta keyboard fix

Selecta now lets arrow keys and Return reach menu navigation instead of consuming them as key equivalents. Command shortcuts remain blocked while the menu is open.

Ting 0.7.1: Keyboard navigation and panel outlines

Selecta now supports Up/Down to select, Return to open, Right to enter a group and Left to go back. An explicit Return binding takes priority. Up, Down and Page Up/Down work in launcha even when focus leaves the search field. Refreshing results keeps the selected row visible. Command-arrow and Command-delete shortcuts work in micro-app text fields. Amber top rules follow the rounded panel outlines. Choose Check for Updates… to install 0.7.1; settings and permissions are preserved.

Ting 0.7.0: a calculator in launcha

A query of digits and an operator, such as 2*(3+4), 1,5 × 4, 200 + 15%, 2^10 or sqrt(2), shows its value first, above any app or file; Return copies it and Ting says Copied. Both . and , are decimal points. + - * / ^, × ÷, parentheses, mod, percent (200 + 15% is 230), pi, e and the functions sqrt, abs, round, floor, ceil, ln, log, exp, sin, cos and tan (radians) work; results keep up to 12 digits after the point. A lone number, a version such as 1.2.3 or a division by zero shows no value. The calculator is on by default: turn it off with Calculate in launcha in Settings › General, or with "calculator": false under launcha in config.json.

Sparkle now checks for updates at https://bobuk.io/apps/ting/appcast.xml, so a new release shows up as soon as it is published; archives still come from GitHub Releases and are accepted only with Ting’s signature. Ting 0.6.1 and older find 0.7.0 through the GitHub feed. Choose Check for Updates… in Ting to install 0.7.0; your settings, bindings, micro-apps and permissions are kept.

Ting 0.6.1: an Accessibility window

When a micro-app needs Accessibility (the selected text, the front window, keys, paste or output to: [app]) and Ting does not have it, Ting opens a window with the steps instead of an error panel or the prompt of macOS. Open Accessibility Settings opens System Settings › Privacy & Security › Accessibility; drag the Ting icon from the window into the list of apps, or click + and choose Ting, then turn on its switch. The window stays above System Settings and closes by itself once access is on; then start the micro-app again. A result that could not be pasted stays on the clipboard.

Settings › Advanced shows whether Ting has Accessibility; Allow… opens the same window. Prominent buttons in the light theme use a lighter amber, so their text is easier to read. Choose Check for Updates… in Ting to install 0.6.1; your settings, bindings, micro-apps and permissions are kept.

Ting 0.6.0: context and typing

A micro-app lists in context: what Ting reads when it starts, and Ting reads only that: app (name, bundle id, path), finder (the selected files and the folder of the front Finder window, also when Finder is in the background), browser (URL and title of the front tab in Safari, Chrome, Arc, Brave, Edge, Vivaldi or Chromium), selection (the selected text) and window (the title and document of the front window). Steps read them as ${context.finder.selection}, code as $TING_CONTEXT_FINDER_SELECTION. New examples: About the active app, Checksum of Finder files, Copy page link, Sort selected lines and Search in a new tab.

A keys step presses keys in the app that was in front, such as keys: [cmd+a, return]; a paste step pastes text there; output to: [app] pastes the result. Ting closes its panel first and puts the clipboard back after it pastes. When that app is no longer in front or a password field holds the keyboard, Ting sends nothing. ting-micro run takes values with --context and never sends keys.

Ting asks for permissions only when a micro-app needs them: Automation for Finder or the browser (macOS asks once per app), and Accessibility for the selected text, the window, keys, paste and the app output. When an app does not give its selected text through Accessibility, Ting presses Command-C there and puts the clipboard back. Choose Check for Updates… in Ting to install 0.6.0; your settings, bindings and micro-apps are kept.

Ting 0.5.1: faster menu and switching

Ting preloads app icons and caches app paths when it loads your bindings, including nested groups. Already running apps are activated directly, before the leader menu hides. The menu view is reused instead of being rebuilt on every opening; its window fits the menu and uses the system shadow.

Small keycaps have the same minimum width, with or without a second keyboard-layout letter. Rows for Space and other keys without that letter no longer shift to the left. Choose Check for Updates… in Ting to install 0.5.1; your settings, bindings and micro-apps are kept.

Ting 0.5.0: steps and libraries

A micro-app in ~/.config/ting/micro/ can now run a list of steps instead of one command: command (shell), python, url (an HTTP request), ai (OpenAI, Anthropic or any OpenAI-compatible server), text, json, open and notify. The output of each step is the input of the next one. Steps read parameters, earlier outputs, the environment of your login shell and keychain items, so API keys stay out of the files. AI answers and long outputs stream into the panel. Existing micro-apps work as before; a run may take up to 300 seconds if the file sets timeout.

Steps shared by several micro-apps live once in ~/.config/ting/micro/libs/. A micro-app runs a library with call, or inherits it with inherit and changes only some values, for example one translate micro-app per language. When a library changes, Ting asks you to approve again every micro-app that uses it.

Ting.app/Contents/MacOS/ting-micro checks micro-apps (check), runs one in the terminal without panels or the clipboard (run), and checks config.json (check-config). The new guide CONFIGURING.md inside Ting.app tells Claude Code, Codex or pi how to add micro-apps, key bindings and settings; Copy Agent Prompt now points to it. Ask in plain words, for example “Leader t a should translate the clipboard into German”. A notify step asks for permission to show notifications the first time.

Ting 0.4.0: micro-apps

A micro-app is a small tool that runs one shell command. Each one is a YAML file in ~/.config/ting/micro/, in the format of FORMAT.md, which ships inside Ting.app and holds five working examples: Format JSON, Change case, Encode / decode, Count words and DNS lookup. Ting has no editor for them and installs none, so the folder starts empty. Bind a key in Settings › Bindings with + › Micro-app, or start a micro-app by name from launcha.

Before the first run, and after any change of the file, the approval panel shows the name, the file and the full command: Command-Return approves, Esc refuses. Then a parameter panel asks for the values and remembers them, and the result panel shows the output as markdown, console text with colours, plain text or code, or copies it. A failing command always shows its error. A file with a mistake is not used: the menu-bar menu warns, Settings › Advanced lists the errors, and micro-errors.log next to the config file holds them.

Copy Agent Prompt, in the menu-bar menu and in Settings › Advanced, copies a ready text for a coding agent such as Claude Code, Codex or pi; add what the micro-app should do and paste it. The agent writes and checks the file with Ting --check, which opens no window, reads no config and writes no file, and does not change config.json: you approve the file at its first start and bind its key yourself. Choose Check for Updates… in Ting to install it.

Ting 0.3.3

The “ting” that plays when Ting opens an app, link or file is now half as loud. Its switch in Settings → General → System is now called Play a “ting” when opening an app, link or file; turn it off to open things silently. The config key is still playSound. Choose Check for Updates… in Ting to install it.

Ting 0.3.2

launcha now indexes every app in its app folders. The index no longer stops at a time, entry or folder-depth limit, and the scan-limit notices are gone. Folder-access prompts and real access errors still appear. Choose Check for Updates… in Ting to install it.

Ting 0.3.1

This update reduces the space between selecta’s amber top rule and the leader-key row when the panel title is hidden. It now matches launcha. Choose Check for Updates… in Ting to install it.

launcha — Ting 0.3.0

Ting 0.3.0 adds launcha alongside the fixed-sequence menu, selecta. Double-tap the leader to search apps, or assign a separate hotkey in Settings; none is assigned by default. Apps come from /Applications, /System/Applications (including Utilities), ~/Applications and, after consent, ~/Desktop. Matches sort by successful Ting opens and activations over the last seven days, then the most recent one. Ting does not track launches outside Ting. The app index scans at startup and each time launcha opens; while it stays open, background scans run at most once per minute.

When no app matches a non-empty query, Spotlight searches indexed files in your home folder, excluding hidden paths, ~/Library and app bundles. Desktop, Documents and Downloads are skipped until you explicitly allow access; macOS may then request folder permissions. No Accessibility or Input Monitoring permission is needed. Use arrow keys to select, Return to open, Command-Return to reveal in Finder and Escape to close.

Show panel title applies to both panels. With it off, launcha starts with a compact search field and two tuning forks inside at the right; results remain a list. Usage and the folder-access choice stay local in ~/Library/Application Support/Ting/launcha-history.json and launcha-consent.json, separate from config. To remove this new data when uninstalling, also delete ~/Library/Application Support/Ting/.

Report a problem safely

Use https://github.com/bobuk-io/ting/issues for support. Include macOS and Ting versions, steps to reproduce, and the expected result. Do not post private URLs or tokens from your config.

Report security issues privately at https://github.com/bobuk-io/ting/security/advisories/new; see SECURITY.md in the repository.

Uninstall and remove data

  1. Turn off launch at login first if it is enabled.
  2. Quit Ting and delete /Applications/Ting.app, or run brew uninstall --cask bobuk-io/tap/ting for a Homebrew installation. Homebrew keeps your data unless you add --zap, which also deletes settings, bindings, micro-apps and saved application data.
  3. Optionally delete ~/.config/ting/ for settings, bindings, micro-apps and their error log, and ~/Library/Application Support/Ting/ for usage history, the folder-access choice, micro-app approvals and remembered values.

GitHub Issues are public and require a GitHub account to submit. Never include tokens, personal data, or private session contents.

Contact support ↗