GothenburgBitFactory/timewarrior
1
0
Fork 0
mirror of https://github.com/GothenburgBitFactory/timewarrior.git synced 2025-06-26 10:54:28 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
Timewarrior - Commandline Time Tracking and Reporting timewarrior.net https://timewarrior.net
2920 commits 7 branches 16 tags 5.8 MiB
Find a file
Shaun Ruffell d92ce2110f test: The tests depend on the documentation. 
The help.t test wants to verify that some of the man pages exist.
Therefore we need to make sure the documentation is built, otherwise:

  $ git clean -ffdx .
  $ cmake -DCMAKE_BUILD_TYPE=Debug .
  $ make test

Will fail some of the help.t tests.

Signed-off-by: Shaun Ruffell <sruffell@sruffell.net>
2021-04-10 22:52:04 +02:00
.github/workflows Replace Travis CI with Github Workflow 2021-02-09 22:16:42 +01:00
cmake Replace roff man pages with asciidoctor 2021-02-21 20:58:30 +01:00
completion doc: Update copyright to 2021 2021-01-02 02:52:39 -05:00
doc Replace roff man pages with asciidoctor 2021-02-21 20:58:30 +01:00
ext Increase minimal CMake version 2021-02-12 10:50:39 +01:00
src Replace roff man pages with asciidoctor 2021-02-21 20:58:30 +01:00
test test: The tests depend on the documentation. 2021-04-10 22:52:04 +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
AUTHORS Update AUTHORS, ChangeLog 2020-08-29 11:00:07 +02:00
ChangeLog Fix test summary.t for single-digit weeks 2021-01-25 13:49:56 +01:00
cmake.h.in TI-91: Fix compilation on DragonFly 2017-12-10 00:11:38 -05:00
CMakeLists.txt Replace roff man pages with asciidoctor 2021-02-21 20:58:30 +01:00
commit.h.in Framework: Added program framework and UTF8 code 2015-12-10 09:31:48 -05:00
CONTRIBUTING.md Update docs links from taskwarrior.org to timewarrior.net 2020-06-14 15:12:57 +02:00
DCO Add Developer Certificate of Origin (DCO) 2020-02-23 19:03:54 +01:00
docker-compose.yml Remove Gentoo from test zoo 2021-02-07 17:16:26 +01:00
INSTALL set consistent minimum versions for gcc and clang 2020-04-13 18:36:22 +02:00
LICENSE Move license URL up, so Github detects the license type correctly 2021-01-22 17:53:03 +01:00
README.md Replace Travis CI badge with Github Actions badge 2021-02-28 21:13:53 +01:00

README.md

Timewarrior

tests

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.

Installing

From Package

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

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,

    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.4.2/timew-1.4.2.tar.gz

    and expand the tarball

    tar xzf timew-1.4.2.tar.gz
cd timew-1.4.2

Build Timewarrior, optionally run the test suite (note: the tarball does not contain tests), 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.

Documentation

There is extensive online documentation. You'll find all the details at 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 or visit taskwarrior.org.

Visit Github and participate in the future of Timewarrior.

License

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