❗ 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):
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 (
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.
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.
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
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
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
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)
Any other questions?
Need further help with the Toggl Track desktop app for Linux? Please contact our support team.