How To Install Timewarrior

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.


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

Distribution Command Available since
Arch Linux sudo pacman -S timew -
Debian sudo apt-get install timewarrior Stretch
macOS brew install timewarrior El Capitan

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.


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

  • git
  • cmake
  • make
  • C++ compiler, currently gcc 4.7+ or clang 3.3+ for full C++11 support


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

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.2.tar.gz
$ cd timew-1.4.2
$ 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.