All Collections
Desktop apps
Toggl Track desktop app for Linux
Toggl Track desktop app for Linux

Track time with a native Linux application. Includes features such as pomodoro, idle detection and timeline

Vedran avatar
Written by Vedran
Updated over a week ago

Important announcement

Toggl Track will no longer be available on Linux by March 1, 2023.

Earlier this year, we launched v9 of the Toggl Track API and announced that we would be phasing out v8 within the next six months. The existing Linux desktop app, which runs on v8, will no longer function once v8 has been fully deprecated.

Your Toggl Track account will remain as is, and you’ll be able to continue tracking time on our web app, browser extensions for Chrome or Firefox, mobile apps for iOS or Android, or our desktop apps for Mac or Windows.


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

You can download the desktop app for all Linux distributions here:

Alternatively, we currently provide these deprecated options (may be abandoned in the future):

  • For Ubuntu 16.04 and newer: deb 64bit

  • For other distributions: tarball - this package will require some dependencies to be installed, most importantly OpenSSL 1.1, GStreamer 1.0, libXSS, libXKBCommon and D-Bus.

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 run the following command:

sudo flatpak override --env=QT_SCALE_FACTOR=2 com.toggl.TogglDesktop

And next time you run the application, it will be scaled to twice the size.


To let Qt decide the scaling factor for you, use this (1 means true in this case, not how big the app should be), then the app should have the right size on all your screens:
sudo flatpak override --env=QT_AUTO_SCREEN_SCALE_FACTOR=1 com.toggl.TogglDesktop

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 https://doc.qt.io/qt-5/highdpi.html for more information):
sudo flatpak override --env=QT_SCREEN_SCALE_FACTORS=1;2 com.toggl.TogglDesktop

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

Preferences

General Tab

To edit the settings of your desktop agent, just open the Preferences option from the menu bar. This is what you’ll see:

  • Set up shortcuts – You can set up custom shortcuts for showing/hiding the app, for continuing the latest time entry or stopping a currently running timer: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. Learn more


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.

Keyboard Shortcuts

Keyboard shortcuts are a great way to quickly and easily start, edit, and manage your Linux app experience. Here are some keyboard shortcuts you can use in the app:

Current Time entry manipulation

  • Ctrl+N creates a new time entry and displays the Toggl Track window

  • Ctrl+S stops a running time entry

  • Ctrl+O continues a previous time entry

  • Ctrl+E open running entry in edit popup. This can also be used to immediately edit an Entry created with Ctrl-N.

  • Ctrl+R syncs data

Switching between the Timer and Time Entry List

  • SHIFT+DOWN focuses the Time entry list

Moving within the Time Entry list

  • 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 current day’s time entries (or the day you have navigated to)

  • RIGHT ARROW – expands all time entries for the day (or the day you have navigated to)

Did this answer your question?