The Toggl Track Linux app has been deprecated as of April 17, 2024.

--

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):

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

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

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:
​
​

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

Switching between the Timer and Time Entry List

Moving within the Time Entry list

Collapse/expand data