{"id":17179117,"url":"https://github.com/flashmob/maildir-processor","last_synced_at":"2026-02-25T06:04:13.266Z","repository":{"id":144202471,"uuid":"83183609","full_name":"flashmob/maildir-processor","owner":"flashmob","description":"MailDir processor package for https://github.com/flashmob/go-guerrilla","archived":false,"fork":false,"pushed_at":"2017-03-18T13:39:39.000Z","size":8,"stargazers_count":21,"open_issues_count":0,"forks_count":8,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-20T17:48:15.246Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flashmob.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-02-26T04:50:53.000Z","updated_at":"2024-08-04T01:51:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"61605b2a-e399-4457-b2e4-28df6e3a66fc","html_url":"https://github.com/flashmob/maildir-processor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/flashmob/maildir-processor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashmob%2Fmaildir-processor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashmob%2Fmaildir-processor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashmob%2Fmaildir-processor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashmob%2Fmaildir-processor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashmob","download_url":"https://codeload.github.com/flashmob/maildir-processor/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashmob%2Fmaildir-processor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278366553,"owners_count":25975089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-15T00:24:53.812Z","updated_at":"2025-10-04T19:34:06.837Z","avatar_url":"https://github.com/flashmob.png","language":"Go","readme":"# Maildir processor for the [Go-guerrilla](https://github.com/flashmob/go-guerrilla) package.\n\nMaildir is a popular email storage format.\n\n## About\n\nThis package is a _Processor_ for the Go-Guerrilla default backend implementation. Use for this in your project\nif you are using Go-Guerrilla as a package and you would like to add the ability to deliver emails to Maildir folders, using Go-Guerrilla's default backend. \n\n## Usage\n\nImport `\"github.com/flashmob/maildir-processor\"` to your Go-guerrilla project.\nAssuming you have imported the go-guerrilla package already, and all dependencies.\n\nThen, when [using go-guerrilla as a package](https://github.com/flashmob/go-guerrilla/wiki/Using-as-a-package), do something like this\n\n```go\n\n\ncfg := \u0026AppConfig{\n    LogFile:      \"stderr\",\n    AllowedHosts: []string{\"example.com\"},\n    BackendConfig: backends.BackendConfig{\n        \"save_process\" : \"HeadersParser|Debugger|MailDir\",\n        \"validate_process\": \"MailDir\",\n        \"maildir_user_map\" : \"test=-1:-1\",\n        \"maildir_path\" : \"_test/Maildir\",\n    },\n}\nd := Daemon{Config: cfg}\nd.AddProcessor(\"FastCGI\", fastcgi_processor.Processor)\n\nd.Start()\n\n// .. keep the server busy..\n\n```\n\nNote that here we've added MailDir to the end of the save_process config option, \nthen used the d.AddProcessor api call to register it. Then configured other settings.\n\nSee the configuration section for how to configure. \n\n\n## Configuration\n\nThe following values are required in your `backend_config` section of your JSON configuration file\n\n* `maildir_path` - string. maildir_path may contain a `[user]` placeholder. This will be substituted at run time\neg `/home/[user]/Maildir` will get substituted to `/home/test/Maildir` for `test@example.com`\n* `maildir_user_map` - string. This is a string holding user to group/id mappings - in other words, the recipient table,\neach record separated by \",\" where records have the following format: `\u003cusername\u003e=\u003cid\u003e:\u003cgroup\u003e`\u003cbr\u003e\nExample: `\"test=1002:2003,guerrilla=1001:1001\"` . Use -1 for `\u003cid\u003e` \u0026 `\u003cgroup\u003e` if you want to ignore these, otherwise get these numbers from /etc/passwd\n \nDon't forget to add `MailDir` to the end of your `save_process` config option, eg:\n\n`\"save_process\": \"HeadersParser|Debugger|Hasher|Header|MailDir\",`\n\nalso add `MailDir` to the end of your `validate_process` config option, eg:\n\n`\"validate_process\": \"MailDir\",`\n\n## Example\n\nTake a look at [Maildiranasaurus](https://github.com/flashmob/maildiranasaurus) - an SMTP server that uses Go-Guerrilla as a \npackage and adds Maildir delivery using this package.\n\n## Credits\n\nThis package depends on Simon Lipp's [Go MailDir](https://github.com/sloonz/go-maildir) package.\n\n\n\n\n \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashmob%2Fmaildir-processor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashmob%2Fmaildir-processor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashmob%2Fmaildir-processor/lists"}