{"id":15129908,"url":"https://github.com/virtomize/mail2most","last_synced_at":"2026-01-12T07:38:26.456Z","repository":{"id":49449429,"uuid":"194080459","full_name":"Virtomize/mail2most","owner":"Virtomize","description":"watch emails and send them to mattermost","archived":false,"fork":false,"pushed_at":"2025-03-22T06:28:37.000Z","size":4464,"stargazers_count":78,"open_issues_count":18,"forks_count":20,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-06T15:47:39.810Z","etag":null,"topics":["docker","docker-compose","email","email-parsing","filtering","golang","golang-application","imap","integration","mattermost","mattermost-bot"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Virtomize.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2019-06-27T11:10:19.000Z","updated_at":"2025-04-03T04:29:21.000Z","dependencies_parsed_at":"2024-06-18T22:45:32.754Z","dependency_job_id":"88c036aa-78be-4177-9b23-fbf9cd026de1","html_url":"https://github.com/Virtomize/mail2most","commit_stats":null,"previous_names":["cseeger-epages/mail2most"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/Virtomize/mail2most","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Virtomize%2Fmail2most","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Virtomize%2Fmail2most/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Virtomize%2Fmail2most/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Virtomize%2Fmail2most/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Virtomize","download_url":"https://codeload.github.com/Virtomize/mail2most/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Virtomize%2Fmail2most/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006351,"owners_count":26084086,"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-11T02:00:06.511Z","response_time":55,"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":["docker","docker-compose","email","email-parsing","filtering","golang","golang-application","imap","integration","mattermost","mattermost-bot"],"created_at":"2024-09-26T02:23:21.850Z","updated_at":"2026-01-12T07:38:26.446Z","avatar_url":"https://github.com/Virtomize.png","language":"Go","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=VBXHBYFU44T5W\u0026source=url"],"categories":[],"sub_categories":[],"readme":"[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=VBXHBYFU44T5W\u0026source=url)\n[![GoDoc](https://img.shields.io/badge/godoc-reference-green.svg)](https://godoc.org/github.com/virtomize/mail2most/lib)\n[![Go Report Card](https://goreportcard.com/badge/github.com/virtomize/mail2most)](https://goreportcard.com/report/github.com/virtomize/mail2most)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/virtomize/mail2most/blob/master/LICENSE)\n[![Built with Mage](https://magefile.org/badge.svg)](https://magefile.org)\n\n[![Tests](https://github.com/Virtomize/mail2most/actions/workflows/test.yml/badge.svg?branch=master\u0026event=push)](https://github.com/Virtomize/mail2most/actions/workflows/test.yml)\n[![Docker image](https://github.com/Virtomize/mail2most/actions/workflows/docker.yaml/badge.svg?branch=master\u0026event=schedule)](https://github.com/Virtomize/mail2most/actions/workflows/docker.yaml)\n[![Trivy Scan](https://github.com/Virtomize/mail2most/actions/workflows/trivy.yaml/badge.svg?branch=master\u0026event=schedule)](https://github.com/Virtomize/mail2most/actions/workflows/trivy.yaml)\n\n# [![Mail2Most](https://user-images.githubusercontent.com/13348918/60418882-560c3480-9be4-11e9-9f30-b0124a162630.png)](https://github.com/virtomize/mail2most)\n\nFilter emails from mail accounts and send them to mattermost.\n\n![mail2most-image](https://user-images.githubusercontent.com/13348918/60437141-ff1b5500-9c0d-11e9-913f-ae7c4a034b10.png)\n\n# Features\n\n- IMAP(S) support\n- StartTLS support\n- Mattermost v4 API support\n- HTML 2 Markdown support\n- Filter mails by Folder\n- Filter mails by From\n- Filter mails by To\n- Filter mails by Subject\n- Filter mails by TimeRange\n- Mattermost broadcasts\n- Choose to post Subject and Body or Subject only\n- Option to post mail body as a thread reply under the subject\n- Send to channels and/or users\n- Profile management including default profiles\n- Mail attachment support\n\nMissing feature or found a bug ? Feel free to open an [issue](https://github.com/virtomize/mail2most/issues) and let us know !\n\n## Donation\n\nIf this project helps you, feel free to give us a cup of coffee :).\n\n[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=VBXHBYFU44T5W\u0026source=url)\n\n# Install\n\n## download\n\nDownload [Latest Release Version](https://github.com/virtomize/mail2most/releases/latest)\n\n## build it yourself\n\nYou can compile the project yourself using this repo and [mage](https://magefile.org).\nJust clone the repo and run `mage build`, you can find the binary under `bin/mail2most`\n\n# Usage\n\n- create a mattermost user\n- create or use an existsing email user to connect to your mail server via IMAP\n- edit `conf/mail2most.conf` and configure your mail and mattermost credentials\n- configure your filters\n- run Mail2Most `./mail2most` or with config path `./mail2most -c conf/mail2most.conf`\n\n# Version Info\n\n- run `./mail2most -version` to get current version information\n\n## example conf - filter descriptions\n\n**just configure the filters you need if a filter is not defined it is not used !**\n\nsee [example configuration](https://github.com/virtomize/mail2most/blob/master/conf/mail2most.conf) for more details.\n\n# Run Mail2Most as a service\n\nYou can run Mail2Most using docker, docker-compose or as a systemd service.\n\n## docker\n\n[docker-hub link](https://hub.docker.com/r/virtomize/mail2most)\n\nUsing docker you need to change the path to your mail2most.conf\n\n```\ndocker run \\\n  -v /path/to/mail2most.conf:/mail2most/conf/mail2most.conf \\\n  virtomize/mail2most:latest\n```\n\ne.g. if you are in this repo:\n\n```\ndocker run \\\n  -v $(pwd)/conf/mail2most.conf:/mail2most/conf/mail2most.conf \\\n  virtomize/mail2most:latest\n```\n\n\u003e [!NOTE]\n\u003e The `latest` tag image is rebuild on a daily base to get newest OS package updates inside the docker image.\n\n## docker-compose\n\n[docker-hub link](https://hub.docker.com/r/virtomize/mail2most)\n\nUsing docker-compose you can just edit the `conf/mail2most.conf` or change the path inside the docker-compose.yml to your config:\n\n```\n    volumes:\n      - ./conf/mail2most.conf:/mail2most/conf/mail2most.conf\n```\n\nneeds to be changed to\n\n```\n    volumes:\n      - /path/to/my/mail2most.conf:/mail2most/conf/mail2most.conf\n```\n\nthen just start a container user\n\n```\ndocker-compose up -d\n```\n\n## Systemd\n\nSystemd allows you to create a background service to run mail2most managed by your system:\n\n- create `/opt/mail2most` and place the mail2most binary into it\n  - `mkdir -p /opt/mail2most/conf`\n- create `/opt/mail2most/conf/mail2most.conf`\n- place the following file to `/etc/systemd/system/mail2most.service`\n\n```\n# mail2most\n[Unit]\nDescription=mail2most\n\n[Service]\nType=simple\nWorkingDirectory=/opt/mail2most\nExecStart=/opt/mail2most/mail2most -c /path/to/mail2most.conf\nRestart=always\nRestartSec=60\n\n[Install]\nWantedBy=multi-user.target\n```\n\nenable and start using\n\n```\nsystemctl enable mail2most\nsystemctl start mail2most\n```\n\n\u003e [!Note]\n\u003e Make sure to use the absolute path to your mail2most configuration file.\n\n## Common problems\n\n**Problem: mail2most crashes after profile changes**\n\nSolution: This happens when the data.json is not consistent to the config changes. Delete data.json to solve this problem.\n\n**Problem: Channel contains special characters mattermost can not found the channel**\n\nSolution: Mattermost does not support special characters for channel names, only in display names. To find the correct channel name use the last part of the url found under `view info`\n\n# Contribution to Mail2Most\n\nThank you for participating to this project.\nPlease see our [Contribution Guidlines](https://github.com/virtomize/mail2most/blob/master/CONTRIBUTING.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirtomize%2Fmail2most","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvirtomize%2Fmail2most","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvirtomize%2Fmail2most/lists"}