logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

w2do - a simple text-based todo manager

Author

       Written by Jaromir Hradilek <jhradilek@gmail.com>.

       Permission  is  granted  to  copy, distribute and/or modify this document under the terms of the GNU Free
       Documentation License, Version 1.3 or any later version published by the Free Software  Foundation;  with
       no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

       A copy of the license is included as a file called FDL in the main directory of the w2do source package.

Bugs

       To  report  bugs  or  even  send  patches,  you  can  either  add  new issue to the project bugtracker at
       <http://code.google.com/p/w2do/issues/>,        visit        the        discussion        group        at
       <http://groups.google.com/group/w2do/>, or you can contact the author directly via e-mail.

Description

w2do is a simple to use yet efficient command-line todo manager written in Perl.

Environment

W2DO_SAVEFILE
           Use selected file instead of the default "~/.w2do" as a save file.

       W2DO_WIDTH
           Use selected line width; the minimal value is 75.

Files

~/.w2do
           Default save file.

       ~/.w2do.bak
           Default backup file.

Name

       w2do - a simple text-based todo manager

Options

GeneralOptions-l, --list
           Display  items  in  the  task list. All tasks are listed by default, but desired subset can be easily
           selected via specifying options as well. Since listing is the default  action,  this  option  can  be
           safely omitted.

       -atask, --addtask
           Add  new  item  with  selected  task name to the task list. When no additional specifying options are
           given, the group general, the due date anytime and the priority 3 is used by default and the task  is
           marked as unfinished.

       -cid, --changeid
           Change  item  with  selected id in the task list. Further specifying options are required in order to
           take any effect.

       -rid, --removeid
           Remove item with selected id from the task list.

       --change-groupgroup
           Change all items in the selected group. Further specifying options are required in order to take  any
           effect.

       --remove-groupgroup
           Remove all items from the selected group.

       --purge-groupgroup
           Remove all finished items from the selected group.

       --change-datedate
           Change all items with selected due date. Further specifying options are required in order to take any
           effect.

       --remove-datedate
           Remove all items with selected due date.

       --purge-datedate
           Remove all finished items with selected due date.

       --change-pripriority
           Change all items with selected priority. Further specifying options are required in order to take any
           effect.

       --remove-pripriority
           Remove all items with selected priority.

       --purge-pripriority
           Remove all finished items with selected priority.

       --change-old
           Change  all  items with passed due date. Further specifying options are required in order to take any
           effect.

       --remove-old
           Remove all items with passed due date.

       --purge-old
           Remove all finished items with passed due date.

       --change-all
           Change all items in the task list. Further specifying options are  required  in  order  to  take  any
           effect.

       --remove-all
           Remove all items from the task list.

       --purge-all
           Remove all finished items from the task list.

       --undo
           Revert  last  action. When invoked, the data are restored from the backup file (i.e. "~/.w2do.bak" by
           default), which is deleted at the same time.

       --groups
           Display comma-delimited list of all groups in the task list.

       --stats
           Display detailed task list statistics.

       -h, --help
           Display help message and exit.

       -v, --version
           Display version information and exit.

   SpecifyingOptions-ttask, --tasktask
           Specify the task name.

       -ggroup, --groupgroup
           Specify the group name. The group name should be a single word with maximum  of  10  characters,  but
           longer names are shortened automatically.

       -ddate, --datedate
           Specify  the  due date. Available options are anytime, today, yesterday, tomorrow, month, year, or an
           exact date in the YYYY-MM-DD format, e.g. 2008-06-17 for 17 June 2008.

       -ppriority, --prioritypriority
           Specify the priority. Available options are integers between 1 and 5, where 1 represents the  highest
           priority.

       -f, --finished
           Specify the finished task.

       -u, --unfinished
           Specify the unfinished task.

   AdditionalOptions-sfile, --savefilefile
           Use selected file instead of the default "~/.w2do" as a save file.

       -wwidth, --widthwidth
           Use selected line width; the minimal value is 75.

       -q, --quiet
           Avoid displaying messages that are not necessary.

       -V, --verbose
           Display all messages; this is the default option.

       -C, --colour, --color
           Use coloured output instead of the default plain text version.

       -X, --no-colour, --no-color
           Use plain text output (no colours); this is the default option.

       -b, --bare
           Do not display table header and group separators.

       -B, --no-bare
           Display table header and group separators; the default option.

       -I, --no-id
           Do not display ID column in the listing.

       --with-id
           Display ID column in the listing; the default option.

       -G, --no-group
           Do not display group column in the listing.

       --with-group
           Display group column in the listing; the default option.

       -D, --no-date
           Do not display due date column in the listing.

       --with-date
           Display due date column in the listing; the default option.

       -P, --no-priority
           Do not display priority column in the listing.

       --with-priority
           Display priority column in the listing; the default option.

       -S, --no-state
           Do not display state column in the listing.

       --with-state
           Display state column in the listing; the default option.

See Also

w2html(1), w2text(1), perl(1).

Synopsis

w2do [-l] [-ttask] [-ggroup] [-ddate] [-ppriority] [-f|-u]

       w2do-atask [-ggroup] [-ddate] [-ppriority] [-f|-u]

       w2do-cid [-ttask] [-ggroup] [-ddate] [-ppriority] [-f|-u]

       w2do-ridw2do [options]

See Also