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
2510 commits 7 branches 16 tags 5.8 MiB
Find a file
Thomas Lauf 94ac7bd58a Extract documentation aboug hints into separate man page 
Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
2019-02-15 14:07:03 +01:00
cmake Docs: Updated URLs 2018-02-08 21:48:46 -05:00
doc Extract documentation aboug hints into separate man page 2019-02-15 14:07:03 +01:00
ext Rework markdown 2018-12-21 12:48:22 +01:00
src Remove line breaks 2019-02-15 10:09:41 +01:00
test Fix tests 2019-02-15 10:16:12 +01:00
.gitignore Add *.pyc files to .gitignore 2018-08-08 21:15:15 +02:00
.gitmodules Changed URL for libshared 2018-02-18 11:16:38 +01:00
.travis.yml Fix container for fedora 29 2019-01-07 21:31:46 +01:00
AUTHORS Update AUTHORS, ChangeLog 2018-12-06 21:08:30 +01:00
ChangeLog Update ChangeLog 2019-02-15 10:26:28 +01:00
cmake.h.in TI-91: Fix compilation on DragonFly 2017-12-10 00:11:38 -05:00
CMakeLists.txt Docs: Updated URLs 2018-02-08 21:48:46 -05:00
commit.h.in Framework: Added program framework and UTF8 code 2015-12-10 09:31:48 -05:00
CONTRIBUTING.md Rework CONTRIBUTING instructions 2018-02-22 23:38:20 +01:00
COPYING Use https:// link for opensource.org 2018-03-16 23:11:08 +01:00
docker-compose.yml tests: Implement Travis-based Multi-OS CI service 2019-01-06 21:03:43 +01:00
INSTALL Rework markdown 2018-12-21 12:48:22 +01:00
LICENSE Update Authors 2018-12-17 19:57:19 +01:00
NEWS Rework markdown 2018-12-21 12:48:22 +01:00
README.md Add instructions for customized install location 2018-05-19 11:48:56 +02:00

README.md

Timewarrior

Thank you for taking a look at Timewarrior!

Timewarrior is a time tracking utility that offers simple stopwatch features as well as sophisticated calendar-base 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.7+ or clang 3.3+ for full C++11 support
  • Python, 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://taskwarrior.org/download/timew-1.1.1.tar.gz

    and expand the tarball

    tar xzf timew-1.1.1.tar.gz
cd timew-1.1.1

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:

https://taskwarrior.org/docs/timewarrior

At the site you'll find online 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

https://taskwarrior.org/support

Visit Github and participate in the future of Timewarrior.

License

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