Timewarrior - Commandline Time Tracking and Reporting https://timewarrior.net
  • C++ 58.7%
  • Python 36.6%
  • Shell 2.5%
  • CMake 1.1%
  • Dockerfile 0.6%
  • Other 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
dependabot[bot] b2e36c3466 Bump github/codeql-action in the github-actions group
Bumps the github-actions group with 1 update: [github/codeql-action](https://github.com/github/codeql-action).


Updates `github/codeql-action` from 4.37.7 to 4.37.8
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/compare/v4.37.7...v4.37.8)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-version: 4.37.8
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: github-actions
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-29 16:00:12 +02:00
.github Bump github/codeql-action in the github-actions group 2026-08-29 16:00:12 +02:00
cmake Update project to C++17 2023-06-17 08:41:07 +02:00
completion Update Fish completion to 744acbb441f952e17594be82bbd1ac7896070178 2026-08-02 18:17:56 +02:00
doc Update man page of 'undo' command 2026-08-28 13:21:12 +02:00
docker Unminimize Timewarrior runner image 2025-08-09 14:15:31 +02:00
ext Update copyright ranges 2026-08-02 18:40:18 +02:00
src Bump src/libshared from df59fd6 to d899eba in the submodule group 2026-08-22 10:13:53 +02:00
test Update copyright ranges 2026-08-02 18:40:18 +02:00
.gitignore Add CMake files to .gitignore 2025-08-27 21:36:22 +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 Added test cases for non-ASCII text to "chart.t". Fixed minor (but sneaky) bug in "summary.t". 2026-07-24 08:58:57 +02:00
ChangeLog Enter commit hash for release 1.10.0 2026-08-02 20:21:12 +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.10.0 2026-08-02 20:21:12 +02:00
commit.h.in Framework: Added program framework and UTF8 code 2015-12-10 09:31:48 -05:00
CONTRIBUTING.md Fix git checkout example in CONTRIBUTING 2026-08-06 08:18:47 +02:00
DCO Fix spelling 2023-01-07 18:58:42 +01:00
docker-compose.yml Unify naming of Docker containers 2025-08-09 18:08:42 +02:00
INSTALL Improve configurability of CMake install directories 2023-08-11 15:30:26 +02:00
LICENSE Update license link 2025-08-27 21:36:22 +02:00
README.md Fix curl example in README 2026-08-06 08:32:09 +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

Packaging status 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 -L -O https://github.com/GothenburgBitFactory/timewarrior/releases/download/v1.10.0/timew-1.10.0.tar.gz
    
    and expand the tarball
    tar xzf timew-1.10.0.tar.gz
    cd timew-1.10.0
    

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

cmake -DCMAKE_BUILD_TYPE=release -S . -B _build
cmake --build _build -j
[cmake --build _build --target timew_test]
sudo cmake --install _build

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 cmake --install command may not require sudo depending on your choice of install location.

Community

X Reddit Libera.chat Discord GitHub discussions

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

Best place to ask questions is our Discord channel, or 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.