NAME

       muextract - display and save message parts (attachments), and open them with other tools.

SYNOPSIS

       mu [common-options] extract [options] <file>

       mu [common-options] extract [options] <file> <pattern>

DESCRIPTION

       mu  extract  is the mu sub-command for extracting MIME-parts (e.g., attachments) from mail
       messages. The sub-command 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  regular  express pattern as the second argument, all attachments with
       filenames matching that pattern will be extracted. The regular expressions are basic PCRE,
       and are case-sensitive by default; see pcre(3) for more details.

       Without any options, mu extract simply outputs the list of leaf MIME-parts in the message.
       Only 'leaf' MIME-parts (including RFC822 attachments) are considered, multipart/* etc. are
       ignored.

EXTRACT OPTIONS

   -a, --save-attachments
       save all MIME-parts that look like attachments.

   --save-all
       save all non-multipart MIME-parts.

   --parts=<parts>
       only  consider  the  following  numbered parts (comma-separated list). The numbers for the
       parts can be seen from running mu extract without any options but only the message file.

   --target-dir=<dir>
       save the parts in the target directory rather than the current working directory.

   --overwrite
       overwrite existing files with the same name; by default overwriting is not allowed.

   -u,--uncooked
       by default, mu transforms the attachment filenames a bit (such as by replacing  spaces  by
       dashes);  with this option, leave that to the minimum for creating a legal filename in the
       target directory.

   --play
       Try to 'play' (open) the attachment with the default application for the  particular  file
       type.  On  MacOS, this uses the open program, on other platforms it uses xdg-open. You can
       choose a different program by setting the MUPLAYPROGRAM environment variable.

COMMON OPTIONS

   -d, --debug
       makes mu generate extra debug information, useful for debugging  the  program  itself.  By
       default,  debug  information  goes  to the log file, ~/.cache/mu/mu.log.  It can safely be
       deleted when mu is not running. When running with --debug option, the log  file  can  grow
       rather quickly. See the note on logging below.

   -q, --quiet
       causes  mu  not  to  output  informational  messages  and progress information to standard
       output, but only to the log file. Error messages will still be  sent  to  standard  error.
       Note  that  mu index is much faster with --quiet, so it is recommended you use this option
       when using mu from scripts etc.

   --log-stderr
       causes mu to not output log messages to standard error, in addition to sending them to the
       log file.

   --nocolor
       do  not use ANSI colors. The environment variable NOCOLOR can be used as an alternative to
       --nocolor.

   -V, --version
       prints mu version and copyright information.

   -h, --help
       lists the various command line options.

EXAMPLES

       To display information about all the MIME-parts in a message file:
              $ mu extract msgfile

       To extract MIME-part 3 and 4 from this message, overwriting existing files with  the  same
       name:
              $ mu extract --parts=3,4 --overwrite msgfile

       To extract all files ending in '.jpg' (case-insensitive):
              $ mu extract msgfile '.*.jpg'

       To extract an mp3-file, and play it in the default mp3-playing application:
              $ mu extract --play msgfile 'whoopsididitagain.mp3'

REPORTING BUGS

       Please report bugs at https://github.com/djcb/mu/issues.

AUTHOR

       Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>

COPYRIGHT

       This manpage is part of mu 1.10.8.

       Copyright  ©  2022-2023  Dirk-Jan  C.  Binnema. License GPLv3+: GNU GPL version 3 or later
       https://gnu.org/licenses/gpl.html. This is free software:  you  are  free  to  change  and
       redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       mu(1)

                                                                                    MU EXTRACT(1)