sskras / timewarrior

Timewarrior - Commandline Time Tracking and Reporting

Home Page:

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Tests Release Release date Commits since release


OS-X downloads Github downloads Linux downloads

Thank you for taking a look at Timewarrior!

Timewarrior is a time tracking utility that offers simple stopwatch features as well as sophisticated calendar-based backfill, along with flexible reporting. It is a portable, well supported and very active Open Source project.


Arch Debian Fedora Homebrew Ubuntu

From Package

Thanks to the community, there are binary packages available here.

Building Timewarrior

Building Timewarrior yourself requires

  • git
  • cmake
  • make
  • C++ compiler with full C++14 support, currently gcc 6.1+ or clang 3.4+
  • Python 3 (for running the testsuite)
  • Asciidoctor (for creating documentation)

There are two ways to retrieve the Timewarrior sources:

  • Clone the repository from Github,

    git clone --recurse-submodules
    cd timewarrior
  • Or download the tarball with curl,

    curl -O

    and expand the tarball

    tar xzf timew-1.4.3.tar.gz
    cd timew-1.4.3

Build Timewarrior, optionally run the test suite, and install it.

cmake -DCMAKE_BUILD_TYPE=release
[make test]
sudo make install

This copies files into the right place (default under /usr/local), and installs man pages.

Add the optional parameter -DCMAKE_INSTALL_PREFIX=/path/to/your/install/location to the cmake command if you want to install Timewarrior at a location other than /usr/local. The make install command may not require sudo depending on your choice of install location.


There is extensive online documentation. You'll find all the details at

There you will find the documentation, downloads, news and more.


Twitter Reddit Discord Github discussions

Timewarrior has a lively community on many places on the internet. The project has its own Twitter account, and shares community spaces on IRC and Discord with Taskwarrior.

Best place to ask questions is our discussions forum on Github. For other support options, take a look at


Contributors Milestone progress Good first issus

Your contributions are especially welcome. Whether it comes in the form of code patches, ideas, discussion, bug reports, encouragement or criticism, your input is needed.

For support options, take a look at or visit

Visit Github and participate in the future of Timewarrior.


Timewarrior is released under the MIT license. For details check the LICENSE file.

ezoic increase your site revenue


Timewarrior - Commandline Time Tracking and Reporting

License:MIT License


Language:C++ 60.9%Language:Python 35.1%Language:Shell 2.2%Language:CMake 1.3%Language:C 0.4%