Toggl Desktop for Mac

In this article: download, adding a project tracking time, adding time manually, unsynced entries editing, drag and dropsettingsidle detection, Pomodoro timerdefault projectproxy settingsautotracker, reminders, keyboard shortcuts.

 

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

You can download the desktop app here. (Please note that this version of Toggl Desktop works only on Mac OS X 10.8 Mountain Lion or newer!)

Toggl Desktop is also available on App Store! If you feel that you like 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.

 

Tracking time

Tracking time with the desktop agent is as simple as it could possibly be. Just fill in the details of the job you’re doing 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, start/stop times and the project. You’re also able to add tags and decide whether the entry is marked as “Billable” or no.

Screen Shot 2017-01-02 at 19.08.33

To make your life easier, the Toggl Desktop icon in your dock turns red when the timer is running, and grey, when it’s not. The same applies in the menu bar, but in different colors: black or invisible.

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 inside the Profile page. For more details about time entry grouping please open the Grouped Mode article.

Screen Shot 2017-01-02 at 19.09.08

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

 
osx_7.3.303_more
 

Adding time manually

To be able to add your time later, we recommend you to use the manual mode. You can use that by opening up the Toggl Deskop menu from the menu bar. There’s “Switch mode” or “Use manual mode”. (Please note that there’s also a keyboard shortcut for that –⌘D) After clicking on that, this is what you’ll see:

 
mac 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. You will see a warning next to your entry in the form of a white exclamation point in the center of a gray triangle. If this happens please navigate to Account > Sync.

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

 
Unsynced Entry 2
 

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.

 
mac edit view
 


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

 
osx_7.3.303_drag
 

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, 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.

 
Adding A Project For Mac
 

Preferences

To edit the settings of your desktop agent, just open the Preferences window from the menu bar. Preferences are divided into 4 tabs showing you only one section at a time. This is what you’ll see…

 

 

Preferences – General tab

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.

Idle detection notifies you of the time that you’ve been inactive/away from the keyboard. After the notification has popped up,  you can decide whether to keep the time or discard it. Here’s what it looks like:

 
Screen Shot 2015-08-24 at 11.48.02
 

Pomodoro timer – with the Pomodoro timer you can set up notifications that will let you know that it’s time to take a break. Tick the ‘Pomodoro Timer’ option to enable it and set your preferred interval.

 

 

Default project setting allows you to pick one project that you use the most. This project will be automatically filled in each time you start a time-entry without a project. If needed you can still change the project for both running and stopped time-entries.

 
def_proj
 

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 tracker is triggered it shows you a notification and asks if you would like to track time under the project you chose.

 

autotracker-timer

 

Preferences – Reminder tab

Under the Reminder tab you’re able to customize your tracking reminders. You can choose how often the reminder will pop up; choose the weekdays you want to be notified (no more Sunday reminders!). Also, you can choose the time of day when you want to be reminded to start working.

 
reminder
 

Keyboard Shortcuts

Toggl Desktop sports several keyboard shortcuts for fast time entry:

  • Cmd-N creates a new time entry and displays Toggl Desktop window
  • Cmd-D changes between timer and manual mode
  • Cmd-S stops a running time entry
  • Cmd-O continues a previous time entry
  • Cmd-T displays Toggl Desktop window
  • Cmd-E open running entry in edit popup

Also there are context specific shortcuts to make moving around inside the app more easy:

  • 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 (event 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
    • LEFT/RIGHT – open and close selected group
    • ENTER – open the edit view of selected time entry
    • SPACE –  continue the selected time entry
    • BACKSPACE – delete the selected time entry

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 – https://github.com/toggl/toggldesktop/ .

 



If you didn't find what you were looking for, please write to support@toggl.com and we are happy to help!


Was this article helpful?
Yes
No
Thanks for giving us thumbs up! Any feedback is still welcome! Thanks for the feedback! Any ideas what we could do better?

* Please leave your e-mail if you'd like us to get back to you :)

Thanks for your feedback! We're always working to help you better!
Oops! Something broke. We're working on fixing it. Sorry
TOP