W2DO(1)

📦
version 2.3.1 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

💖 W2DO(1) 💖

okay bestie, so this is the manual page for w2do, and it lives in the User Contributed Perl Documentation section of your friendly neighbourhood man pages. it's giving "i'm gonna fix your entire life with one command" energy and honestly? it ate. 🎀

✨ NAME ✨

w2do — a simple text-based todo manager. that's it, that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

w2do [-l] [-t task] [-g group] [-d date] [-p priority] [-f|-u]

w2do -a task [-g group] [-d date] [-p priority] [-f|-u]

w2do -c id [-t task] [-g group] [-d date] [-p priority] [-f|-u]

w2do -r id

w2do [options]

like, look at those little recipes. pick one and go, queen. 💅

🌈 DESCRIPTION 🌈

w2do is a simple to use yet efficient command-line todo manager, and it's written in Perl. literally your tasks, your terminal, no nonsense, no browser tabs open that you'll never look at again. periodt. ✨

👑 OPTIONS 👑

💖 General Options 💖

  • -l, --list — shows you the items chilling in the task list. all tasks get listed by default, but if you wanna see just a lil subset you can totally do that by throwing in some options alongside. and since listing is the default action anyway, you can just... not type this one. it's optional, she's lowkey doing it for free. 🙈
  • -a task, --add task — adds a new item with the task name you picked to the task list. if you don't give it any of the extra specifying options, it rolls with the group general, the due date anytime and the priority 3 by default, and the task gets marked as unfinished. defaults are the blueprint, bestie. 💫
  • -c id, --change id — changes the item with the id you selected in the task list. heads up tho: you need more specifying options for it to actually do anything. she's not a mind reader. 😭
  • -r id, --remove id — removes the item with the selected id from the task list. bye girl, you won't be missed (affectionate). 💀
  • --change-group group — changes all the items in the group you picked. same deal, you need further specifying options or literally nothing happens.
  • --remove-group group — removes all the items from the selected group. whole group, gone, no crumbs. 🫶
  • --purge-group group — removes all the finished items from the selected group. unfinished ones get to stay, they're still on their journey. 🧚
  • --change-date date — changes all the items with the selected due date. yep, further specifying options required, you know the drill by now.
  • --remove-date date — removes all the items with the selected due date.
  • --purge-date date — removes all the finished items with the selected due date.
  • --change-pri priority — changes all the items with the selected priority. further specifying options required, again, always, forever. 💅
  • --remove-pri priority — removes all the items with the selected priority.
  • --purge-pri priority — removes all the finished items with the selected priority.
  • --change-old — changes all the items whose due date has passed. further specifying options required, no exceptions.
  • --remove-old — removes all the items whose due date has passed. overdue tasks, your reign of terror is over. ⭐
  • --purge-old — removes all the finished items whose due date has passed.
  • --change-all — changes all the items in the task list. further specifying options required, obviously.
  • --remove-all — removes all the items from the task list. scorched earth, but make it self-care. 🔥
  • --purge-all — removes all the finished items from the task list.
  • --undo — reverts your last action. when you invoke it, the data gets restored from the backup file (that's ~/.w2do.bak by default, iykyk), and that backup file gets deleted at the same time. so it's a one-shot undo, bestie — use it wisely. 😭
  • --groups — displays a comma-delimited list of all the groups in the task list. a little roster of your responsibilities. 🎀
  • --stats — displays detailed task list statistics. numbers about your tasks. we love data. 📊
  • -h, --help — displays the help message and exits. she's helpful and then she leaves, iconic behaviour. 💅
  • -v, --version — displays version information and exits.

🦋 Specifying Options 🦋

  • -t task, --task task — specifies the task name. name your task, give it an identity, main character energy. ✨
  • -g group, --group group — specifies the group name. the group name should be a single word with a maximum of 10 characters, but don't stress — longer names get shortened automatically. she'll handle it. 💖
  • -d date, --date date — specifies the due date. your 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. so many flavours, pick your fave. 🌸
  • -p priority, --priority priority — specifies the priority. available options are integers between 1 and 5, where 1 represents the highest priority. yes, lower number = more urgent, it's giving chaotic but we move. 🔥
  • -f, --finished — specifies the finished task. done and dusted, we love a completed era. 👑
  • -u, --unfinished — specifies the unfinished task. she's still cooking. 🍓

💜 Additional Options 💜

  • -s file, --savefile file — uses the file you picked instead of the default ~/.w2do as a save file. custom save file, custom queen. 🎀
  • -w width, --width width — uses the line width you picked; the minimal value is 75. don't go below it, she said what she said. 💅
  • -q, --quiet — avoids displaying messages that aren't necessary. shhh. 🤫
  • -V, --verbose — displays all the messages; this is the default option. she's a talker and we respect it. 🗣️
  • -C, --colour, --color — uses coloured output instead of the default plain text version. pretty colours, we're obsessed. 🌈
  • -X, --no-colour, --no-color — uses plain text output (no colours); this is the default option.
  • -b, --bare — does not display the table header and group separators. minimalism, she's sleek. ✨
  • -B, --no-bare — displays the table header and group separators; this is the default option.
  • -I, --no-id — does not display the ID column in the listing.
  • --with-id — displays the ID column in the listing; this is the default option.
  • -G, --no-group — does not display the group column in the listing.
  • --with-group — displays the group column in the listing; this is the default option.
  • -D, --no-date — does not display the due date column in the listing.
  • --with-date — displays the due date column in the listing; this is the default option.
  • -P, --no-priority — does not display the priority column in the listing.
  • --with-priority — displays the priority column in the listing; this is the default option.
  • -S, --no-state — does not display the state column in the listing.
  • --with-state — displays the state column in the listing; this is the default option.

🧚 ENVIRONMENT 🧚

  • W2DO_SAVEFILE — use the file you picked instead of the default ~/.w2do as a save file. same energy as -s, but it lives in your environment, sneaky queen. 💫
  • W2DO_WIDTH — use the line width you picked; the minimal value is 75. again: don't go below 75, bestie. 💅

🍓 FILES 🍓

  • ~/.w2do — the default save file. your tasks live here, protect her at all costs. 🏠
  • ~/.w2do.bak — the default backup file. this is the one --undo pulls from, and also the one --undo deletes, so like. be aware. 💀

🫶 SEE ALSO 🫶

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

go read those too, they're part of the friend group. ✨

🐛 BUGS 🐛

wanna report bugs or even send patches? (sending patches?? king behaviour 👑) you've got options, bestie:

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

Copyright (C) 2008, 2009, 2010 Jaromir Hradilek

This program is free software; see the source for copying conditions. It 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. (that's the legal way of saying "if it breaks, that's on you bestie, no cap." 😭)

and that's the whole page, babes!! this gorgeous little thing is Version 2.3.1, dated 2018-12-28 — she's been serving since 2018 and she's still that girl. go forth and manage your tasks, my love. mwah. 💋🦋✨

📦 where this page comes from