e9/d707549d78203e6b025760dc16242972437796

   1 Return-Path: <notmuch@stoakes.net>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 83BA5431FB6\r
   6         for <notmuch@notmuchmail.org>; Sat, 29 Sep 2012 05:35:08 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 1.363\r
  10 X-Spam-Level: *\r
  11 X-Spam-Status: No, score=1.363 tagged_above=-999 required=5\r
  12         tests=[RDNS_DYNAMIC=0.363, TO_NO_BRKTS_DYNIP=1] autolearn=unavailable\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id 4AsUOBVNBWaS for <notmuch@notmuchmail.org>;\r
  16         Sat, 29 Sep 2012 05:35:08 -0700 (PDT)\r
  17 Received: from narco.pvt.stoakes.net (dsl-202-173-137-105.sa.westnet.com.au\r
  18         [202.173.137.105])\r
  19         by olra.theworths.org (Postfix) with ESMTP id E9FF1431FAE\r
  20         for <notmuch@notmuchmail.org>; Sat, 29 Sep 2012 05:35:07 -0700 (PDT)\r
  21 Received: by narco.pvt.stoakes.net (Postfix, from userid 1000)\r
  22         id 0DCA0E5E5F; Sat, 29 Sep 2012 22:05:06 +0930 (CST)\r
  23 Date: Sat, 29 Sep 2012 22:05:06 +0930\r
  24 From: Tim Stoakes <notmuch@stoakes.net>\r
  25 To: notmuch@notmuchmail.org\r
  26 Subject: [ANNOUNCE] notmuchfs - A virtual maildir file system for notmuch\r
  27         queries\r
  28 Message-ID: <20120929123506.GM27230@mail.stoakes.net>\r
  29 MIME-Version: 1.0\r
  30 Content-Type: text/plain; charset=us-ascii\r
  31 Content-Disposition: inline\r
  32 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  33 X-BeenThere: notmuch@notmuchmail.org\r
  34 X-Mailman-Version: 2.1.13\r
  35 Precedence: list\r
  36 List-Id: "Use and development of the notmuch mail system."\r
  37         <notmuch.notmuchmail.org>\r
  38 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  39         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  40 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  41 List-Post: <mailto:notmuch@notmuchmail.org>\r
  42 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  43 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  44         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  45 X-List-Received-Date: Sat, 29 Sep 2012 12:35:08 -0000\r
  46 \r
  47 Hello fellow notmuch-ers,\r
  48 \r
  49 What is notmuchfs?\r
  50 ------------------\r
  51 Notmuchfs implements a virtual file system which creates maildirs from notmuch\r
  52 mail query results. This is useful for using notmuch with tools which are not\r
  53 aware of notmuch, only maildirs - such as mutt.\r
  54 \r
  55 Basically you 'mkdir' your query strings, then point your tool of choice at\r
  56 that directory, and it turns into a virtual maildir containing the query\r
  57 results.\r
  58 \r
  59 \r
  60 How does it work?\r
  61 -----------------\r
  62 A notmuchfs virtual file system is mounted referencing a particular existing\r
  63 (real) directory called the 'backing store'.\r
  64 \r
  65 Directories created within the backing store, when read, appear to have the\r
  66 standard maildir format (e.g. cur/, new/, tmp/ sub-directories).\r
  67 \r
  68 Notmuchfs interprets the names of these backing store directories as notmuch\r
  69 queries, and fills the cur/ virtual maildir sub-directory with virtual messages\r
  70 which are the result of executing that query (at the instant in time that the\r
  71 directory is read).\r
  72 \r
  73 Each virtual maildir message file, when read, appears to have the exact content\r
  74 of the message referenced by the notmuch query, augmented with an 'X-Label'\r
  75 header generated automatically by notmuchfs, containing the notmuch tags of\r
  76 that message.\r
  77 \r
  78 \r
  79 Additional 'glue' scripts are provided to augment this, to integrate it more\r
  80 tightly with MUA-like tools, specifically 'mutt', giving the ability to alter\r
  81 notmuch tags, create new queries, etc.\r
  82 \r
  83 \r
  84 \r
  85 Why?\r
  86 ----\r
  87 I wanted to use notmuch with mutt. I didn't feel that ploughing though mutt's\r
  88 codebase to add tight integration was the quickest way to a result, so\r
  89 notmuchfs was born.\r
  90 \r
  91 I developed notmuchfs in 2011, but I am only now able to release it. In the\r
  92 mean-time, the excellent 'mutt-kz' was released, scratching my initial itch.\r
  93 \r
  94 Notmuchfs solves a broader problem - e.g. a notmuch-aware courier-imap is not\r
  95 too much of a stretch - so I think there is room for the different approaches.\r
  96 \r
  97 \r
  98 More information\r
  99 ----------------\r
 100  https://github.com/tsto/notmuchfs\r
 101  https://github.com/tsto/notmuchfs/blob/master/README.md\r
 102  https://github.com/tsto/notmuchfs/blob/master/README.MUTT.md\r
 103  https://github.com/tsto/notmuchfs/blob/master/ISSUES\r
 104 \r
 105 \r
 106 \r
 107 Perhaps this will scratch someone else's itch too.\r
 108 \r
 109 Tim\r
 110 \r
 111 -- \r
 112 Tim Stoakes\r