Timewarrior - Commandline Time Tracking and Reporting timewarrior.net https://timewarrior.net
Find a file
Thomas Lauf bcc78a941f Update test zoo
- Unify test setup in Docker files
- Add Fedora 38 Docker image
- Add OpenSUSE Leap Docker image
- Add OpenSUSE Tumbleweed Docker image
- Drop Fedora 36 Docker image
- Drop OpenSUSE 15 Docker image

Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
2023-12-24 19:26:50 +01:00
.github Update test zoo 2023-12-24 19:26:50 +01:00
cmake Update project to C++17 2023-06-17 08:41:07 +02:00
completion Update bash completion 2023-10-13 15:59:14 +02:00
doc Update copyright ranges 2023-12-23 23:14:46 +01:00
docker Add workflow for Timewarrior Docker image 2023-01-05 23:20:00 +01:00
ext Update task-timewarrior-hook script to 87a3426d8153f92aaee2edf36b2de62e48c4de0e 2023-12-22 23:13:13 +01:00
src Fix range determination when filtering by ids 2023-12-24 18:28:20 +01:00
test Update test zoo 2023-12-24 19:26:50 +01: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
AUTHORS Filter summary based on ids 2023-12-23 22:38:31 +01:00
ChangeLog Filter summary based on ids 2023-12-23 22:38:31 +01: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.6.0 2023-09-18 13:19:37 +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 2023-12-24 19:26:50 +01: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 Use '```' to mark code blocks 2023-10-29 14:45:21 +01: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,
    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.6.0/timew-1.6.0.tar.gz
    
    and expand the tarball
    tar xzf timew-1.6.0.tar.gz
    cd timew-1.6.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 timewarior.net.

Visit GitHub and participate in the future of Timewarrior.

License

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