At the moment, we will not implement nor accept pull requests implementing new features in this repository.
We’re currently reworking the internals of our macOS and Windows desktop apps, and we plan to release the refreshed apps soon. If you’re interested in trying the app now, take the beta version for a spin. For more information, please visit the macOS or Windows feedback repository.
Toggl Desktop is a Toggl time tracking client with many helper functions that make tracking time more effortless and smooth. Features such as Idle detection, reminders to track and Pomodoro Timer make this app a great companion when productivity and efficiency is the goal.
Toggl built and signed apps for all platforms
Please check OS specific requirements below.
By default the app builds for testing server. To use the compiled app with live server see this guide https://github.com/toggl-open-source/toggldesktop/wiki/Building-Toggl-Desktop-from-source-for-usage-with-live-servers
$ sudo gem install bundler
# Prepare cocoapod $ make init_cocoapods
bundle exec pod repo update in case there is an error about out-of-date source repos (some pod version is missing).
You'll need these Qt (at version 5.12 or higher) modules: QtWidgets (with private headers), QtNetwork, QtNetworkAuth, QtDBus, QtX11Extras
If Qt is not installed from your distribution's package manager, you will need to set the
CMAKE_PREFIX_PATH environment variable to point to the
lib/cmake folder in the Qt version you wish to use.
These dependencies are mandatory:
libxss-devin deb-based distros and
You can install them all in debian with a command:
$ sudo apt install libxss-dev build-essential libgl-dev libreadline-dev
These dependencies are optional and will be bundled if the
USE_BUNDLED_LIBRARIES CMake argument is set or your system does NOT have their development packages installed:
These libraries will be bundled regardless of your system:
in the toggldesktop source tree root
mkdir -p build && pushd build # Create build directory cmake .. # Setup cmake configs make -j8 # Build the app. The number defines the count of parallel jobs (number of your CPU cores is a good value for that) ./src/ui/linux/TogglDesktop/TogglDesktop # Run the built app
Install Visual Studio 2019 with
.NET desktop development,
Desktop development with C++ and
Universal Windows Platform development components checked during installation. You can download free Visual Studio Community here.
Then open the solution file
src\ui\windows\TogglDesktop\TogglDesktop.sln and run it in
The solution is using OpenSSL binaries. To rebuild OpenSSL from sources refer to this page.
Change log can be viewed at http://toggl.github.io/toggldesktop/
Before sending us a pull request, please format the source code:
$ make fmt
Also, please check for any cpplint issues:
$ make lint
Check if unit tests continue to pass:
$ make test