Support

How can we help?

Email us at support@usechukka.com. A real person reads every message. It helps to include your macOS version and Chukka's version (Chukka menu → About Chukka).

Getting started

Click Clients at the bottom right and add each client with their hourly rate.
Click + (or press ⌘ N) to add a project and choose its client.
Select the project and press the big play button, or the Space bar. Press it again to stop. Each start and stop is saved as a session.

With nothing selected, the play button resumes the project you worked on last.

Keyboard shortcuts

Start or stop the clock (main window)	`Space`
Start or stop the clock (anywhere in Chukka)	`⌘` `↩`
Stop the clock	`⌘` `.`
New project	`⌘` `N`
Clients and rates	`⇧` `⌘` `K`
Client summary PDF	`⇧` `⌘` `P`
Export sessions as CSV	`⌘` `E`
Import time entries	`⇧` `⌘` `I`
Undo	`⌘` `Z`
Settings	`⌘` `,`

Fixing a session

Double-click a project to see all its sessions. You can change start and end times, delete a session, or add time you forgot to track with Add Time Manually.

Idle time and long sessions

If you step away while the clock runs, Chukka asks what to do when you're back: remove the time you were away, stop the clock at the moment you left, or keep it. If the clock runs for hours without a break, Chukka checks in. Both can be adjusted or turned off in Settings.

Billing and invoicing

Unbilled time: choose a date range at the top of the window, select projects and click Mark Invoiced. Invoiced work shows a green check.
Client summary PDF: Export → Client Summary. It covers the selected projects in the current date range. Add your business name and logo in Settings → Billing.
Rounding: Settings → Billing can round each session up to 6, 15 or 30 minutes, or an hour.
Custom rates and fixed prices: set them per project in the project editor.

Backups and moving to a new Mac

Chukka saves a backup every day and keeps the last 30. To go back to one, choose File → Restore from Backup…. You can undo a restore with ⌘ Z.

To move to a new Mac, quit Chukka and copy the folder ~/Library/Application Support/Chukka to the same place on the new Mac. (In Finder, choose Go → Go to Folder and paste that path.) Migration Assistant and Time Machine bring it across automatically too.

Importing from another app

Export your time entries as CSV from Toggl Track, Clockify or Harvest, then choose File → Import Time Entries in Chukka. Existing clients and projects are matched by name, and entries you already have are skipped. After importing, check the hourly rates of any new clients.

Still stuck?

Email support@usechukka.com and we'll sort it out.