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 2.9.0 (2017-12-12)
  34
  35    Split mimedecode.py into mimedecode library and a small script.
  36
  37    Make the library executable via ``python -m mimedecode``.
  38
  39 Version 2.8.0 (2017-11-03)
  40
  41    Python 3.
  42
  43    Stop supporting Python 2.6.
  44
  45
  46 WHERE TO GET
  47    Home page: https://phdru.name/Software/Python/#mimedecode
  48     git clone https://github.com/phdru/mimedecode.git
  49     git clone https://git.phdru.name/mimedecode.git
  50     git clone  git://git.phdru.name/mimedecode.git
  51
  52    Requires: Python 2.7 or Python 3.4+, m_lib.defenc 1.0+.
  53    Tests require: tox, m_lib 3.1+.
  54
  55    Recommends: configured mailcap database.
  56
  57    Documentation: https://phdru.name/Software/Python/mimedecode.html
  58       (also included in the package in html, man and txt formats).
  59
  60
  61 AUTHOR
  62    Oleg Broytman <phd@phdru.name>
  63
  64 COPYRIGHT
  65    Copyright (C) 2001-2018 PhiloSoft Design.
  66
  67 LICENSE
  68    GPL