This project is superseded by another implementation.

I no longer use it myself and have developed a Toggl client from scratch in Rust as a replacement. If you feel interested, please give it a try! It's free and available at https://github.com/sterliakov/toggl (and also supports easier installation methods - binary download, npm and cargo!)

This is a fork of a discontinued Toggl app. The sole purpose of this repository is to keep it working under linux - apparently, upstream maintainers no longer care about us.

It may build or not build on other platforms. I'm using this on Ubuntu only, but any other distros are more than welcome - please open pull requests explaining build details on other distros. I'll try to review any test your suggestions promptly, and your recipes will be added to this README.

If you feel interested in testing or fixing builds on platforms other than linux - contributions are welcome. Please be aware that I won't be able to test Windows or MacOS builds, so the recipes will likely either stay in issues/PRs or be incorporated with "not tested, not my responsibility" disclaimer and showing your attribution.

I won't claim that this is the only/the best way to build. This is what works for me.

System libraries (this list may be non-exhaustive, but is enough to build in ubuntu:22.04 image):

apt-get update
apt-get install -y --no-install-recommends \
    git build-essential cmake libpoco-dev \
    libjsoncpp-dev libxmu-headers libssl-dev libxss-dev \
    qtbase5-private-dev libqt5x11extras5-dev libqt5networkauth5-dev qtbase5-dev

Build:

set -euo pipefail
git clone https://github.com/sterliakov/toggldesktop --depth 1
cd toggldesktop
mkdir -p build && cd build
cmake -DTOGGL_PRODUCTION_BUILD=ON -DUSE_BUNDLED_LIBRARIES=OFF ..
make -j8  # Adjust process limit to your system
# Run the executable
./src/ui/linux/TogglDesktop/TogglDesktop

Now copy the binary to whatever directory you like on PATH, and you're good to go! E.g.

cp ./src/ui/linux/TogglDesktop/TogglDesktop ~/.local/bin/toggl

• 🍏 MacOS Toggl Track
• 🖥 Windows Toggl Track

About • Download • Build • Change log • Contribute

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

• macOS 11+, Xcode 12.2+ and Swift 5+
• Install Bundler

$ sudo gem install bundler

# Prepare cocoapod
$ make init_cocoapods

Run bundle exec pod repo update in case there is an error about out-of-date source repos (some pod version is missing).

• Open workspace at src/ui/osx/TogglDesktop.xcworkspace
• Select TogglDesktop scheme and build.

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:

• libXScrnSaver (libxss-dev in deb-based distros and libXScrnSaver-devel in rpm-based)

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:

• POCO
• Lua
• jsoncpp
• Qxt

These libraries will be bundled regardless of your system:

• bugsnag-qt
• qt-oauth-lib

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

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