Toggl Desktop for Mac is a native macOS application that can be installed on your computer. It works seamlessly with the web version of Toggl, syncing data on the fly. Toggl Desktop also works offline; it stores data locally and sends it to the Toggl server once you’re back online.

Click here to download the app! Please note that this version of Toggl Desktop works only on macOS 10.11 El Capitan or newer. 

Toggl Desktop is also available on App Store! If you prefer the App Store update system more than the current automatic updater, you are more than welcome to switch to the App Store version of Toggl Desktop.

Toggl Desktop will switch between Light and Dark mode based on your MacOS preferences. 

Tracking time

Tracking time with the desktop agent is as simple as it could possibly be. 

Fill in the details of what you’re doing in the “What are you doing?” field, and click on the green “play” button to start the timer. 

If you start the timer first and wish to add the details later, just click on the timer and a popup window appears where you’re able to edit the description, project, tags, duration, start/stop times and the date. On paid plans, you’re also able to mark the entry as “Billable” or not. 

To make it easier to differentiate, the Toggl Desktop icon on your dock will be red when the timer is running, and grey when it is not. The same applies in the menu bar, but in different colors: black or transparent.

The app can display each time entry individually or it can group entries with the same description and project together. This behavior can be controlled by enabling/disabling the “Group similar time entries” option on the Profile page. For more details about time entry grouping please open the Timer Page article.

You can load up to a full month’s worth of time entries for a better overview by clicking “Load more” at the bottom of the list.

Adding time manually

You can use Manual Model if you want to add time entries at a later time. To switch to Manual Mode, open the Toggl Desktop menu from the menu bar and click “Switch Mode” (Keyboard shortcut: ⌘D). 

Here's what the app will look like in Manual Mode. 

Toggl syncs all your entries back to the web automatically. However, if there is an issue with the app connecting to our server you may have unsynced entries. For more details on how Toggl sync works open this syncing article

You will see a warning next to your entry in the form of a red exclamation mark in the center of a pink triangle. If this happens, navigate to the Menu bar, and click Account > Sync.

If the sync is unsuccessful, please log out and log back into the desktop. To avoid data loss, be sure to make note of any unsynced entries which will then need to be added manually.

Editing time entries

Editing your time entries in the desktop app has the same basics – just click on the entry you wish to edit and a similar popup window appears. Once you’re done editing, close the popup window. Changes are saved automatically. To continue a time entry, just click on the arrow button next to the time entry.

 To rearrange your data and move an entry to a different date use drag-and-drop:

Adding Projects

Projects can be added while editing time entries, including the one currently running. 

In the edit popup window, select “Add New Project”. From where you can define the project name, color (customizable colors available on paid plans only), workspace and client. You can also enter the description for the entry you’re editing. When you’re done, click on the X button in the top right corner of the popup.

Preferences

To edit the settings of your desktop agent, just click Toggl Desktop in the menu bar and then choose Preferences. 

Preferences are divided into 4 tabs, and shown one section at a time. This is what you’ll see.

Preferences – General tab

Show/Hide Toggl: Set a global shortcut to show or hide the Toggl app. This will work even when the app is not in focus. 

Continue/Stop Timer: Set a global shortcut to continue or stop the Toggl Timer. This will work even when the app is not in focus. 

Idle detection: Get notified of the time that you’ve been inactive/away from the keyboard. The notification will popup after an X number of minutes as set in your preferences. 

After the notification has popped up, you can decide whether you want to keep the time or discard it. Here’s what it looks like:

The popup has four options for you to choose from: 

  • Discard idle time: Discards idle time, and stops the running timer from when you went idle. 
  • Discard idle and continue: Discards the idle time, but starts a new time entry that matches the previously running timer so you can resume work. 
  • Add idle time as new time entry: Stops previously running timer, and adds idle time as a new time entry.  
  • Cancel: Ignores idle time, and adds it to the currently running time entry. 

Pomodoro timer: Allows users to use the Pomodoro Technnique to improve productivity. You can setup intervals for work (Pomodoro Timer) and break (Pomodoro Break Timer) cycles, and get notified when it's time to stop working or when the break time runs out. 

Tick the ‘Pomodoro Timer’ option to enable it and set your preferred intervals for both work and break cycles. 

Clicking Continue at the end of a break cycle restarts the last time entry you were using. Clicking Continue at the end of a work cycle continues the running time entry. 

Record timeline: If you tick this option, all websites and programs that you view for longer than 10 seconds will be recorded. You can learn more about this feature here. We hope to have this available in the desktop app soon! 

Show Timer on Menu Bar: View the current running timer on the Menu bar next to the Toggl icon

Show Project on Menu Bar: View the Project for the current timer on the Menu bar next to the Toggl Icon

Show Dock Icon: Show/Hide Toggl icon on your Doc. 

Other configurable options: 

  • Keep Toggl on top of other windows
  • Stop running entry on computer sleep/shutdown
  • Focus app on global shortcut
  • Open Edit view when starting entry without shortcut

Default project: Pick one project that you use the most, and fill it in automatically whenever you start a time-entry without a project. If needed you can still change the project for both running and stopped time-entries.

Change duration when changing start time: Choose whether you want the duration updated when a time entry’s start time is updated. 

Preferences – Proxy tab

Under the Proxy tab you can configure proxy settings if you happen to be behind a proxy. 

If you tick the ‘Use system proxy settings’ checkbox, Toggl Desktop will use the same proxy settings you have set up for your system.

Preferences – Autotracker tab

Under the Autotracker tab you can define applications or keywords and projects they connect to. 

If an application with the keyword is in the foreground it triggers the AutoTracker. When the tracker is triggered it shows you a notification and asks if you would like to track time under the project you chose.

Preferences – Reminder tab

Under the Reminder tab you’re able to customize your tracking reminders. These reminders are triggered when the Toggl Desktop app is running but there are no running entries. This tab allows you to set the days on which the reminders are active as well as the time of day when they can trigger.

Note: If can't see any notifications from our desktop app, please make sure that Do Not Disturb is off.

Keyboard Shortcuts

Toggl Desktop sports several keyboard shortcuts for fast time entry:

  • ⌘ N creates a new time entry and displays the edit window
  • ⌘ D changes between timer and manual mode
  • ⌘ S stops the running time entry
  • ⌘ O continues the last recorded time entry
  • ⌘ E open running entry in edit popup

Also there are context-specific shortcuts to make navigating inside the app easier:

Switching between timer and Time entry listing

  • SHIFT+DOWN – Focuses the Time entry listing
  • ESC – If the edit popup is opened it always closes the popup (even if listing is focused). If edit popup is not opened and entries list is focused it will switch the focus to Timer.

Moving inside Time entries listing

  • UP/DOWN – switch between selected time entry
  • ENTER – open the edit view of selected time entry
  • SPACE –  continue the selected time entry
  • BACKSPACE – delete the selected time entry

Collapse/expand data

  • LEFT ARROW – collapses grouped time entries
  • RIGHT ARROW – expands grouped time entries

Toggl Desktop is an open source project. You’re welcome to help us by submitting pull requests, bug reports or feature requests to our GitHub page.

Did this answer your question?