---
name: "w2text"
section: "1"
platform: "linux"
package: "w2do"
version: "2.3.1-8"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/w2text"
---

# w2text(1)

a plain text exporter for w2do

## NAME

w2text - a plain text exporter for w2do

## SYNOPSIS

**w2text** \[**-bS**\] \[**-o** *file*\] \[**-s** *file*\] \[**-w** *width*\] \[**-f**\|**-u**\] \[**-d** *date*\] \[**-g** *group*\] \[**-p** *priority*\] \[**-t** *task*\]

**w2text** **-h** \| **-v**

## DESCRIPTION

**w2text** is a plain text exporter for w2do, a simple to use yet efficient command-line todo manager written in Perl. All tasks are listed by default, but desired subset can be easily selected via specifying options.

## OPTIONS

### General Options

- **-h**, **--help**

  Display help message and exit.

- **-v**, **--version**

  Display version information and exit.

### Specifying Options

- **-t** *task*, **--task** *task*

  Specify the *task* name.

- **-g** *group*, **--group** *group*

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

- **-d** *date*, **--date** *date*

  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.

- **-p** *priority*, **--priority** *priority*

  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.

### Additional Options

- **-o** *file*, **--output** *file*

  Use selected *file* instead of the standard output.

- **-s** *file*, **--savefile** *file*

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

- **-w** *width*, **--width** *width*

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

- **-b**, **--bare**

  Organise tasks as a single list instead of listing them by groups they belong to.

- **-B**, **--no-bare**

  Organise tasks to the separate groups; the default option.

- **-S**, **--no-state**

  Do not display state information in the listing.

- **--with-state**

  Display state information in the listing; the default option.

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

## SEE ALSO

[**w2do**(1)](/w2do/1.md), [**w2html**(1)](/w2html/1.md), [**perl**(1)](/perl/1.md).

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

## 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

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.