Table of Contents
- Build instructions
- Change log
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/toggldesktop/wiki/Building-Toggl-Desktop-from-source-for-usage-with-live-servers
Build using Makefile
First, build dependencies:
then the app itself:
To build, then run the app:
Run unit tests with
and UI tests with
You'll need QT to be at least version 5.5
If qmake is not on your PATH, set this first, before running make:
Below are some distribution specific package requirements:
Install dev tools
We're building the Windows app using Visual Studio Community 2013 - it's a free download
You'll need to install ActivePerl to build OpenSSL from source.
If you plan to run tests then you might want to install Cygwin.
Use pre-built OpenSSL binaries (recommended)
Clone OpenSSL distribution provided by Poco project under the poco directory
cd %POCO_BASE% git clone https://github.com/pocoproject/openssl
build OpenSSL, from Visual Studio Tools, open up a Developer Command Prompt.
cd to the project folder, then
cd third_party\openssl perl Configure VC-WIN32 ms\do_nasm nmake -f ms\ntdll.mak clean nmake -f ms\ntdll.mak
Instead of do_nasm (use NASM) you can also use do_ms (no asm at all), or do_masm (use MASM). NASM can be downloaded here: http://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D
Build the app
Now, select Release from the Solution Configurations combobox in the Visual Studio toolbar, and build the solution.
If you have Cygwin installed, you can also build the app from from Cygwin terminal, using make. (See macOS and Linux build instructions on above regarding make).
Toggl built and signed app for macOS is available for download. You need at least macOS 10.8.
Toggl built and signed app for Windows is available for download. App has been tested on Windows 7, 8, 8.1 and 10.
Toggl Desktop Windows app has not been tested on Surface type touchscreen environments.
Linux (64 bit only)
Change log can be viewed at http://toggl.github.io/toggldesktop/
The documentation of the code base is currently work in progress and can be found at /docs/.
Before sending us a pull request, please format the source code:
Also, please check for any cpplint issues:
Check if unit tests continue to pass: