# Timewarrior | Commandline Time Reporting

**URL:** <https://onehack.st/t/timewarrior-commandline-time-reporting/178889>\
**Category:** Tools & Scripts\
**Tags:** tools, windows\
**Created:** [April 15, 2021, 11:54pm UTC](https://onehack.st/t/timewarrior-commandline-time-reporting/178889 "2021-04-15T23:54:37Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Prometheus](https://onehack.st/user_avatar/onehack.st/prometheus/32/34950_2.png) [@Prometheus](https://onehack.st/u/Prometheus)\
**Post date:** [April 15, 2021, 11:54pm UTC](https://onehack.st/t/timewarrior-commandline-time-reporting/178889/1 "2021-04-15T23:54:37Z")

</div>

![image](https://onehack.st/uploads/default/original/3X/e/a/eaba270c56acea3669205c8cff7aba8a42e1bc69.png)

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.

**Installing**

**From Package**

Thanks to the community, there are binary packages available [here](https://timewarrior.net/docs/install.html#distributions).

**Building Timewarrior**

Building Timewarrior yourself requires

- git
- cmake
- make
- C++ compiler, currently gcc 4.8.1+ or clang 3.3+ for full C++11 support
- Python 3, for running the testsuite

There are two ways to retrieve the Timewarrior sources:

- Clone the repository from Github,

```auto
git clone --recurse-submodules https://github.com/GothenburgBitFactory/timewarriorcd timewarrior

```

- Or download the tarball with curl,

```auto
curl -O https://taskwarrior.org/download/timew-1.3.0.tar.gz

```

and expand the tarball

```auto
tar xzf timew-1.3.0.tar.gzcd timew-1.3.0

```

Build Timewarrior, optionally run the test suite (note: the tarball does not contain tests), and install it.

```auto
cmake -DCMAKE_BUILD_TYPE=releasemake[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.

**Documentation**

There is extensive online documentation. You’ll find all the details at [timewarrior.net/docs/](https://timewarrior.net/docs/).

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

**Contributing**

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 [CONTRIBUTING.md](https://github.com/GothenburgBitFactory/timewarrior/blob/dev/CONTRIBUTING.md) or visit [taskwarrior.org](https://taskwarrior.org/support).

Visit [Github](https://github.com/GothenburgBitFactory/timewarrior) and participate in the future of Timewarrior.

## GitHub:

> **[GitHub - GothenburgBitFactory/timewarrior: Timewarrior - Commandline Time Tracking and...](https://github.com/GothenburgBitFactory/timewarrior)**
>
> Timewarrior - Commandline Time Tracking and Reporting