{"id":37180092,"url":"https://github.com/timorunge/notmuch2maildir","last_synced_at":"2026-04-02T19:21:08.222Z","repository":{"id":57499686,"uuid":"189736032","full_name":"timorunge/notmuch2maildir","owner":"timorunge","description":"notmuch2maildir is a simple CLI tool written in Go for searching your mails in a MUA like e.g. (neo)mutt using the Notmuch mail indexer.","archived":false,"fork":false,"pushed_at":"2026-03-26T21:28:39.000Z","size":29,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-27T08:56:25.450Z","etag":null,"topics":["maildir","mutt","neomutt","notmuch"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timorunge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-01T13:28:30.000Z","updated_at":"2026-03-26T21:34:32.000Z","dependencies_parsed_at":"2022-08-28T20:00:29.350Z","dependency_job_id":null,"html_url":"https://github.com/timorunge/notmuch2maildir","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/timorunge/notmuch2maildir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timorunge%2Fnotmuch2maildir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timorunge%2Fnotmuch2maildir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timorunge%2Fnotmuch2maildir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timorunge%2Fnotmuch2maildir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timorunge","download_url":"https://codeload.github.com/timorunge/notmuch2maildir/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timorunge%2Fnotmuch2maildir/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["maildir","mutt","neomutt","notmuch"],"created_at":"2026-01-14T20:56:39.503Z","updated_at":"2026-04-02T19:21:08.191Z","avatar_url":"https://github.com/timorunge.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# notmuch2maildir\n\n[![Go Report](https://goreportcard.com/badge/github.com/timorunge/notmuch2maildir)](https://goreportcard.com/report/github.com/timorunge/notmuch2maildir)\n[![Build Status](https://travis-ci.org/timorunge/notmuch2maildir.svg?branch=master)](https://travis-ci.org/timorunge/notmuch2maildir)\n\n`notmuch2maildir` is a simple CLI tool written in Go for searching your mails in\na MUA like e.g. ([neo](https://neomutt.org/))[mutt](http://mutt.org/) using the\n[Notmuch](https://notmuchmail.org/) mail indexer.\n\nThe idea is based of the\n[original version](https://notmuchmail.org/notmuch-mutt/) of the `mutt-notmuch`\nscript and [mutt-notmuch-py](https://github.com/honza/mutt-notmuch-py). The\nimplementation in Go is - for large search results - significantly faster.\n\n## Install\n\nYou can use an [official\nrelease](https://github.com/timorunge/notmuch2maildir/releases) of `notmuch2maildir`.\nThe tarballs for each release contain the `notmuch2maildir` CLI applicaton.\n\nCopy the binary in your `$PATH` or call it directly via\n`$YOURDIR/notmuch2maildir`.\n\nTo get the latest version of `notmuch2maildir` just run `go get`.\n\n```sh\ngo get github.com/timorunge/notmuch2maildir/cmd/notmuch2maildir\n```\n\nIf `$GOPATH/bin` is not in your `$PATH` call `notmuch2maildir` directly via\n`$GOPATH/bin/notmuch2maildir`.\n\n## Usage\n\nFor the usage it's required that `notmuch` itself is in your `$PATH` (or use\nthe hidden command line flag `-n` / `--notmuch-executable`).\n\n```sh\nUsage:\n  notmuch2maildir [OPTIONS] \u003csearch | thread | version\u003e\n\nApplication Options:\n  -c, --notmuch-config=     Notmuch configuration file which should be used (default: ~/.notmuch-config)\n  -o, --output-dir=         Output directory for storing the Notmuch search results (default: ~/.cache/notmuch/mutt_results)\n\nHelp Options:\n  -h, --help                Show this help message\n\nAvailable commands:\n  search   Just search Notmuch\n  thread   Display a entire mail thread using Notmuch\n  version  Show the version of notmuch2maildir\n```\n\n`notmuch2maildir` is not creating the parent directory for the search results.\n\n### Search\n\nThe search command is creating a maildir based on the search query.\n\n```\nUsage:\n  notmuch2maildir [OPTIONS] search QUERY\n\nJust search Notmuch\n\nApplication Options:\n  -c, --notmuch-config=     Notmuch configuration file which should be used (default: ~/.notmuch-config)\n  -o, --output-dir=         Output directory for storing the Notmuch search results (default: ~/.cache/notmuch/mutt_results)\n\nHelp Options:\n  -h, --help                Show this help message\n\n[search command options]\n      -p, --promt           Opens a promt to enter the search query\n```\n\n### Thread\n\nThe thread command is creating a maildir based on the `message-id` of a\nsource mail.\n\n```\nUsage:\n  notmuch2maildir [OPTIONS] thread STDIN\n\nDisplay a entire mail thread using Notmuch\n\nApplication Options:\n  -c, --notmuch-config=     Notmuch configuration file which should be used (default: ~/.notmuch-config)\n  -o, --output-dir=         Output directory for storing the Notmuch search results (default: ~/.cache/notmuch/mutt_results)\n\nHelp Options:\n  -h, --help                Show this help message\n\n[thread command options]\n      -m, --message-id=     The message-id of the source mail\n```\n\n## (neo)mutt configuration\n\nChose the interactive or the query mode and add the following snippets to your\n`muttrc`.\n\n### Search\n\n#### Promt mode\n\n```\nmacro index / \"\u003center-command\u003eunset wait_key\u003center\u003e\u003cshell-escape\u003enotmuch2maildir search -p\u003center\u003e\u003cchange-folder-readonly\u003e~/.cache/notmuch/search_results\u003center\u003e\" \\\n            \"Search mail (using Notmuch)\"\n```\n\n#### Query mode\n```\nmacro index / \"\u003center-command\u003eunset wait_key\u003center\u003e\u003cshell-escape\u003eread -p 'Search query: ' query; notmuch2maildir search -q \\$query\u003center\u003e\u003cchange-folder-readonly\u003e~/.cache/notmuch/search_results\u003center\u003e\" \\\n            \"Search mail (using Notmuch)\"\n```\n\n### Reconstruct thread\n\n```\nmacro index T \"\u003center-command\u003eunset wait_key\u003center\u003e\u003cpipe-message\u003enotmuch2maildir thread\u003center\u003e\u003cchange-folder-readonly\u003e~/.cache/notmuch/search_results\u003center\u003e\" \\\n            \"Search and reconstruct thread (Using notmuch)\"\n```\n\n## License\n\n[BSD 3-Clause \"New\" or \"Revised\" License](LICENSE)\n\n## Author Information\n\n- Timo Runge\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimorunge%2Fnotmuch2maildir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimorunge%2Fnotmuch2maildir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimorunge%2Fnotmuch2maildir/lists"}