Manual section

1

Manual group

user

rdial

Minimal time tracking for maximal benefit

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, its duration and optionally a message… 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

rdial fsck

Check storage consistency.

rdial fsck [OPTIONS]

Options

-p, --progress, -q, --no-progress

Display progress bar.

rdial start

Start task.

rdial start [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

-c, --continue

Restart previous task.

-n, --new

Start a new task.

-t, --time <time>

Set start time.

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

rdial stop

Stop task.

rdial stop [OPTIONS]

Options

-F, --file <fname>

Read closing message from file.

-m, --message <message>

Closing message.

--amend

Amend previous stop entry.

rdial switch

Complete last task and start new one.

rdial switch [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

-n, --new

Start a new task.

-t, --time <time>

Set start time.

-F, --file <fname>

Read closing message from file.

-m, --message <message>

Closing message.

--amend

Amend previous stop entry.

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

rdial run

Run command with timer.

rdial run [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

-n, --new

Start a new task.

-t, --time <time>

Set start time.

-F, --file <fname>

Read closing message from file.

-m, --message <message>

Closing message.

-c, --command <command>

Command to run.

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

rdial wrapper

Run predefined command with timer.

rdial wrapper [OPTIONS] [WRAPPER]

Options

-t, --time <time>

Set start time.

-F, --file <fname>

Read closing message from file.

-m, --message <message>

Closing message.

Arguments

WRAPPER

Optional argument

rdial report

Report time tracking data.

rdial report [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

--stats

Display database statistics.

-d, --duration <duration>

Filter events for specified time period.

Options

day|week|month|year|all

-s, --sort <sort>

Field to sort by.

Options

task|time

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

Reverse sort order.

--style <style>

Table output style.

Options

simple|plain|grid|fancy_grid|github|pipe|orgtbl|jira|presto|psql|rst|mediawiki|moinmoin|youtrack|html|latex|latex_raw|latex_booktabs|tsv|textile

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

RDIAL_SORT

Provide a default for -s

RDIAL_REVERSE

Provide a default for -r

rdial running

Display running task, if any.

rdial running [OPTIONS]

rdial last

Display last event, if any.

rdial last [OPTIONS]

rdial ledger

Generate ledger compatible data file.

rdial ledger [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

-d, --duration <duration>

Filter events for specified time period.

Options

day|week|month|year|all

-r, --rate <rate>

Hourly rate for task output.

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

RDIAL_RATE

Provide a default for -r

rdial timeclock

Generate ledger compatible timeclock file.

rdial timeclock [OPTIONS] [TASK]

Options

-x, --from-dir

Use directory name as task name.

-d, --duration <duration>

Filter events for specified time period.

Options

day|week|month|year|all

Arguments

TASK

Optional argument

Environment variables

RDIAL_TASK

Provide a default for TASK

BUGS

None known.

AUTHOR

Written by James Rowe

RESOURCES

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

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

COPYING

Copyright © 2011-2019 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/>.