Toggl Mac OS
Toggl Mac OS
This article covers:
- We work with native technologies so that we can use all the power and functionalities provided by the OS. You will be in good company, too. Toggl is a team of fantastic professionals. Everyone is smart, fun and caring. We are profitable and self-funded, and we’re taking Toggl to the next level. Join us for the ride!
- How to Install Toggle for Toggl for Windows PC or MAC: Toggle for Toggl is an Android Productivity app that is developed by Right From Left and published on Google play store on NA. It has already got around 1000 so far with an average rating of 2.0 out of 5 in play store.
Linux and Mac If you aren’t using Windows, Toggl is available for the Linux and Mac operating systems, making it available on all major operating systems. TogglDesktop 7.877 for Mac can be downloaded from our website for free. Our built-in antivirus checked this Mac download and rated it as 100% safe. This free Mac app is an intellectual property of Toggl Inc. The program is included in Productivity Tools.
What is Toggl Track desktop app?
Toggl Track for Mac is a native macOS application that can be installed on your computer. It works seamlessly with the web version of Toggl Track, syncing data on the fly. The desktop app also works offline; it stores data locally and sends it to the Toggl Track server once you’re back online.
Download the App
Click here to download the app! Please note that this version of Toggl Track desktop app works only on macOS 10.11 El Capitan or newer.
Toggl Track 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 Track.
Please note, the App Store version will not automatically update unless you have enabled this setting in System Preferences.
Tracking Time and Managing Data in List and Timeline View
The app offers two views; List and Timeline, bringing our Timeline feature into the desktop app and allowing users to add/edit time entries directly in it. Both views allow you to track and edit time entries.
Toggl Track will switch between Light and Dark mode based on your macOS preferences.
List-View
List-view 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 60 days' worth of time entries for a better overview by clicking “Load more” at the bottom of the list.
1. Using the Timer
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. Use @ to enter Projects and # to enter tags in the description field.
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.
You can also enter details via your keyboard, using the tab button to move through fields and spacebar to make a selection.
To make it easier to differentiate, the Toggl Track desktop app icon on your dock will be pink when the timer is running, and grey when it is not. The same applies to the menu bar, but in different colors: black or transparent.
2. Adding manual entries in List-view
You can use Manual Mode if you want to add time entries at a later time. To switch to Manual Mode, open the Toggl Track menu from the menu bar and click “Switch Mode” (Keyboard shortcut: ⌘D).
Here's what the app will look like in Manual Mode.
3. Editing time entries in List-view
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.
Timeline-View
The Timeline view shows your tracked time in a vertical timeline side-by-side with your activity data. You can switch Timeline on at the top of this view, as well as switch the date, and zoom in and out (keyboard shortcuts: ⌘+ and ⌘-).
Please note: On macOS 10.15 the desktop app needs Screen Recording permissions to access complete data for the Timeline feature. If permissions are not granted, the Timeline feature will still work, but it will only display the application name and not the window title for additional details. A warning will appear when users switch on Timeline if they need to provide these permissions.
Time entries are shown as “pills”, color-coded to match the project they belong to on the left next to the date.
Information relating to the time entry is displayed while hovering over the item, or to the right of the pill if there are no overlapping time entries for the period. However, if an overlapping entry is found, this information is not displayed and can be viewed by hovering over the item.
Timeline activity is shown on the right and is only visible to the logged-in user. This data allows you to quickly compare your actual time entries with your activity, and make any changes necessary in one view. The darker a blue pill is in the activity view, the more active you were during that period of 15-minutes.
Please note, we only display and store the 9 days of your timeline data in the desktop app. You can learn more about this feature here, and learn how to export your timeline data here.
1. Adding time entries in Timeline view
To add a new entry, click on that place in the timeline to create a new entry and add details.
Here you can add a description, choose a project and task, add tags just as while adding time in List-view.
2. Editing time entries in Timeline-view
To edit a time entry, click on it and a popup will open where you can edit details. You can also drag and drop an existing time entry to a different time of the day, or resize a pill to change the duration of the time entry.
3. Managing overlapping entries
When two entries overlap, you can right-click on the latter time entry to adjust the start or end time to remove the overlap. A menu will allow you to choose between updating the stop time of the first entry or updating the start time of the second one.
4. Filling in gaps
When there is a gap in your day, a pill with a dashed border will show the empty space between time entries. Clicking on it will create a time entry with the exact start and end time you need to fill in the gap.
Adding Projects in the Desktop app
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.
Syncing Data
Toggl Track 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 Track 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.
Managing Preferences
To edit the settings of your desktop agent, just click Toggl Track 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.
1. Preferences – General tab
Show/Hide Toggl: Set a global shortcut to show or hide the Toggl Track 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 Track 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.
Keep idle time: Ignores idle time, and adds it to the currently running time entry.
Add idle time as new time entry: Stops previously running timer, and adds idle time as a new time entry.
The Cancel button at the bottom will also ignore the idle time, and add it to the currently running time entry.
Pomodoro
Click 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.
Show Project on Menu Bar: View the Project for the current timer on the Menu bar next to the Toggl Track Icon
Show Dock Icon: Show/Hide Toggl Track icon on your dock.
Other configurable options:
Keep Toggl on top of other windows.
Stop running entry on computer sleep/shutdown.
Focus app on global shortcut. This will always put the app into focus when using the Continue/Stop timer shortcut.
Open Edit view when starting a time entry.
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.
Show Toggl in Touch Bar: feature to be removed soon
2. 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 Track desktop app will use the same proxy settings you have set up for your system.
If you are struggling to connect our desktop app to the network, you can ignore SSL verification from the Proxy tab as well. Do note, this can make the app vulnerable to to man-in-the-middle attacks.
3. 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. Keep in mind that the AutoTracker notification will only trigger if you do not have a timer already running.
4. Preferences – Reminder tab
Under the Reminder tab, you’re able to customize your tracking reminders. These reminders are triggered when the Toggl Track 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 and MacOS TouchBar Integration
Toggl Track desktop app sports several keyboard shortcuts for fast time entry, and also supports the Macbook Pro Touch Bar.
Keyboard Shortcuts
⌘ 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
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
Timeline View Zoom
⌘+ – Zooms in
⌘- – Zooms out
MacBook Pro Touch Bar Controls
Time Entries List: Shows the last 10 unique entries in the list. Users can quickly start a time entry by tapping on it.
Start/Stop Button: This functions like the Start button in the app.
Running Time Entry: Shows the current running time entry.
The Toggl Track desktop app is an open-source project. You’re welcome to help us by submitting pull requests, bug reports, or feature requests to our GitHub page.
Still confused about how the MacOS app works? Feel free to contact our support team!
Being an online service, Toggl Track lets you access your account and data via multiple platforms. Currently, you can access your Toggl Track account via the following apps:
All your time tracking data is synced between these apps so that you can easily switch between them at your convenience.
Common sync issues: Desktop apps
The Toggl Trackdesktop app (Mac, Windows, Linux) most commonly has issues when used in an office environment with a restricted internet connection, such as a proxy or a firewall. This will prevent the app from syncing your data or could even prevent you from logging into the app.
The app will show exclamation marks next to time entries which have failed to sync.
You might also get a message telling you the app is offline at the bottom of the main app window as shown above.
Triggering sync manually
If you end up in a similar situation, it's best to first try triggering sync manually within the app.
If you are using a Mac or a Linux version of the Toggl Track desktop app please navigate to Account > Sync to trigger sync manually.
If you are a Windows user please click on the cogwheel icon located on the top-right corner of the main window (the timer window) and then select 'sync' from the drop-down menu.
Optimizing your network
If this doesn't work, if possible, try connecting to a different network to determine if the one you are currently connected to has restrictions on it. If you see that the app doesn't have syncing issues while you are connected to a different network or if you are not able to test this out in your office environment usually the best thing to do is ask your network administrator to white-list Toggl Track on the network you are connected to. It also helps to make sure that ports 80 and 443 are open towards track.toggl.com and desktop.track.toggl.com.
Reach out to support
If the above options did not work, you should reach out to our support team. For us to assist you better it's best to share the app's local data as well when you reach out so that we can sort out the issue you are having as soon as possible. The following article describes the location of each database (.db) file.
Common sync issues: Mobile apps
Toggl Track mobile apps (iOS, Android) will try to sync as often as possible in the background to ensure real-time data when you open the app. However, due to iOS and Android limitations, there might be limits to how often your app syncs based on your battery life and other factors. Users on an unstable network (e.g., EDGE) or those using the app offline for an extended period of time might also notice that it takes longer for the app to sync than usual.
Toggl Mac Os Catalina
Time entries created in the mobile app that have not yet synced with our servers will have a grey exclamation mark. Time entries that have failed to sync will have a red exclamation mark next to them.
Trigger sync manually
While the app is designed to sync automatically when you open it (assuming it has been in the background for more than 5 minutes), you can also trigger sync manually. To trigger sync manually you simply need to pull down on your screen while on the timer page. You will see a loading circle while the app is syncing your data.
Reaching out to support
If the above doesn't help or it just helps briefly and the issue re-appears after a short while please reach out to our support team for further assistance. It's best to use the in-app feedback form if possible so that we can get some useful information along with your message.
Toggl Mac App
If your app is completely offline and you are not able to use the feedback form please specify in your message the make and model of your mobile device, the OS it's running, and the version of the app that is installed on your phone.
To see which version of the Toggl Track app is on your phone tap on the cogwheel icon to access the settings page where you will be able to find that information.
Mac Os Mojave
Common sync issues: The web app
The web app via your browser is actually the 'most direct link' you can have with our servers and it's really rare to see a syncing-related error there but it can happen and it usually happens due to actual connection issues that may be caused by network restrictions as described above for the desktop app. If the web app is offline you will see the following option to 'reconnect':
Keep in mind that this can also happen if you just opened up your laptop, waking it up, and it still hasn't connected to a network. Clicking 'reconnect' as soon as you see that your device is online should do the trick in that scenario.
If any of the time entries you created with the web app didn't sync you will see an exclamation mark on the left side of the time entry description. Hovering your mouse over the exclamation mark will give you the option to retry syncing that specific time entry.
Toggl Mac Os Catalina
If trying different networks, tweaking the network settings for proxy and firewall, refreshing the page, or clicking on the 'reconnect button' doesn't help please reach out to our support team and we will do our best to assist you.
Toggl Mac OS