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:

sudo dpkg -i libgstreamer*.deb

Note: On HiDPI screens the app might not be scaled correctly. The current workaround is to setup the value of your desktop environment scale factor.

Just add the line:


to the top of the file

If you used the tar.gz package the is in the directory you unpacked the app. With other packages the .sh file is in /usr/bin/

To let Qt decide the scaling factor for you, use this (1 means true in this case) :
If you have multiple screens, it's possible to set the scaling factor by using the following environment variable (this example will set the primary screen to 1.0 scaling and the secondary to 2.0, consult for more information):
Or you can just use this to set global UI scaling for the app on all monitors (2 means the scaling factor should be 2.0):

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. 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 Timer Page 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.

Editing time entries

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.

Please note that it is not possible to create new Tags with the Linux app. Please use Workspace Settings Tags tab to add/edit Tags.



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.
Did this answer your question?