ANNOUNCE

   1
   2                                   mimedecode
   3
   4 WHAT IS IT
   5
   6    Mail users, especially in non-English countries, often find that mail
   7 messages arrived in different formats, with different content types, in
   8 different encodings and charsets. Usually this is good because it allows
   9 us to use appropriate format/encoding/whatever. Sometimes, though, some
  10 unification is desirable. For example, one may want to put mail messages
  11 into an archive, make HTML indices, run search indexer, etc. In such
  12 situations converting messages to text in one character set and skipping
  13 some binary attachments is much desirable.
  14
  15    Here is the solution - mimedecode.
  16
  17    This is a program to decode MIME messages. The program expects one
  18 input file (either on command line or on stdin) which is treated as an
  19 RFC822 message, and decodes to stdout or an output file. If the file is
  20 not an RFC822 message it is just copied to the output one-to-one. If the
  21 file is a simple RFC822 message it is decoded as one part. If it is a
  22 MIME message with multiple parts ("attachments") all parts are decoded.
  23 Decoding can be controlled by command-line options.
  24
  25    Think about said mail archive; for example, its maintainer wants to
  26 put there only texts, convert PDF/Postscript to text, pass HTML and
  27 images decoding base64 to html but leaving images encoded, and ignore
  28 everything else. This is how it could be done:
  29
  30    mimedecode -t application/pdf -t application/postscript -t text/plain -b text/html -B 'image/*' -i '*/*'
  31
  32
  33 Version 3.1.0 (2020-??-??)
  34
  35    Convert mimedecode.docbook to reST. Generate html/man/text
  36    using Sphinx.
  37
  38    Replaced outdated and insecure `mktemp` with `NamedTemporaryFile`.
  39
  40    Python 3.8.
  41
  42
  43 WHERE TO GET
  44    Home page: https://phdru.name/Software/Python/#mimedecode
  45     git clone https://github.com/phdru/mimedecode.git
  46     git clone https://git.phdru.name/mimedecode.git
  47     git clone  git://git.phdru.name/mimedecode.git
  48
  49    Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+.
  50    Tests require: tox, m_lib 3.1+.
  51
  52    Recommends: configured mailcap database.
  53
  54    Documentation: https://phdru.name/Software/Python/mimedecode.html
  55       (also included in the package in html, man and txt formats).
  56
  57
  58 AUTHOR
  59    Oleg Broytman <phd@phdru.name>
  60
  61 COPYRIGHT
  62    Copyright (C) 2001-2020 PhiloSoft Design.
  63
  64 LICENSE
  65    GPL