Timewarrior - Commandline Time Tracking and Reporting timewarrior.net https://timewarrior.net
Find a file
dependabot[bot] d43e962c6c
Some checks failed
tests / tests (alpine-edge, Alpine Edge, ubuntu-latest) (push) Has been cancelled
tests / tests (alpine-latest, Alpine Latest, ubuntu-latest) (push) Has been cancelled
tests / tests (archlinux, Archlinux Base, ubuntu-latest) (push) Has been cancelled
tests / tests (centos-stream9, Centos Stream9, ubuntu-latest) (push) Has been cancelled
tests / tests (debianstable, Debian Stable, ubuntu-latest) (push) Has been cancelled
tests / tests (debiantesting, Debian Testing, ubuntu-latest) (push) Has been cancelled
tests / tests (fedora41, Fedora 41, ubuntu-latest) (push) Has been cancelled
tests / tests (fedora42, Fedora 42, ubuntu-latest) (push) Has been cancelled
tests / tests (opensuseleap, OpenSUSE Leap, ubuntu-latest) (push) Has been cancelled
tests / tests (opensusetumbleweed, OpenSUSE Tumbleweed, ubuntu-latest) (push) Has been cancelled
tests / tests (osx-13, macOS 13, macos-13) (push) Has been cancelled
tests / tests (osx-14, macOS 14, macos-14) (push) Has been cancelled
tests / tests (osx-15, macOS 15, macos-15) (push) Has been cancelled
tests / tests (ubuntu2204, Ubuntu 22.04, ubuntu-latest) (push) Has been cancelled
tests / tests (ubuntu2204, Ubuntu 24.04, ubuntu-latest) (push) Has been cancelled
Bump sigstore/cosign-installer from 3.8.2 to 3.9.1
Bumps [sigstore/cosign-installer](https://github.com/sigstore/cosign-installer) from 3.8.2 to 3.9.1.
- [Release notes](https://github.com/sigstore/cosign-installer/releases)
- [Commits](https://github.com/sigstore/cosign-installer/compare/v3.8.2...v3.9.1)

---
updated-dependencies:
- dependency-name: sigstore/cosign-installer
  dependency-version: 3.9.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2025-06-24 18:16:18 +02:00
.github Bump sigstore/cosign-installer from 3.8.2 to 3.9.1 2025-06-24 18:16:18 +02:00
cmake Update project to C++17 2023-06-17 08:41:07 +02:00
completion Adding zsh completion 2024-06-17 23:04:52 +02:00
doc Add id filtering to reports 2025-05-30 22:51:01 +02:00
docker Add workflow for Timewarrior Docker image 2023-01-05 23:20:00 +01:00
ext Set CMake minimum version to 3.10 2025-02-05 22:42:14 +01:00
src Make display of ids and annotations the default in summary report for new users 2025-06-01 23:39:53 +02:00
test Make display of ids and annotations the default in summary report for new users 2025-06-01 23:39:53 +02:00
.gitignore Clean up .gitignore files 2019-04-10 12:08:42 +02:00
.gitmodules Changed URL for libshared 2018-02-18 11:16:38 +01:00
.pre-commit-config.yaml Add empty '.pre-commit-config.yaml' 2024-08-17 10:33:25 +02:00
AUTHORS Release 1.8.0 2025-04-20 19:57:23 +02:00
ChangeLog Make display of ids and annotations the default in summary report for new users 2025-06-01 23:39:53 +02:00
cmake.h.in Remove reference to 'TIMEW_RCDIR' 2023-06-17 14:19:02 +02:00
CMakeLists.txt Enter commit hash for release 1.8.0 2025-04-20 21:38:42 +02:00
commit.h.in Framework: Added program framework and UTF8 code 2015-12-10 09:31:48 -05:00
CONTRIBUTING.md Fix grammar and spelling 2023-06-17 14:19:02 +02:00
DCO Fix spelling 2023-01-07 18:58:42 +01:00
docker-compose.yml Update test zoo docker images 2025-05-31 21:43:31 +02:00
INSTALL Improve configurability of CMake install directories 2023-08-11 15:30:26 +02:00
LICENSE Update copyrights 2023-04-04 22:44:44 +02:00
README.md Update download link for package downloads 2025-06-09 22:21:53 +02:00

Timewarrior logo

Tests Release Release date Commits since release
Twitter

Timewarrior

macOS 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.

Please visit timewarrior.net for extensive documentation, downloads, news and more.

Installing

Arch Linux Debian Fedora Homebrew Ubuntu

From Package

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

Building Timewarrior

Building Timewarrior yourself requires

  • Git
  • CMake (>= 3.8)
  • Make
  • C++ compiler with full C++17 support, currently GCC 8+ or Clang 5+
  • Python 3 (for running the testsuite)
  • Asciidoctor (for creating documentation)

There are two ways to retrieve the Timewarrior sources:

  • Clone the repository from GitHub and update required submodules,
    git clone --recurse-submodules https://github.com/GothenburgBitFactory/timewarrior
    cd timewarrior
    
  • Or download the tarball with curl,
    curl -O https://github.com/GothenburgBitFactory/timewarrior/releases/download/v1.8.0/timew-1.8.0.tar.gz
    
    and expand the tarball
    tar xzf timew-1.8.0.tar.gz
    cd timew-1.8.0
    

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

cmake -DCMAKE_BUILD_TYPE=release .
make
[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.

Community

Twitter Reddit Libera.chat 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 timewarrior.net/support

Contributing

Contributors Milestone progress Good first issues

Contributions are greatly appreciated. Whether in the form of code patches, ideas, discussion, bug reports, encouragement or criticism, we need you!

For support options, take a look at CONTRIBUTING.md or visit timewarrior.net.

Visit GitHub and participate in the future of Timewarrior.

License

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