76 lines
2 KiB
Markdown
76 lines
2 KiB
Markdown
# todo.txt-graph
|
||
|
||
*A visualization-plugin for [todo.txt](http://todotxt.com/) – a command line todo application.*
|
||
|
||
|
||
|
||
**todo.txt-graph** displays bar charts showing the number of completed tasks per day.
|
||
|
||
As in Jerry Seinfeld’s [don’t break the chain](http://dontbreakthechain.com/what) technique, active days will be colored green and therefore motivate you do be more productive.
|
||
|
||
## Installation
|
||
|
||
`cd` into your plugins folder (see [Installing Addons](https://github.com/ginatrapani/todo.txt-cli/wiki/Creating-and-Installing-Add-ons)), e.g.:
|
||
|
||
```
|
||
cd ~/.todo.actions.d
|
||
```
|
||
|
||
Then clone this repository into the folder *graph*:
|
||
|
||
```
|
||
git clone https://github.com/timpulver/todo.txt-graph.git graph
|
||
```
|
||
|
||
The directory structure should look like this now:
|
||
|
||
```
|
||
~/.todo.actions.d/
|
||
graph/
|
||
graph
|
||
graph.py
|
||
```
|
||
|
||
## Usage
|
||
|
||
Visualize last 7 days:
|
||
|
||
```
|
||
todo.sh graph
|
||
```
|
||
|
||
Visualize last 123 days:
|
||
|
||
```
|
||
todo.sh graph 123
|
||
```
|
||
|
||
## Threshold
|
||
|
||
By default, days with less than 5 completed tasks will be considered inactive (and therefore colored grey). You can change the threshold by adding an entry to your config file (`~/.todo/config`):
|
||
|
||
```
|
||
# Threshold for Graph Addon
|
||
export TODOTXT_GRAPH_THRESHOLD=10
|
||
```
|
||
|
||
In the todo.txt wiki you can find further information on the config file: [config troubleshooting](https://github.com/todotxt/todo.txt-cli/wiki/Troubleshooting)
|
||
|
||
## Compatibility
|
||
|
||
Tested with *todo.txt* 2.11.0 on macOS 10.14.2
|
||
|
||
## Contributors
|
||
|
||
- [Bassmann](https://github.com/Bassmann)
|
||
- [timpulver](https://github.com/timpulver)
|
||
- [ninjapanzer](https://github.com/ninjapanzer)
|
||
- [gabrielsimoes](https://github.com/gabrielsimoes)
|
||
- [nareike](https://github.com/nareike)
|
||
- [jucor](https://github.com/jucor)
|
||
- [andycyca](https://github.com/andycyca)
|
||
|
||
Code used from:
|
||
|
||
- [termgraph](https://github.com/mkaz/termgraph/blob/master/termgraph.py)
|
||
- [lately](https://github.com/emilerl/emilerl/)
|