volcanocoder/mr.dm

A quick and easy tool for automating your Instagram DMs.

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

1. About The Project
   • Features
   • Built With
2. Getting Started
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

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.

(back to top)

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
• Selenium
• Kivy
• KivyMD
• InstaLoader

(back to top)

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. 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

Installation

Warning

MR.DM only works on python versions 3.11 and above

1. Clone the repo

   git clone https://github.com/oxlac/mr.dm.git

2. Install Requirements

    pip install -r requirements.txt

3. Run the app

    python main.py

(back to top)

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.

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.

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.

(back to top)

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 for a full list of proposed features (and known issues). If you have any other ideas, please open an issue and let us know.

(back to top)

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.
5. Push to the Branch (git push origin feature/AmazingFeature)
6. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Your Name - @Oxlac_ - [email protected]

Discord Server - https://discord.gg/2YdnSGHdET

Project Link: https://github.com/oxlac/mr.dm

(back to top)

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.