TrackDown
Back to home Support

Help & frequently asked questions

Setup, integrations, export, and sync – the answers here are meant to get you back to work as quickly as possible.

Getting started

  • Open Settings → General and set your default hourly rate, currency symbol, and date format.
  • Under Integrations, enable Bear, Notion, or Obsidian and enter the required credentials.
  • Trigger Sync from the top of the projects list – your projects are imported.
  • Pick a project and tap Add Timer to start tracking time right away.

Integrations

How do I connect TrackDown to Bear?

Create an API token in Bear and paste it into TrackDown under Integrations → Bear. Projects are found via a configurable hashtag, e.g. #project. The token stays locally on your device.

How do I connect TrackDown to Notion?

Create an Internal Integration in Notion and copy the secret. Paste it into TrackDown under Integrations → Notion and pick the data source you want to use. You can optionally map a property for project status and a numeric property for the default hourly rate.

How do I connect TrackDown to Obsidian?

Your vault and its project notes need to be accessible to TrackDown. The exact steps are shown in the settings dialog under Integrations → Obsidian.

Can I use multiple integrations at once?

Yes. Each project stays linked to its original source and is later exported back to that same source.

Timers & export

Why can't I export a timer?

Exports only work for stopped timers. Stop the timer and try again. Also confirm that the relevant integration is active and correctly configured.

Where do my exports end up?

Always in the source the project came from:

  • Bear: a Markdown table with columns Date, Duration, Hourly Rate, Amount, and Notes, written into the linked note.
  • Notion: a native Notion table directly on the linked page – with the same columns as the Bear export.
  • Obsidian: a table in the corresponding project note inside your vault.
What's the difference between Export Open and Export All?

Export Open only appends timers that haven't been exported yet. Export All rewrites the full export table for the project.

I exported a timer by mistake.

Exported timers can be sent back to the open list via Mark as Open. They are then included in the next export again.

How do I adjust the duration of a timer?

Non-exported timers are fully editable. You can adjust the duration, hourly rate, or the Non-billable flag at any time.

Projects & archive

How do I archive a project?

The archived state is controlled by the integration. Set the project to the corresponding state in Bear or Notion and sync TrackDown again.

Where do I find archived projects?

The projects list has a separate view for archived projects. Earlier timers remain visible there.

iCloud sync

How do I enable iCloud sync?

Under Settings → Synchronization via Enable iCloud Sync. On enable, TrackDown merges local and cloud data.

What happens when I turn iCloud sync off?

TrackDown keeps the last visible cloud state locally. The activation of an integration stays device-specific – it is not carried over automatically via iCloud.

Something looks off after syncing – what now?

Under Advanced Settings, the Diagnostics view shows store status, local settings, and SwiftData / iCloud-KVS contents. That usually helps narrow the issue down.

Resetting data

Under Advanced Settings → Delete All Data you can remove all projects, timers, and TrackDown settings. With iCloud sync enabled, TrackDown's KVS data in iCloud is also deleted.

This action can't be undone. Already-exported content in Bear, Notion, or Obsidian is untouched – it lives in the respective service.

Platforms

  • iOS 18 or later
  • iPadOS 18 or later
  • macOS via Mac Catalyst

Live Activity and Dynamic Island controls are iPhone-only. Under Mac Catalyst, TrackDown runs without the ActivityKit surface.

Contact

Reach out via email at trackdown@neverstop.swiss. If possible, include the device, the app version, and the steps that led to the issue – it helps us respond faster.