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