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
2408 commits 7 branches 16 tags 5.8 MiB
Find a file
Thomas Lauf 37a3aa0ccf Rework markdown 
- One line per sentence
- Use '#' instead of underline to mark headings
- Consistent indentation
2018-12-21 12:48:22 +01:00
cmake Docs: Updated URLs 2018-02-08 21:48:46 -05:00
doc Rework markdown 2018-12-21 12:48:22 +01:00
ext Rework markdown 2018-12-21 12:48:22 +01:00
src Update AUTHORS, ChangeLog 2018-12-06 21:08:30 +01:00
test Add TagInfoDatabase.t to .gitignore 2018-12-07 14:02:03 +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
AUTHORS Update AUTHORS, ChangeLog 2018-12-06 21:08:30 +01:00
ChangeLog Update AUTHORS, ChangeLog 2018-12-06 21:08:30 +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
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.