Support

Contact us

Email support@timebolt.cloud. It helps to include:

• your macOS version and TimeBolt version (TimeBolt ▸ About TimeBolt);
• where you got TimeBolt: Mac App Store, TestFlight or direct download;
• what you did, what you expected, and what happened instead.

Keyboard shortcuts

Anywhere on your Mac

These work while TimeBolt is running, even when another app is in front. Change them in TimeBolt ▸ Settings ▸ Hotkeys.

In TimeBolt

Previous and next day can also be changed in Settings ▸ Hotkeys.

In Quick Entry

Entry syntax

Everything in Quick Entry is one line:

activity@category, description #tag1 #tag2

• Only the activity is required.
• The category is whatever follows the last @ before the comma.
• Everything after the first comma is the description.
• Tags start with # and a letter, and can go anywhere in the line. #123 stays as text.
• Times and durations go before the comma.

Times and durations

• Times use the 24-hour clock, as in 14:30. A range whose end is earlier than its start runs past midnight.
• Durations accept h, m, hours and minutes, and phrases such as for the next 45 minutes.
• Use one duration or one time range per entry. A minus duration can't be combined with a start time.

Put together: research@Acme for 2h, pricing page #web #seo logs two hours of research in the Acme category, described as pricing page, tagged web and seo.

Where your data lives

Everything you log is stored on your Mac. Nothing is sent to us.

Direct download

~/Library/Application Support/TimeBolt/

Mac App Store and TestFlight

~/Library/Containers/com.treesong.timebolt/Data/Library/Application Support/TimeBolt/

TimeBolt ▸ Settings ▸ General ▸ Data shows the exact location. Integration keys and tokens are in your macOS Keychain, and the list of your assigned tasks is cached in TimeBolt's Caches folder.

Moving to a new Mac? Export a CSV on the old one and import it on the new one, then reconnect your integrations. TimeBolt doesn't sync between Macs.

To run TimeBolt from the menu bar without a Dock icon, choose Menu Bar Only in Settings ▸ General ▸ App Behavior. Start on Login is in the same pane.

Connect Calendar

TimeBolt suggests entries for meetings you attended, using the calendars already on your Mac (iCloud, Google, Exchange and any others in System Settings ▸ Internet Accounts).

1. Open TimeBolt ▸ Settings ▸ Integrations.
2. Turn on Suggest Entries from Calendar, and allow access when macOS asks.
3. Choose which calendars to include. You can also turn on Suggest meetings in Quick Entry and Tag meeting entries #meeting.

Meetings you attended then appear as dashed suggestions on Today's timeline. Click one to open it in Quick Entry, Option-click to add it straight away, or Control-click to dismiss it. Nothing is logged until you accept, and events never leave your Mac.

If you declined access earlier, choose Open Privacy Settings in the same pane, or go to System Settings ▸ Privacy & Security ▸ Calendars and turn TimeBolt on.

Connect Linear

With a personal API key (available now)

1. In Linear, open Settings ▸ Account ▸ Security & access and create a personal API key. Read access is all TimeBolt needs.
2. In TimeBolt ▸ Settings ▸ Integrations ▸ Work Items, choose Connect… for Linear.
3. Paste the key and choose Connect. The account shows as connected.

Your assigned issues then appear in Quick Entry. Type an issue key such as ENG-123, part of its title, or paste its link, then press ↓Down Arrow and Return. The entry links back to the issue.

Sign in with Linear (coming soon)

Sign In with Linear… will open Linear's sign-in in a secure window and ask for read access only. You may see a timebolt.cloud page that says "Returning you to TimeBolt…" while your sign-in is handed back to the app. If TimeBolt doesn't open, make sure it is installed and running, then choose Open TimeBolt on that page.

Disconnect

Choose the ⋯ menu next to the account, then Disconnect…. TimeBolt removes the key or sign-in and the cached task list from your Mac; your entries stay linked to their issues.

Export your data

Choose File ▸ Export CSV… (⌘⇧ECommand Shift E). The file has every entry with its category, description, tags, start and end times, and links. File ▸ Import CSV… (⌘⇧ICommand Shift I) brings entries back in.

Delete your data

• All entries: TimeBolt ▸ Settings ▸ General ▸ Data ▸ Delete All Data… permanently deletes every activity, time entry and tag. It can't be undone, so export first if you might want them.
• An integration: disconnect it in Settings ▸ Integrations.
• Everything: quit TimeBolt and delete its data folder (above). The privacy policy lists every file TimeBolt keeps.

Troubleshooting

A global shortcut does nothing

Another app may be using it. Pick a different one in TimeBolt ▸ Settings ▸ Hotkeys.

Start on Login says approval is required

Allow TimeBolt in System Settings ▸ General ▸ Login Items. If it says the login item is unavailable, move TimeBolt to your Applications folder and try again.

A meeting isn't suggested

Check that its calendar is included in Settings ▸ Integrations. TimeBolt skips all-day, cancelled and declined events, and events that haven't started yet.

TimeBolt didn't open after signing in to a service

Make sure TimeBolt is installed and running, then choose Open TimeBolt on the timebolt.cloud page. If that page has closed, start the sign-in again from Settings ▸ Integrations.

Still stuck? Write to support@timebolt.cloud.