In this article: tracking time, grouped mode, unsynced entries, editing time, settings.
Toggl Desktop for Linux is a native 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 for Linux here:
Note: Installing on Ubuntu 16.04 might require installing some additional dependencies manually.With Ubuntu 16.04 and newer the libgstreamer0.10-0 is not available. Current workaround is to use commands:
wget http://fr.archive.ubuntu.com/ubuntu/pool/main/g/gst-plugins-base0.10/libgstreamer-plugins-base0.10-0_0.10.36-1_amd64.deb wget http://fr.archive.ubuntu.com/ubuntu/pool/universe/g/gstreamer0.10/libgstreamer0.10-0_0.10.36-1.5ubuntu1_amd64.deb sudo dpkg -i libgstreamer*.deb
Note: On HiDPI screens the app might not be scaled correctly. The current workaround for this is to edit the toggldesktop.desktop file (usually found in “/usr/share/applications/”) and set the “Exec” line to read:
Exec=env QT_SCALE_FACTOR=2 toggldesktop
Change “2” to the scaling factor your desktop environment has set up.
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. To display more time entries from the past, scroll to the bottom and click on the “Load More” button.
The app can display each time entry individually or as time entry groups. 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.
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 forcing sync doesn’t help please contact Toggl support.
By clicking on a time entry, you’ll be 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 not.
To edit the settings of your desktop agent, just open the Preferences window from the menu bar. This is what you’ll see:
- 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.
- 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.
- Remind to track time – When you’ve enabled this, the reminder pops up 10 minutes after you’ve signed in to your desktop agent and haven’t been tracking that day.
- 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.