====== The Epeios Meta Mail User Agent management tool ('mmuaq') ======

===== Introduction =====

This component (''processing/mmuaq/mmuaqcli[.exe]'') is a command-line management and development tool. It shares code with the backend for testing purpose.

===== Compilation =====

See [[computing:epeios:compilation]].

===== Configuration =====

See [[computing:epeios:configuration]].

As explained in the link above, if you want to easily switch between several accounts, without having to modify the configuration file, you can put below sections in //Setups//, one //Setup// per account, and use the ''-s|%%--%%setup'' command-line option to switch to the desired account.

==== 'POP3' section  ====

For the //POP3// related commands (those which begin with ''%%--%%pop3-'') to work properly, you must create a ''POP3'' section in the ''Parameters'' section (or as //Setup//), which looks like following :

<code xml>
<POP3 HostPort="HOST_PORT>
 <Username>USERNAME</Username>
 <Password>PASSWORD</Password>
</POP3>
</code>

where : 
  * ''//HOST_PORT//'' is the the ''address:service'' of the //POP3// server,
  * ''//USERNAME//'' is the username of an account of the above //POP3// server,
  * ''//PASSWORD//'' is the password for the above username.

==== 'IMAP' section  ====
For the //IMAP// related commands (those which begin with ''%%--%%imap-'') to work properly, you must create an ''IMAP'' section in the ''Parameters'' section (or as //Setup//), which looks like following :

<code xml>
<IMAP HostPort="HOST_PORT>
 <Username>USERNAME</Username>
 <Password>PASSWORD</Password>
</IMAP>
</code>

where : 
  * ''//HOST_PORT//'' is the the ''address:service'' of the //IMAP// server,
  * ''//USERNAME//'' is the username of an account of the above //IMAP// server,
  * ''//PASSWORD//'' is the password for the above username.

===== Usage =====

See the [[.manual|user manual]].

For the ''%%--%%get-field'' command, the ''<field>'' argument can have one of following value : ''Subject'', ''To'', ''From'', ''MessageId'' and ''Date''.

If you want to apply the ''%%--%%get-field'' command (or the ''%%--%%show-header'' one) to directly from a //POP3// or //IMAP// server retrieved message, you can use the pipe (''|''). For example, to retrieve the ''MessageId'' field body from the message number ''1'' (which is supposed to exist) from your //POP3// server account, launch:

 ''mmuaq %%--%%pop3-retrieve 1 | mmuaq %%--%%get-field MessageId''.