{"id":13467214,"url":"https://github.com/modmail-dev/Modmail","last_synced_at":"2025-03-26T01:30:30.825Z","repository":{"id":37428480,"uuid":"106154828","full_name":"modmail-dev/Modmail","owner":"modmail-dev","description":"A Discord bot that functions as a shared inbox between staff and members, similar to Reddit's Modmail.","archived":false,"fork":false,"pushed_at":"2024-10-27T14:02:56.000Z","size":7279,"stargazers_count":1580,"open_issues_count":48,"forks_count":4586,"subscribers_count":57,"default_branch":"master","last_synced_at":"2024-10-29T15:35:09.151Z","etag":null,"topics":["bot","discord","discord-api","discord-bot","discord-modmail","discord-py","modmail","python","python3"],"latest_commit_sha":null,"homepage":"https://docs.modmail.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/modmail-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/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},"funding":{"patreon":"kyber"}},"created_at":"2017-10-08T06:24:54.000Z","updated_at":"2024-10-27T14:03:01.000Z","dependencies_parsed_at":"2023-10-11T02:16:04.960Z","dependency_job_id":"fb32694e-c2eb-44e6-aa26-3ef321ee3ece","html_url":"https://github.com/modmail-dev/Modmail","commit_stats":{"total_commits":1994,"total_committers":73,"mean_commits":"27.315068493150687","dds":0.6088264794383149,"last_synced_commit":"041c4fdc78b2391d481ddeee50d0883b645557e7"},"previous_names":["kyb3r/modmail"],"tags_count":151,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2FModmail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2FModmail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2FModmail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/modmail-dev%2FModmail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/modmail-dev","download_url":"https://codeload.github.com/modmail-dev/Modmail/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245543424,"owners_count":20632648,"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","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":["bot","discord","discord-api","discord-bot","discord-modmail","discord-py","modmail","python","python3"],"created_at":"2024-07-31T15:00:54.155Z","updated_at":"2025-03-26T01:30:30.819Z","avatar_url":"https://github.com/modmail-dev.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/o558Qnq.png\" align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cstrong\u003e\u003ci\u003eA feature-rich Modmail bot for Discord.\u003c/i\u003e\u003c/strong\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n\n  \u003ca href=\"#\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Latest%20Version-v4.1.2-7289da?style=for-the-badge\u0026logo=data:image/gif;base64,R0lGODlhGAAYAPcAAAAAADQ+Yj5MdThCaEFOekNQfWt5e1lqfEdVhVpriVx1iVtsnFZpll1xlF1znFx5mGNtjGR7hWNzjGd5iWJunGNslmN0lGl1lGN5lWt7lWR0nGp1nWR5nGt8nHJ9l3J9jFxto1xtqlZqqF5zpF15pV10rVx5q1Z2ql1us150s114sV50uVd1smJupGNurGN0pGp1pGR6o2t7o2F0rml0rGR5rGt8q3J9pGNus2Fvu2Bzs2p2smR5s2t7tGF0u2N6vGp7u2l1uXJ+uGJ1wWV7w2l+xWl+yl5zwHWDiWyCmHODnHiGmHSLkW2CpGuEqnSCpHqMo3ODrHWKrXyMq3iHp3yTqGyEtWqFunKDs3uLtHSGvXSMvHuMu3eItnyTs3yTu3iUuW+RsV+ApmuCxG2Dy22LxnSMxHuMxHGGzXSLzXqLzXWFxXyTw3uSy3WSx26E0W+N2m+L1XKG03SL1XmL1HOL2HmL23WF2XiS1m+QyHOK4XmL4XaH4nGM5ImXm4WOlJSjnoOOq4OOpYSUrImXqJOcqYONt4OUtIybtIOUu4ycvImYt5OcuIyiqZekqYyiupOjvJurvJimtp+yvqKruae2ua23trLCucPHvIOMxoOUxIuaw4eYyJKbyISW1YiW0o2kyJWlxJqpxZWkzJury5aoxp6xxZ2zyZio1Jyy2Yuk0aOsyKOyxKOzzKy8zKq2yLO7xqOr1KSz1Ku706W026y73Ki21bK716u75LS95KSu4Zyx6bPDzLjGx63B2LPD1LTE3LvL3brI17/S2bbKzrTE47rF47zM5L3M67bH577R5L7R67zK8rjM8MLM3MPK1sTT3crU3MjW2dLZ2srUy8PN5MTO68nP68jL48TS5MnT5cbR68jS7M3b7Mva5dTb6MTO8srO8szF8MXR8snS8c3a8cnY+NXb9tDL7dnm6dzk8tro99Pq9uTp6+r17fr77eTr/efr+Oz09OXz/Ov0/e37/uj39fX19fX89fz+9vP1/fX9/f7//vr2/ODl4sK75yH5BAEAAAAALAAAAAAYABgAAAj/AAEAmFOnoMGDCAvGmRNHYMKHEOdIhEgRIcGKGDMeTJVO00WNBj194/frFik5IOvgqdaP371N26xpefORYq57/HI+s7Vtmy0eKCmmapcz575FPXt+SfHmociiRae1SroNWIoVTQ2uxAk15yJg1awl7ZSCaUE82uRxhTpt1TNXq0Ip2pSobIqCc0iVoqsI0ipXr1bhywfVXxYdiA3Sourz2dqc8lbNQJz4bDWqix73E7ZjhgrKOjYmvfWLbZcZqCdTPjjHGLdtibi2U5Q6NWiEqqq64ifvVe3at1nX2tTuWQ/QyIMfxHOGi+rkyeMklPMDuvWaBqlbj469IPUU2ykPCOw+53t4AAEBADs=\"\u003e\n  \u003c/a\u003e\n\n  \u003cbr\u003e\n  \n  \u003ca href=\"https://heroku.com/deploy?template=https://github.com/modmail-dev/modmail\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/deploy_to-heroku-997FBC.svg?style=for-the-badge\u0026logo=Heroku\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/modmail-dev/modmail/\"\u003e\n    \u003cimg src=\"https://api.modmail.dev/badges/instances.svg\" alt=\"Bot instances\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://discord.gg/cnUpwrnpYb\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/1079074933008781362.svg?label=Discord\u0026logo=Discord\u0026colorB=7289da\u0026style=for-the-badge\" alt=\"Support\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://patreon.com/kyber\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/patreon-donate-orange.svg?style=for-the-badge\u0026logo=Patreon\" alt=\"Patreon\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://www.python.org/downloads/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Made%20With-Python%203.10-blue.svg?style=for-the-badge\u0026logo=Python\" alt=\"Made with Python 3.10\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/ambv/black\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Code%20Style-Black-black?style=for-the-badge\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/modmail-dev/modmail/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-agpl-e74c3c.svg?style=for-the-badge\" alt=\"MIT License\"\u003e\n  \u003c/a\u003e\n\n\u003cbr\u003e\n\u003cimg src='https://i.imgur.com/fru5Q07.png' align='center' width=500\u003e\n\u003c/div\u003e\n\n\n## What is Modmail?\n\nModmail is similar to Reddit's Modmail, both in functionality and purpose. It serves as a shared inbox for server staff to communicate with their users in a seamless way.\n\nThis bot is free for everyone and always will be. If you like this project and would like to show your appreciation, you can support us on **[Patreon](https://www.patreon.com/kyber)**, cool benefits included! \n\nFor up-to-date setup instructions, please visit our [**documentation**](https://docs.modmail.dev/installation) page.\n\n## How does it work?\n\nWhen a member sends a direct message to the bot, Modmail will create a channel or \"thread\" into a designated category. All further DM messages will automatically relay to that channel; any available staff can respond within the channel.\n\nOur Logviewer will save the threads so you can view previous threads through their corresponding log link. ~~Here is an [**example**](https://logs.modmail.dev/example)~~ (demo not available at the moment).\n\n## Features\n\n* **Highly Customisable:**\n  * Bot activity, prefix, category, log channel, etc.\n  * Command permission system.\n  * Interface elements (color, responses, reactions, etc.).\n  * Snippets and *command aliases*.\n  * Minimum duration for accounts to be created before allowed to contact Modmail (`account_age`).\n  * Minimum length for members to be in the guild before allowed to contact Modmail (`guild_age`). \n\n* **Advanced Logging Functionality:**\n  * When you close a thread, Modmail will generate a log link and post it to your log channel.\n  * Native Discord dark-mode feel.\n  * Markdown/formatting support.\n  * Login via Discord to protect your logs ([premium Patreon feature](https://patreon.com/kyber)).\n  * See past logs of a user with `?logs`.\n  * Searchable by text queries using `?logs search`.\n\n* **Robust implementation:**\n  * Schedule tasks in human time, e.g. `?close in 2 hours silently`.\n  * Editing and deleting messages are synced.\n  * Support for the diverse range of message contents (multiple images, files).\n  * Paginated commands interfaces via reactions.\n\nThis list is ever-growing thanks to active development and our exceptional contributors. See a full list of documented commands by using the `?help` command.\n\n## Installation\n\nThere are a number of options for hosting your very own dedicated Modmail bot.\n\nVisit our [**documentation**](https://docs.modmail.dev/installation) page for detailed guidance on how to deploy your Modmail bot.\n\n### Patreon Hosting\n\nIf you don't want the trouble of renting and configuring your server to host Modmail, we got a solution for you! We offer hosting and maintenance of your own, private Modmail bot (including a Logviewer) through [**Patreon**](https://patreon.com/kyber).\n\n## FAQ\n\n**Q: Where can I find the Modmail bot invite link?**\n\n**A:** Unfortunately, due to how this bot functions, it cannot be invited. The lack of an invite link is to ensure an individuality to your server and grant you full control over your bot and data. Nonetheless, you can quickly obtain a free copy of Modmail for your server by following our [**documentation**](https://docs.modmail.dev/installation) steps or subscribe to [**Patreon**](https://patreon.com/kyber).\n\n**Q: Where can I find out more info about Modmail?**\n\n**A:** You can find more info about Modmail on our [**documentation**](https://docs.modmail.dev) page. If you run into any problems, join our [Modmail Discord Server](https://discord.gg/cnUpwrnpYb) for help and support.\n\n## Plugins\n\nModmail supports the use of third-party plugins to extend or add functionalities to the bot.\nPlugins allow niche features as well as anything else outside of the scope of the core functionality of Modmail. \n\nYou can find a list of third-party plugins using the `?plugins registry`  command or visit the [Unofficial List of Plugins](https://github.com/modmail-dev/modmail/wiki/Unofficial-List-of-Plugins) for a list of plugins contributed by the community.\n\nTo develop your own, check out the [plugins documentation](https://github.com/modmail-dev/modmail/wiki/Plugins).\n\nPlugins requests and support are available in our [Modmail Support Server](https://discord.gg/cnUpwrnpYb).\n\n## Sponsors\n\nSpecial thanks to our sponsors for supporting the project.\n\nSirReddit:\n\u003cbr\u003e\n\u003ca href='https://www.youtube.com/channel/UCgSmBJD9imASmJRleycTCwQ/featured'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/WyzaPKY.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nPrime Servers Inc:\n\u003cbr\u003e\n\u003ca href='https://primeserversinc.com/'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/sVcwtt8.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nReal Madrid:\n\u003cbr\u003e\n\u003ca href='https://discord.gg/realmadrid'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/9Rat2Qb.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nAdvertise Your Server:\n\u003cbr\u003e\n\u003ca href='https://discord.gg/zP8KcF4VQz'\u003e\n  \u003cimg height=100 src='https://user-images.githubusercontent.com/45324516/140673115-dd3e873c-36b6-4383-9eb4-db42e1986ab3.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nHelp Us • Help Other's:\n\u003cbr\u003e\n\u003ca href='https://discord.gg/5yQCFzY6HU'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/Gi3jxeH.gif' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nDiscord Advice Center:\n\u003cbr\u003e\n\u003ca href='https://discord.gg/zmwZy5fd9v'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/1hrjcHd.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\nBlacklight Promotions:\n\u003cbr\u003e\n\u003ca href='https://blacklightpromotions.online'\u003e\n  \u003cimg height=100 src='https://i.imgur.com/yLgE6h6.png' style='margin:5px'\u003e\n\u003c/a\u003e\n\n\nBecome a sponsor on [Patreon](https://patreon.com/kyber).\n\n## Contributing\n\nContributions to Modmail are always welcome, whether it be improvements to the documentation or new functionality, please feel free to make the change. Check out our [contributing guidelines](https://github.com/modmail-dev/modmail/blob/master/.github/CONTRIBUTING.md) before you get started.\n\nIf you like this project and would like to show your appreciation, support us on **[Patreon](https://www.patreon.com/kyber)**!\n\n## Beta Testing\n\nOur [development](https://github.com/modmail-dev/modmail/tree/development) branch is where most of our features are tested before public release. Be warned that there could be bugs in various commands so keep it away from any large servers you manage.\n\nIf you wish to test the new features and play around with them, feel free to join our [Public Test Server](https://discord.gg/v5hTjKC). Bugs can be raised within that server or in our Github issues (state that you are using the development branch though).\n","funding_links":["https://patreon.com/kyber","https://www.patreon.com/kyber)*","https://www.patreon.com/kyber)**!"],"categories":["Bots","Python"],"sub_categories":["Self Host-able Bots"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodmail-dev%2FModmail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmodmail-dev%2FModmail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmodmail-dev%2FModmail/lists"}