:py:mod:`dissect.target.plugins.apps.chat.msn`
==============================================

.. py:module:: dissect.target.plugins.apps.chat.msn




Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

   dissect.target.plugins.apps.chat.msn.MSNPlugin



Functions
~~~~~~~~~

.. autoapisummary::
   :nosignatures:

   dissect.target.plugins.apps.chat.msn.convert_email



.. py:class:: MSNPlugin(target: dissect.target.target.Target)

   Bases: :py:obj:`dissect.target.plugins.apps.chat.chat.ChatPlugin`


   Microsoft MSN Messenger plugin.

   Supports the following versions on Windows XP and Windows 7:
       - Windows Live Messenger (WLM) 2009
       - MSN 7.5

   Other versions might work but have not been tested. Does not support ``Messenger Plus! Live`` artifacts.
   Tested using Escargot (https://escargot.chat).

   .. rubric:: References

   - https://en.wikipedia.org/wiki/Microsoft_Messenger_service
   - https://en.wikipedia.org/wiki/MSN_Messenger
   - http://computerforensics.parsonage.co.uk/downloads/MSNandLiveMessengerArtefactsOfConversations.pdf


   .. py:attribute:: __namespace__
      :value: 'msn'


      Defines the plugin namespace.


   .. py:attribute:: DATA_PATH
      :value: 'Application Data\\Microsoft\\MSN Messenger'



   .. py:attribute:: HIST_PATH
      :value: 'My Documents\\My Received Files'



   .. py:attribute:: installs


   .. py:method:: find_installs() -> collections.abc.Iterator[tuple[dissect.target.plugins.general.users.UserDetails, dissect.target.helpers.fsutil.TargetPath]]


   .. py:method:: check_compatible() -> None

      Perform a compatibility check with the target.

      This function should return ``None`` if the plugin is compatible with the current target (``self.target``).
      For example, check if a certain file exists. Otherwise it should raise an
      :class:`UnsupportedPluginError`.

      :raises UnsupportedPluginError: If the plugin could not be loaded.



   .. py:method:: history() -> collections.abc.Iterator[dissect.target.plugins.apps.chat.chat.ChatMessageRecord | dissect.target.plugins.apps.chat.chat.ChatAttachmentRecord]

      Yield MSN chat history messages.

      Chat history artifacts can be found in:
          - ``$HOME/My Documents/My Received Files/MsnMsgr.txt``
          - ``$HOME/My Documents/My Received Files/$username$PassportID/History/*.xml``



.. py:function:: convert_email(string: str) -> int

   Convert MSN email address to 10 digit Passport ID.