You can install Timewarrior either via packages or manually by building the release tarball.

If you are a developer, you might be interested in how to install the development snapshot.

Distributions

The Gothenburg Bit Factory does not maintain any packages, but thanks to the community, there are binary packages available:

DistributionCommandAvailable since
Arch Linuxsudo pacman -S timew-
Debiansudo apt-get install timewarriorStretch
Gentooemerge app-misc/timew-
Fedorasudo dnf install timewFedora 26
macOSbrew install timewarriorEl Capitan
Nixnix-env --install timewarrior-

Note that packages are the responsibility of the respective maintainers. Please contact them in case of outdated or missing packages.

Manual installation

If there is no package available for your distribution, you can build and install Timewarrior easily yourself.

Prerequisites

To build Timewarrior from the tarball you will need these tools:

  • cmake
  • make
  • C++ compiler with full C++14 support, currently gcc 6.1+ or clang 3.4+
  • Python 3 (optional, only required for running the test suite)
  • Asciidoctor (optional, only required for re-building man pages)

Download

The release tarballs are hosted on github. You can download the tarball with curl, as an example of just one of many ways to download the tarball.

$ curl -L -O https://github.com/GothenburgBitFactory/timewarrior/releases/download/v1.4.3/timew-1.4.3.tar.gz

Build & Install

Expand the tarball, build Timewarrior, and install it. This copies files into the right place, and installs man pages.

$ tar xzf timew-1.4.3.tar.gz
$ cd timew-1.4.3
$ cmake -DCMAKE_BUILD_TYPE=Release .
...
$ make
...
$ sudo make install

Timewarrior is now ready to use. For your first steps your might want to read the tutorial or try the help command.