        __  _                        __ _                           _  __
  ______\ \_\\_______________________\///__________________________//_/ /______
  \___\                                                                   /___/
   | .__                                 __                                  |
   | |                   ___  __________/  |________                         |
   |                     \  \/  / ____/\   __\_  __ \                        |
   ;                      >    < <_|  | |  |  |  | \/                        ;
   :                     /__/\_ \__   | |__|  |__|                           :
   .                           \/  |__|      Releases                        .
   .                                                                         .
   :           H/Q Another Droid BBS - andr01d.zapto.org:9999                :
   ;                                                                         ;
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   :                                                                         :
   |                         BBS Mail Post v1.0                              |
   :                                                                         :
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   | ._          SoftWare         Oper.System      Type                      |
   ; |           - { } BASH       - {x} Linux      - { } ANSI                ;
   :             - { } DOOR       - {x} RPi        - { } TEXT                :
   .             - { } MPL        - { } Windows    - { } ASCII               .
   :             - {x} Python     - { } Mac        - { } BINARY              :
   ;             - {x} Source     - { } OS/2                                 ;
   |                                                                         |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   |  _     _ _                                                              |
   ; |    _| | |_    ____  _         _     _                                 ;
   :     |_     _|  |    \|_|___ ___| |___|_|_____ ___ ___                   :
   .     |_     _|  |  |  | |_ -|  _| | .'| |     | -_|  _|   _ _ _          .
   ;       |_|_|    |____/|_|___|___|_|__,|_|_|_|_|___|_|    |_|_|_|         ;
   |                                                                         |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   ; The author has taken every precaution to insure that no harm or damage  ;
   | will occur on computer systems operating this util.  Never the less, the:
   ; author will NOT be held liable for whatever may happen on your computer .
   : system or to any computer systems which connects to your own as a result:
   . of. operating this util.  The user assumes full responsibility for the  ;
   : correct operation of this software package, whether harm or damage      |
   ; results from software error, hardware malfunction, or operator error.   :
   | NO warranties are : offered, expressly stated or implied, including     .
   | without limitation or ; restriction any warranties of operation for a   :
   ; particular purpose and/or | merchant ability.  If you do not agree with ;
   : this then do NOT use this program.                                      |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´

   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   |        _ _                                                              |
   ;      _| | |_    _____ _           _                                     ;
   :     |_     _|  |  _  | |_ ___ _ _| |_                                   :
   .     |_     _|  |     | . | . | | |  _|   _ _ _                          .
   ;       |_|_|    |__|__|___|___|___|_|    |_|_|_|                         ;
   |                                                                         |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   Post echonet messages via email, from any device. You can also check the
   One Liners and Last Callers lists and get a list of all message bases in
   your BBS. Works only with Mystic BBS 1.12 A43+.
   
   The script will check a specific email account for incoming mails that 
   have as Subject, a specific text string. This way, the script will not try
   to process messages like spam mails or other personal emails. The string
   can be anything you want, like a passphrase/password or just a word.
   
   If the Subject matches with the "passphrase", the script will check for 
   commands. Currently, supported commands are:
   
   =post          : To make a post in an echoarea/message base. This command
                    needs more parameters. Read below on how to use it.
   =oneliners
   =onleiner
   =1l            : It will send you an email, as a response, with the last
                    OneLiners strings in your BBS
   =lastcallers
   =lastcaller
   =last          : It will send an email with the LastCallers list of your
                    BBS
   =list          : It will send an email with a list of all echotags, of 
                    your message bases. It will not contain Local bases.
                    
   --------------------------------------
   How to send a Message/Post via email!
   --------------------------------------
   
   :: In your email client start a new email!
   :: Recipient must be the email address that the script checks for incoming
      messages.
   :: As Subject, enter the passphrase/word you also use in the script.
   :: In the body of the email write these:
   
   =post
   +echo_tag
   <from who line>
   <to whom line>
   <subject line>
   message text... it can be many lines long...
   ...
   ...
   ...
   
   :: Now send that email! :)
   
   In the <from who line> you just write the username that sends the message.
   Just the username, nothing else. Also in the <to whom line> you write the 
   username of the recipient or just All and lastly the subject line is the
   subject of the message.
   
   The main thing here is the +echo_tag line. It has to start with a plus/+ 
   sign and followed by the echo tag string of the message base you want the
   message to be posted in. If for example you want to send a message to the 
   FSX General Chat echoarea, the echo tag should be: +fsx_gen
   
   To get a list of all echo tags in your BBS, send an email with the =list
   command and you will get all of them.
 
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   |        _ _                                                              |
   ;      _| | |_    _____         _       _ _                               ;
   :     |_     _|  |     |___ ___| |_ ___| | |                              :
   .     |_     _|  |-   -|   |_ -|  _| .'| | |   _ _ _                      .
   ;       |_|_|    |_____|_|_|___|_| |__,|_|_|  |_|_|_|                     ;
   |                                                                         |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´

   ::/ Put the files mailpost.py and post.sh inside mystics main directory 
   ::/ Edit the two files and input your own settings and correct paths.
        - You have to know IMAP/SMTP settings for the email address/server
          you will use.
   ::/ Make the two scripts executable
   ::/ Create a CRON job to execute the script post.sh repeatedly and check
       the email account for incoming commands/posts.
    
       An example for a CRON job is the following:
       
       */20 * * * * /home/pi/mystic/post.sh &
       
       It will execute the script every 20 min.

   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   |        _ _                                                              |
   ;      _| | |_    _____         ___ _                                     ;
   :     |_     _|  |     |___ ___|  _|_|___                                 :
   .     |_     _|  |   --| . |   |  _| | . |   _ _ _                        .
   ;       |_|_|    |_____|___|_|_|_| |_|_  |  |_|_|_|                       ;
   |                                    |___|                                |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   
   ::/ Edit the main script and enter the server and email settings for your
       accounts.

   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   |        _ _                                                              |
   ;      _| | |_    _____ _     _                                           ;
   :     |_     _|  |  |  |_|___| |_ ___ ___ _ _                             :
   .     |_     _|  |     | |_ -|  _| . |  _| | |   _ _ _                    .
   ;       |_|_|    |__|__|_|___|_| |___|_| |_  |  |_|_|_|                   ;
   |                                        |___|                            |
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
   
    .:. November 2019
     `  + First Release
        
          
   
   + --- --  -   .     -        ---    ---    ---        -     .    - -- --- ´
         _____         _   _              ____          _   _ 
        |  _  |___ ___| |_| |_ ___ ___   |    \ ___ ___|_|_| |        8888
        |     |   | . |  _|   | -_|  _|  |  |  |  _| . | | . |     8 888888 8
        |__|__|_|_|___|_| |_|_|___|_|    |____/|_| |___|_|___|     8888888888
                                                                   8888888888
                DoNt Be aNoTHeR DrOiD fOR tHe SySteM               88 8888 88
                                                                   8888888888
 /: HaM RaDiO   /: ANSi ARt!     /: MySTiC MoDS   /: DooRS         '88||||88'
 /: NeWS        /: WeATheR       /: FiLEs         /: SPooKNet       ''8888"'
 /: GaMeS       /: TeXtFiLeS     /: PrEPardNeSS   /: FsxNet            88
 /: TuTors      /: bOOkS/PdFs    /: SuRVaViLiSM   /:            8 8 88888888888
                                                              888 8888][][][888
   TeLNeT : andr01d.zapto.org:9999 / ssh: 8888                  8 888888##88888
   SySoP  : xqtr                   eMAiL: xqtr@gmx.com          8 8888.####.888
   DoNaTe : https://paypal.me/xqtr                              8 8888##88##888
