rdial

Simple time tracking for simple people

SYNOPSIS

rdial [option]… <command>

DESCRIPTION

rdial is a simple way to track the time you spend on tasks. It tracks the name of a task, its start time and its duration… nothing more.

OPTIONS

--version

Show the version and exit.

-d <directory>, --directory=<directory>

Database location, defaults to ${XDG_DATA_HOME:-~/.local/share}/rdial.

--backup, --no-backup

Write data file backups.

--cache, --no-cache

Do not write cache files.

--config <file>

File to read configuration data from, defaults to ${XDG_CONFIG_HOME:-~/.config}/rdial/config.

-i, --interactive, --no-interactive

Support interactive message editing.

--colour, --no-colour

Output colourised informational text.

--help

Show help message and exit.

COMMANDS

fsck

Check storage consistency

--help

Show help message and exit.

start

Start task

-x, --from-dir

Use directory name as task name.

-c, --continue

Restart previous task.

-n, --new

Start a new task.

-t <time>, --time <time>

Manually set start time for task.

--help

Show help message and exit.

stop

Stop task

-F <file>, --file <file>

Read closing message from file.

-m <message>, --message=<message>

Closing message.

--amend

Amend previous stop entry.

--help

Show help message and exit.

switch

Switch to another task

-x, --from-dir

Use directory name as task name.

-n, --new

Start a new task.

-t <time>, --time <time>

Manually set start time for task.

-F <file>, --file <file>

Read closing message for current task from file.

-m <message>, --message <message>

Closing message for current task.

--help

Show help message and exit.

run

Run command with timer

-x, --from-dir

Use directory name as task name.

-n, --new

Start a new task.

-t <time>, --time <time>

Manually set start time for task.

-F <file>, --file <file>

Read closing message for current task from file.

-m <message>, --message <message>

Closing message for current task.

-c <command>, --command <command>

Command to run.

--help

Show help message and exit.

wrapper

Run predefined command with timer

-t <time>, --time <time>

Manually set start time for task.

-F <file>, --file <file>

Read closing message for current task from file.

-m <message>, --message <message>

Closing message for current task.

--help

Show help message and exit.

report

Report time tracking data

-x, --from-dir

Use directory name as task name.

--stats

Display database statistics.

-d <duration>, --duration=<duration>

Filter events for specified time period {day,week,month,year,all}.

-s <order>, --sort=<order>

Field to sort by {task,time}.

-r, --reverse, --no-reverse

Reverse sort order.

--style

Table output style {fancy_grid,grid,html,latex,latex_booktabs,mediawiki,orgtbl,pipe,plain,psql,rst,simple,tsv}

See the tabulate documentation for descriptions of the supported formats for your installation.

--help

Show help message and exit.

running

Display running task, if any

--help

Show help message and exit.

last

Display last task, if any

--help

Show help message and exit.

ledger

Generate ledger compatible data file

-x, --from-dir

Use directory name as task name.

-d <duration>, --duration=<duration>

Filter events for specified time period {day,week,month,year,all}.

-r <rate>, --rate <rate>

Hourly rate for task output.

--help

Show help message and exit.

BUGS

None known.

AUTHOR

Written by James Rowe

RESOURCES

Full documentation: http://rdial.readthedocs.io/

Issue tracker: https://github.com/JNRowe/rdial/issues/

COPYING

Copyright © 2011-2017 James Rowe.

rdial is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

rdial 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.

You should have received a copy of the GNU General Public License along with rdial. If not, see <http://www.gnu.org/licenses/>.