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¶

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