How to use 'Mave' textbase mailer.

Requirement

  Ruby, curses and gdbm 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 attachment)
  +-Unread mark(x)                               +-To you(w) / Cc you(v) *not provided yet

  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 *not exactly yet
  | |    +-Folder name
  | +-Shortcut key
  +-Folder got new mails mark(x)

  Press r key to ON/OFF got new mails mark.
  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'.

10. Move, Copy and Delete mails.

  In summary view, press Ctrl + x, m key to move mail to another folder.
  The folder view opens, and select the destination folder.

  Press Ctrl + x, c key to copy mail to another folder.

  Press Ctrl + x, d key to delete mail.
  The mail deleted from except trash folder, it moves to the trash folder.
  The mail deleted from trash folder, it deleted completely.

11. Mark mails

  In summary view, press m key to mark mail.
  The marked mails are indicated with 'M'.

  - x.  22 Amazon.com   <sh Sun, 22 Nov 15:40  579 .. +Amazon.com order confirmation
  M x.  22 Amazon.com   <sh Mon, 23 Nov 15:41  612 ..   -Amazon.com shipping information (#123-1423534-1048639) 
  ^ "M" mark

  Press u key to unmark mail.
  Press ESC, u key to unmark all mails.

  Most functions act on marked mails while marking mails.

12. Arrange mail threads

  In summary view, Press Ctrl + x, shift + j key to take off mail from thread.

  Press ESC, j key to tie mail to original thread.

  Press Ctrl + x, j key to tie mail to mail thread that you want to.
  The mail that marked will tie to the mail that indicated with cursor, when press Ctrl + x, j key.

13. 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]