Name

readpst — convert PST (MS Outlook Personal Folders) files to mbox and other formats

Synopsis

readpst [-D] [-M] [-S] [-V] [-b] [-c format] [-d debug-file] [-e] [-h] [-j jobs] [-k] [-o output-directory] [-q] [-r] [-t output-type-codes] [-u] [-w] pstfile

Description

readpst is a program that can read an Outlook PST (Personal Folders) file and convert it into an mbox file, a format suitable for KMail, a recursive mbox structure, or separate emails.

Options

-D

Include deleted items in the output.

-M

Output messages in MH (rfc822) format as separate files. This will create folders as named in the PST file, and will put each email together with any attachments into its own file. These files will be numbered from 1 to n with no leading zeros.

-S

Output messages into separate files. This will create folders as named in the PST file, and will put each email in its own file. These files will be numbered from 1 to n with no leading zeros. So the email contents for message $m are saved in a file named $m. Attachments will also be saved in the same folder as the email message. The attachments for message $m are saved as $m-$name where $name is (the original name of the attachment, or 'attach$n' if the attachment had no name), where $n is another sequential index with no leading zeros.

-V

Show program version and exit.

-b

Do not save the attachments for the RTF format of the email body.

-c format

Set the Contact output mode. Use -cv for vcard format or -cl for an email list.

-d debug-file

Specify name of debug log file. The log file is now an ascii file, instead of the binary file used in previous versions.

-e

Same as the M option, but each output file will include an extension from (.eml, .ics, .vcf).

-h

Show summary of options and exit.

-j jobs

Specifies the maximum number of parallel jobs. Specify 0 to suppress running parallel jobs.

-k

Changes the output format to KMail.

-o output-directory

Specifies the output directory. The directory must already exist, and is entered after the PST file is opened, but before any processing of files commences.

-q

Changes to silent mode. No feedback is printed to the screen, except for error messages.

-r

Changes the output format to Recursive. This will create folders as named in the PST file, and will put all emails in a file called "mbox" inside each folder. These files are then compatible with all mbox-compatible email clients.

-t output-type-codes

Specifies the item types that are processed. The argument is a sequence of single letters from (e,a,j,c) for (email, appointment, journal, contact) types. The default is to process all item types.

-u

Sets Thunderbird mode, a submode of recursive mode. This causes two extra .type and .size meta files to be created.

-w

Overwrite any previous output files. Beware: When used with the -S switch, this will remove all files from the target folder before writing. This is to keep the count of emails and attachments correct.

Author

This manual page was originally written by Dave Smith <dave.s@earthcorp.com>, and updated by Joe Nahmias <joe@nahmias.net> for the Debian GNU/Linux system (but may be used by others). It was subsequently updated by Brad Hards <bradh@frogmouth.net>, and converted to xml format by Carl Byington <carl@five-ten-sg.com>.

Copyright

Copyright (C) 2002 by David Smith <dave.s@earthcorp.com>. XML version Copyright (C) 2008 by 510 Software Group <carl@five-ten-sg.com>.

This program 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 2, or (at your option) any later version.

You should have received a copy of the GNU General Public License along with this program; see the file COPYING. If not, please write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

Version

0.6.44