How to use 'Mave' textbase mailer.

Requirement

  Ruby and curses library.

1. Get archive and Extract
  Access http://sourceforge.jp/projects/mave/downloads/44582/mave.tgz/
  $ tar xvfz mave.tgz
  $ cd mave

2. Build your config

  $ cp mave.config.sample mave.config
  $ vi mave.config

    rewrite setting of 'Main' account to yours.

    configure your editor environment.

    @configs[:EDITOR_TYPE] = ['system'|'forkexec']
        system: Mave close curses window and wake editor with same console. For CUI.
      forkexec: Mave fork child process and wake editor another window. For GUI.

    @configs[:EDITOR] = '/usr/bin/editor %s'
      The command of wake editor. %s is replaced to file name. 

3. Make directory for store mail files

  $ mkdir ~/mave.mails

  Mave do not create any files without the directory specified here.

4. Execute Mave

  $ ./mave

5. Fetch mails

  Press Ctrl + x, p key to fetch mails from server.

  In default, Mave does not remove mails on pop server immediately.
  The time lag until removing mails was set by ':POP_KEEP_TIME'.
  It is possible to try use Mave in parallel with your current mailer.

  Status window is scrolled by Pgup, PgDn keys.

6. Explore mails

  Each h, j, k, and l key were allocated in each Left, Down, Up, and Right like the Vi editor. 

  However, the function to send mail has not been provided to Mave yet...

  How to look summary line.

  x.  22 Amazon.com   <sh Sun, 22 Nov 15:40  579 .. +Amazon.com order confirmation
  ^^ ^^^ ^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^ ^^^^ ^^ ^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  ||  |   Mail from / to   Sent date        size || |  Subject
  ||  +-Recent 0 <=> 999 Old                     || +-Parent(+) / Child(-) / Folded(#/=)
  |+-Flag(F) / Notice mark(#)                    |+-Multipart mail(@)(Has attachement)
  +-Unread mark(x)                               +-To you(w) / Cc you(v)

  You can change summary looking.

  r key: Unread mark ON/OFF           f key: Flag ON/OFF
  o key: Fold thread / Open           n key: Notice mark ON/OFF

7. Incremental search

  Press Ctrl + s key to open incremental search dialog at summary or preview view.
  The search will running that each key was pressed.
  Press Ctrl + s key to search next when word found.
  Press Ctrl + g key to abort search or close search dialog.
  Press Ctrl + r key to search backward.

8. Create/Edit mail message

  Press Ctrl + x, n key to create new mail message.
  Press Ctrl + x, r key to create reply mail message.
  The message will store to 'drafts' folder.

  Press Ctrl + x, e key to edit mail message.
  The message will overwrite.

9. Mail Folders

  Press h key on the summary view, change into the folder view.
  In folder view, select folder with up/down(k, j), and move into the folder with right(l).
  Or press shortcut key to move into the folder.

  How to look folder list.

  x 0) Inbox (5/52)
  . a) Community (2/38)
  x b) Develop (1/8)
  . d) Drafts (0/23)
  . o) Outbox (0/0)
  . s) Sent (0/25)
  . t) Trash (0/18)
  ^ ^  ^^^^^  ^^^^
  | |    |    Number of unread / all mails
  | |    +-Folder name
  | +-Shortcut key
  +-Folder got new mails mark(x) *not provided yet

  In folder view, press Ctrl + x, n key to create new folder.
  In selecting folder, press Ctrl + x, e key to edit folder configurations.
  You can change display name, list order and mail distributing by edit folder configurations.
  See example in 'mave.folderconfig.master'.

  However, the function to move/delete mail has not been provided to Mave yet...

10. Quit

  Press Ctrl + x, c key to kill mave.

Enjoy!!

Note:
  When multibyte character is troubled.
  Standard curses library of Ruby doesn't correspond to UTF-8. 
  Please apply the patch to correspond to ncursesw referring to the following sites. 

  http://www.itline.jp/~svx/diary/?date=20091022

  In experimentally, Mave corresponds terminal environment of EUC-JP now. 
  In this case, you do not need to apply above patch.
  Set EUC-JP to ':TERMINAL_CHARSET' in mave.config, and change mave_base.rb a bit.
  "export LANG=ja_JP.eucjp" might execute from the terminal. 

  117     def enspc
  118 #       return(self)                                            # comment out without UTF-8
  119 ^       self.gsub(/[\xC0-\xE2][\x80-\xBF]+/) {|c|               #### for UTF8 temporally
      +ｰremove this '#'

  And in experimentally, Mave is corresponding Windows console environment with SHIFT_JIS.
  Set SHIFT_JIS to ':TERMINAL_CHARSET' in mave.config, and try and error.

Mave project official page:
  http://sourceforge.jp/projects/mave/

[EOF]
