Usage

The rdial script is the main workhorse of rdial.

See Getting started for basic usage examples.

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.

--help

Show help message and exit.

Commands

fsck - Check storage consistency

rdial fsck [--help]
--help

Show help message and exit.

start - Start task

rdial start [--help] [-x] [-n] [-t time] <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.

--help

Show help message and exit.

stop - Stop task

rdial stop [--help] [-m <message>] [--amend]
-m <message>, --message=<message>

Closing message.

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

Read closing message from file.

--amend

Amend previous stop entry.

--help

Show help message and exit.

switch - Switch to another task

rdial switch [--help] [-x] [-n] [-m <message>] [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.

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

Closing message for current task.

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

Read closing message for current task from file.

--help

Show help message and exit.

run - Run command with timer

rdial run [--help] [-x] [-n] [-t time] [-m message] [-F file] [-c command] <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.

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

Closing message for current task.

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

Read closing message for current task from file.

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

Command to run.

--help

Show help message and exit.

wrapper - Run predefined command with timer

rdial wrapper [--help] [-t time] [-m message] [-F file] <wrapper>

See run wrappers configuration.

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

Manually set start time for task.

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

Closing message for current task.

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

Read closing message for current task from file.

--help

Show help message and exit.

report - Report time tracking data

rdial report [--help] [-d <duration>] [-s <order] [-r] [--style] [--stats] <task>
-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

Reverse sort order.

--style

Table output style {grid,latex,mediawiki,orgtbl,pipe,plain,rst,simple,tsv}

--stats

Display database statistics.

-x, --from-dir

Use directory name as task name.

--help

Show help message and exit.

running - Display running task, if any

rdial running [--help]
--help

Show help message and exit.

last - Display last task, if any

rdial last [--help]
--help

Show help message and exit.

ledger - Generate ledger compatible data file

rdial ledger [--help] [-d <duration>] [-r RATE] [task]
-d <duration>, --duration=<duration>

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

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

Hourly rate for task output.

-x, --from-dir

Use directory name as task name.

--help

Show help message and exit.