tudu

Langue: en

Version: May 2009 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

TuDu - Tool for control your to do lists.

SYNOPSIS

tudu [-f tudu_file] [-c config_file] [-v[v]] [-h]

DESCRIPTION

TuDu is a comand line interface for manage hierarchical todos. Every todo have title, description and deadline (optional). Also it shows the percent that you have done.

OPTIONS

-f tudu_file
load tudu file
-c config-file
load specific config file
-v
Display the TuDu version number.
-vv
Display license and copyright information.
-h
Display help.

INTERFACE

All the keybindings described here are the default in tudu, you can change them in the config file.
h
Move the cursor one level out in the tree depth.
l
Move the cursor one level in in the tree depth.
j
Move the cursor to the next task.
k
Move the cursor to the previous task.
J
Move a task one position down.
K
Move a task one position up.
m
Mark a task as done.
dd
Delete one task.
dt
Remove the deadline of the task.
df
Remove the priority of the task.
dS
Remove the schedule of the task.
p
Paste the previous deleted task.
P
Paste the previous deleted task upper than the cursor.
V
Paste the previous deleted task as a child.
o
Add new task.
O
Add new task upper than the cursor.
a
Edit the title of the task.
t
Edit the deadline.
f
Set the priority of the task.
C
Add or modify the category of the task.
e
Edit the text of the task.
x
Scroll the text window up.
z
Scroll the text window down.
S
Edit the schedule of the task.
X
Scroll the schedule window up.
Z
Scroll the schedule window down.
c
Collapse or expand the children of the task.
M
Hide or show done tasks.
/
Search for a pattern in tasks titles.
n
Search the next ocurrence of last search.
N
Search the previous ocurrence of the last searche tasks.
/
Search for a pattern in tasks titles.
n
Search the next ocurrence of last search.
N
Search the previous ocurrence of the last search.
:
Open the command input. See the COMMANDS section.
bt
Sort by title.
bT
Sort by title in reverse direction.
bd
Sort by done.
bD
Sort by done in reverse direction.
bl
Sort by deadline.
bL
Sort by deadline in reverse direction.
bp
Sort by priority.
bP
Sort by priority in reverse direction.
bc
Sort by category.
bC
Sort by category in reverse direction.
bu
Sort by user.
bU
Sort by user in reverse direction.
bd
Sort by done.
bD
Sort by done in reverse direction.
bl
Sort by deadline.
bL
Sort by deadline in reverse direction.
bp
Sort by priority.
bP
Sort by priority in reverse direction.
bc
Sort by category.
bC
Sort by category in reverse direction.
bu
Sort by user.
bU
Sort by user in reverse direction.
s
Save all the editings.
?
Display the help.
q
Quit tudu saving the last editings.
Q
Quit tudu without save.

COMMANDS

hide category1 category2 ... categoryN
Hide one or more categories.
show category1 category2 ... categoryN
Display one or more categories.
showall
Display all the categories.
showonly category1 category2 ... categoryN
Hide all the categories except the ones given.

CONFIG

The config file have several sections started with the name between brackets, like [ general ]. Can be included other config files with the option:
@include = 'path'

The options of each section are:

general

collapse = yes|no
Collapse the tasks by default.
hide_done = yes|no
Hide or not the done tasks.
visual_tree = yes|no
Toggle graphical tree. It shows marks, like (+) at the left of the tasks. It is necesary in shome shells that can not display bold characters.
days_warn = number
Days before the deadline that the warn should be display.
sort_order = string
Sort the todo by the string order. Each character on the string means an order, when two tasks are equal in the first letter it is sort by the second an so on. The letters mean:
t
title
T
reverse title
d
done
D
reverse done
l
deadline
L
reverse deadline
c
category
C
reverse category
e
percent done
E
reverse percent done
u
user order
U
reverse user order
editor = 'path_bin %s'

keys

This section defines any keybinding on the program. See the example in the default config file.

theme

Window positions are described by rows each row with the sintax:
row = [height]([width|]window[, [width|]window, ...])
The height and width can be the number of characters or a precentage followed by %. The possible windows are: help, tree, info, blank, text and schedule. The windows help and info don't need to have height, because is predefined as 1. TuDu will try to gess the non given information.

Other options for the theme are:

columns = colm1,...,colmN
Columns in tree window. The posible columns are: title, priority, category and deadline.
color = color_text, color_background
The default colors for the text and background. The colors can be defined as (r, g, b), with numbers from 0 to 1000, or with the words: black, red, green, yellow, blue, magenta, cyan, white, transparent.
window = color_text, color_background
For each window can be defined it's own colors.
selected = color_text, color_background
Color for the items under the cursor.
deadlineMark = color_text, color_background
Color for the mark of deadline soon.

FILES

~/.tudurc
User configuration file.
~/.tudu.xml
User default tudu.

NO WARRANTIES

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

TuDu Home Page: http://www.cauterized.net/~meskio/tudu/

AUTHOR

Ruben Pollan <meskio@sindominio.net>