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.

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.

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.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.
  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 ↗