https://github.com/vikramarsid/msg_parser

Python module to read, parse and converting Microsoft Outlook MSG E-Mail files.
https://github.com/vikramarsid/msg_parser

convert eml microsoft msg outlook parser

Last synced: 10 days ago
JSON representation

Python module to read, parse and converting Microsoft Outlook MSG E-Mail files.

• Host: GitHub
• URL: https://github.com/vikramarsid/msg_parser
• Owner: vikramarsid
• License: bsd-2-clause
• Created: 2018-10-29T22:05:46.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-12-07T12:26:49.000Z (about 1 year ago)
• Last Synced: 2025-10-27T03:48:43.665Z (3 months ago)
• Topics: convert, eml, microsoft, msg, outlook, parser
• Language: Python
• Size: 31 MB
• Stars: 57
• Watchers: 4
• Forks: 18
• Open Issues: 27
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Authors: AUTHORS.rst

Awesome Lists containing this project

README

          
msg_parser

==========

.. image:: https://img.shields.io/pypi/v/msg_parser.svg

        :target: https://pypi.python.org/pypi/msg_parser

.. image:: https://img.shields.io/travis/vikramarsid/msg_parser.svg

        :target: https://travis-ci.org/vikramarsid/msg_parser

.. image:: https://readthedocs.org/projects/msg-parser/badge/?version=latest

        :target: https://msg-parser.readthedocs.io/en/latest/?badge=latest

        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/vikramarsid/msg_parser/shield.svg

     :target: https://pyup.io/repos/github/vikramarsid/msg_parser/

     :alt: Updates

Python module for parsing outlook msg files.

* Free software: BSD license

* Documentation: https://msg-parser.readthedocs.io.

Features

--------

* Parse MSG file.

* Convert MSG file to EML file.

* Output MSG file as JSON string.

* Handles nested MSG/EML attachments.

* Works 100% on Linux machines, do not require any windows libraries.

Installation

------------

* Basic installation

  .. code-block:: bash

 	 pip install msg_parser

* With RTF decompression

  .. code-block:: bash

 	 pip install msg_parser[rtf]

Usage

-----

* Run CLI command

   .. code-block:: bash

       $ msg_parser --help

         usage: msg_parser [-h] -i FILE [-j] [-e EML_FILE]

        Microsoft Message Parser

        optional arguments:

            -h, --help            show this help message and exit

            -i FILE, --input FILE

                                  msg file path

            -j, --json            output parsed msg as json to console

            -e EML_FILE, --eml EML_FILE

                                  provide email file path to save as eml file.

 * Import in python modules

   .. code-block:: python

        from msg_parser import MsOxMessage

        msg_obj = MsOxMessage(msg_file_path)

        json_string = msg_obj.get_message_as_json()

        msg_properties_dict = msg_obj.get_properties()

        saved_path = msg_obj.save_email_file(output_eml_file_path)