Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Oxlac/MR.DM
A quick and easy tool for automating your Instagram DMs.
https://github.com/Oxlac/MR.DM
instagram instagram-bot instagram-dm instagram-dm-bot python selenium-python trc-woc
Last synced: 3 months ago
JSON representation
A quick and easy tool for automating your Instagram DMs.
- Host: GitHub
- URL: https://github.com/Oxlac/MR.DM
- Owner: Oxlac
- License: mit
- Created: 2023-12-26T19:45:22.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-01-22T09:11:47.000Z (10 months ago)
- Last Synced: 2024-06-16T17:46:31.976Z (5 months ago)
- Topics: instagram, instagram-bot, instagram-dm, instagram-dm-bot, python, selenium-python, trc-woc
- Language: Python
- Homepage: https://mr-dm.oxlac.com
- Size: 1.5 MB
- Stars: 24
- Watchers: 1
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
MR.DM
A quick and easy tool for automating your Instagram DMs.
Visit the Website »
View Demo
·
Read Docs
.
Report Bug
·
Request Feature
.
Discord Server
Table of Contents
## About The Project
[![MR.DM Screen Shot][product-screenshot]](https://mr-dm.oxlac.com)
MR.DM is a tool for automating your Instagram DMs. Sending marketing messages about your newly launched products to your followers is a tiring process to accomplish manually. MR.DM can solve all of that in just 3 simple steps.
1. Login to your Instagram account.
2. Load the Accounts you want to send the message to from various sources.
3. Enter the message you want to send and click send.
MR.DM will take care of the rest. It will send the message to all the accounts you have loaded.
>[!CAUTION]
> Please use this tool responsibly. Do not spam people with messages. This tool was created for educational purposes only. The creator of this tool is not responsible for any misuse of this tool.
### Features
* Send messages to thousands of accounts.
* Multiple accounts support.
* Load target accounts from followers, following, hashtag(coming soon)
* Manually add accounts to send messages to.
* Export and import target accounts as CSV files.
* Send multiple messages to the same account.
* Send Links, posts, and normal text messages.
* Send pictures and videos(coming soon)
* Monitor the progress of the messages being sent.
### Built With
* [Python](https://www.python.org/)
* [Selenium](https://www.selenium.dev/)
* [Kivy](https://kivy.org/)
* [KivyMD](https://kivymd.readthedocs.io/en/latest/)
* [InstaLoader](https://instaloader.github.io/)
## Getting Started
MR.DM is a desktop application. It is available for Windows, Linux, and Mac. You can download the latest executable version from [github releases](https://github.com/oxlac/mr.dm/releases). Or you can build it from the source
with the following instructions.
> [!WARNING]
> You must disable your antivirus before running the executable on windows. For more information, please read [this](https://github.com/pyinstaller/pyinstaller/issues?q=label%3Aantivirus-false-positives+is%3Aclosed)
### Installation
> [!WARNING]
> MR.DM only works on python versions 3.11 and above
1. Clone the repo
```sh
git clone https://github.com/oxlac/mr.dm.git
```
2. Install Requirements
```sh
pip install -r requirements.txt
```
3. Run the app
```sh
python main.py
```
## Usage
MR.DM can be used for sending out messages to thousands of your followers and also other accounts. It was created for educational purposes only. Please use it responsibly. Below are the various steps to use MR.DM.
1. Login to your Instagram account.
![Login Screen][login-screenshot]
![Login Screen 2][login-screenshot2]
2. Load the Accounts you want to send the message to from various sources.
![Load Accounts Screen][load-accounts-screenshot]
3. Enter the message you want to send and click send.
![Send Message Screen][send-message-screenshot]
You can view the status of the messages being sent on the progress screen. MR.DM uses selenium to automate the process of sending messages. So you can use your computer while the messages are being sent. But please do not close the browser window that opens up. You can minimize it though.
![Progress Screen][progress-screenshot]
## Roadmap
- [ ] Add Accounts that have posted with a specific hashtag.
- [ ] Add Accounts that have interacted with certain hashtags.
- [ ] Add an account from their Instagram profile link.
- [ ] Add accounts that have interacted with a specific post.
- [ ] Ability to send pictures and videos.
- [ ] Cleaning up Documentation and Adding Sphinx Autodoc. ( Under Progress by admins)
See the [open issues](https://github.com/oxlac/mr.dm/issues) for a full list of proposed features (and known issues). If you have any other ideas, please open an issue and let us know.
## Contributing
Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Ensure that your code passes the ruff linter. If it does not pass view the errors and fix them.
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE.txt` for more information.
## Contact
Your Name - [@Oxlac_](https://twitter.com/Oxlac_) - [email protected]
Discord Server - [https://discord.gg/2YdnSGHdET](https://discord.gg/2YdnSGHdET)
Project Link: [https://github.com/oxlac/mr.dm](https://github.com/oxlac/mr.dm)
## Disclaimer
This tool is not affiliated with Instagram in any way. It is an independent project created for educational purposes only. The creator of this tool(oxlac and any other contributors) is not responsible for any misuse of this tool.
[contributors-shield]: https://img.shields.io/github/contributors/oxlac/mr.dm.svg?style=for-the-badge
[contributors-url]: https://github.com/oxlac/mr.dm/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/oxlac/mr.dm.svg?style=for-the-badge
[forks-url]: https://github.com/oxlac/mr.dm/network/members
[stars-shield]: https://img.shields.io/github/stars/oxlac/mr.dm.svg?style=for-the-badge
[stars-url]: https://github.com/oxlac/mr.dm/stargazers
[issues-shield]: https://img.shields.io/github/issues/oxlac/mr.dm.svg?style=for-the-badge
[issues-url]: https://github.com/oxlac/mr.dm/issues
[license-shield]: https://img.shields.io/github/license/oxlac/mr.dm.svg?style=for-the-badge
[license-url]: https://github.com/oxlac/mr.dm/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/linkedin_username
[product-screenshot]: assets/main_image.png
[login-screenshot]: assets/login.png
[login-screenshot2]: assets/login_2.png
[load-accounts-screenshot]: assets/main_image.png
[send-message-screenshot]: assets/send_message.png
[progress-screenshot]: assets/progress.png