mirror of https://github.com/djcb/mu.git
99 lines
2.4 KiB
Groff
99 lines
2.4 KiB
Groff
.TH MU EXTRACT 1 "May 2011" "User Manuals"
|
|
|
|
.SH NAME
|
|
|
|
mu extract\- display and save message parts (attachments), and open them with
|
|
other tools.
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B mu extract [options] <file>
|
|
.B mu extract [options] <file> <pattern>
|
|
|
|
.SH DESCRIPTION
|
|
|
|
\fBmu extact\fR is the \fBmu\fR sub-command for extracting MIME-parts (e.g.,
|
|
attachments) from mail messages. It works on message files, and does not
|
|
require the message to be indexed in the database.
|
|
|
|
For attachments, the file name used when saving it, is the name of the
|
|
attachment in the message. If there is no such name, or when saving
|
|
non-attachment MIME-parts, a name is derived from the message-id of the
|
|
message.
|
|
|
|
If you specify a pattern (a case-insensitive regular expression) as the second
|
|
argument, all attachments with filenames matching that pattern will be
|
|
extracted. The regular expressions are Perl-compatible (as per the
|
|
PCRE-library).
|
|
|
|
Without any options, \fBmu extract\fR simply outputs the list of MIME-parts in
|
|
the message.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-save\-attachments\fR
|
|
save all MIME-parts that look like attachments.
|
|
|
|
.TP
|
|
\fB\-\-save\-all\fR
|
|
save all non-multipart MIME-parts.
|
|
|
|
.TP
|
|
\fB\-\-parts\fR=<parts>
|
|
only consider the following numbered parts
|
|
(comma-separated list).The numbers for the parts can be seen from running
|
|
\fBmu extract\fR without any options but only the message file.
|
|
|
|
.TP
|
|
\fB\-\-target\-dir\fR=<dir>
|
|
save the parts in the target directory rather than
|
|
the current working directory.
|
|
|
|
.TP
|
|
\fB\-\-overwrite\fR
|
|
overwrite existing files with the same name; by default overwriting is not
|
|
allowed.
|
|
|
|
.TP
|
|
\fB\-\-play\fR Try to 'play' (open) the attachment with the default
|
|
application for the particular file type. Depends on the \fBxdg-open\fR
|
|
utility.
|
|
|
|
.SH EXAMPLES
|
|
|
|
To display information about all the MIME-parts in a message file:
|
|
.nf
|
|
$ mu extract msgfile
|
|
.fi
|
|
|
|
To extract MIME-part 3 and 4 from this message, overwriting existing files
|
|
with the same name:
|
|
.nf
|
|
$ mu extract --parts=3,4 --overwrite msgfile
|
|
.fi
|
|
|
|
To extract all files ending in '.jpg' (case-insensitive):
|
|
.nf
|
|
$ mu extract msgfile '.*\.jpg'
|
|
.fi
|
|
|
|
To extract an mp3-file, and play it in the the default mp3-playing application
|
|
(requires \fIxdg-open\fR):
|
|
.nf
|
|
$ mu extract --play msgfile 'whoopsididitagain.mp3'
|
|
.fi
|
|
|
|
.SH BUGS
|
|
|
|
Please report bugs if you find them:
|
|
.BR http://code.google.com/p/mu0/issues/list
|
|
|
|
.SH AUTHOR
|
|
|
|
Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR mu(1) xdg-open(1)
|