Support

How can we help?

Getting started

1. Click Clients at the bottom right and add each client with their hourly rate.
2. Click + (or press ⌘ N) to add a project and choose its client.
3. 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.

The play button starts the clock on the project you've selected. With nothing selected, it waits for you to pick one. In compact mode, it resumes the project you worked on last.

Quitting Chukka stops the clock. If Chukka ever closes unexpectedly while the clock is running, it asks what to do with that time the next time it opens.

Keyboard shortcuts

Start the selected project, or stop the clock (main window)	Space
Start the selected project, or stop the clock (whenever Chukka is in front)	⌘ ↩
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 hour while you work, keeps those for 2 days, and keeps one a day for 30 days. To go back to one, choose File → Restore from Backup… and pick it from the list. Your current data is saved first, and you can undo a restore with ⌘ Z.

Moving to a new Mac? Migration Assistant and Time Machine bring your Chukka data across automatically. To move it by hand, choose File → Restore from Backup… → Show in Finder on your old Mac and copy the newest backup to the new one. Then, on the new Mac, choose File → Restore from Backup… → Other File… and pick it.

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.

The free version and Chukka Unlimited

Chukka is free to download and keeps one active project at a time. When you're done with a project, mark it completed and start the next one. Its time and earnings stay in your history.

Chukka Unlimited is a single in-app purchase that removes the limit: as many active projects as you like, and completed projects can be reopened. No subscription. Unlock it from the offer that appears when you add a second project, or in Settings → Chukka Unlimited.

New Mac, or reinstalled Chukka? Choose Settings → Chukka Unlimited → Restore Purchase. It's free with the same Apple Account you bought it with.

Still stuck?

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