Instagram Bot :robot:

July 14, 2021

<p align="center"> <img src="InstagramBot.jpg" /> </p>

Overview 👍

A multifunctionality automated instagram bot that can mass text users, receive and read a message and store it somewhere with user details and much more. Powered by Selenium.

<img src="powered-by-selenium.svg" /> <img src="built-by-flask.svg" /> <img src="designed-by-bootstrap.svg" /> <img src="license-mit.svg" /> <br>

Get Started 🤞

<li> PIPENV: For virtual environment </li> <p><code> $ pip install pipenv </code></p> <br> <li> Installing required libraries and versions </li> <p><code> $ pipenv install </code></p> <br> <li> Starting the PIP virtual environment </li> <p><code> $ pipenv shell </code></p> <br>

Launching Instagrambot Web App 🎮

<br>

Inside the virtual environment, type:

<p><code> $ flask run </code></p>

and open the URL.

<br>

Multipurpose Bot 🛰️ 🛰

• Login-out using credentials

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.logout()

<br>

• Direct Message anyone

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.dm('user','Hi there')
bot.logout()

<br>

• Follow another user

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.follow_users(['user1','user2'])
bot.logout()

<br>

• Like a number of posts by a user/hashtag

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.like_by_keyword(keyword, numOfPosts)
bot.logout()

<br>

• Create a group and direct message in it

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.group_dm(['user1','user2', 'user3'],'Final Testing')
bot.logout()

<br>

• Direct Message multiple users

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.multiple_dm(['user1','user2', 'user3'],'Final Testing')
bot.logout()

<br>

• Direct Message multiple users from a csv file

from BOT import Bot
bot = Bot()
bot.login(username, password)
# if csv file doesn't contains message column
bot.multiple_dm_from_csv('path to csv file','general message')
# else
bot.multiple_dm_from_csv('path to csv file') 
bot.logout()

<br>

• Direct Message multiple users from a db

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.multiple_dm_from_db(general_message)
bot.logout()

<br>

• Direct Message to all Followers

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.multiple_dm_followers(general_message)
bot.logout()

<br>

• Retrieve the latest message from multiple user

<p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.retrieve_messages([users])
bot.logout()

<br>

• Retrieve the latest message from multiple user in a csv file

<p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.retrieve_messages_from_csv('path to csv file')
bot.logout()

<br>

• Retrieve the latest message from users from our inbox

<p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.retrieve_messages_from_inbox(tolerance = 2)
bot.logout()

<br>

• Download posts by a keyword

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.download_pics(keyword)
bot.logout()

<br>

• Share latest post according to preferred category (as in replied message):

from BOT import Bot
bot = Bot()
bot.login(username, password)
bot.share_latest_post()
bot.logout()

<br>

Individual Functionalities:

<ul> <li> Login into Instagram: (Achieved)

from __login__ import Login

Login(driver, <username>, <password>)

<br> </li> <li> Texting to a Single User: (Achieved)

from __dm__ import 

Dm(driver, <user>, <message>)

<br> </li> <li> Following Users: (Achieved)

from __follow_users__ import Follow_users

Follow_users(driver, ['user1','user2'])

<br> </li> <li> Retrieving messages from single/multiple user(s): (Achieved) <p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from __retrieve_messages__ import Retrieve_messages

Retrieve_messages(driver, [users])

<br> </li> <li> Retrieving messages from single/multiple user(s) with names in a csv file: (Achieved) <p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from __retrieve_messages_from_csv__ import Retrieve_messages_from_csv

Retrieve_messages_from_csv(driver, 'path to csv file')

<br> <li> Retrieving messages from single/multiple user(s) from inbox: (Achieved) <p><b> &nbsp &nbsp UPDATE THE IMAGES DIRECTORY WITH SCREENSHOTS TAKEN FROM YOUR COMPUTER</b></p> <p><b> &nbsp &nbsp UPDATE THE DATABASE CREDENTIALS IN db_credentials.py FILE</b></p> <p> For further reference watch this video: https://www.youtube.com/watch?v=XI_GyOnw3M0 </p>

from __retrieve_messages_from_inbox__ import Retrieve_messages_from_inbox

Retrieve_messages_from_inbox(tolerance = 1)

<br> </li> <li> Texting to Multiple Users: (Achieved)

from __multiple_dm__ import Multiple_dm

Multiple_dm(driver, [users], <message>)

<br> </li> <li> Texting to Multiple Users from a csv file: (Achieved)

from __multiple_dm_from_csv__ import Multiple_dm_from_csv

Multiple_dm_from_csv(driver, 'path to csv file', <general message (optional)>)

<br> </li> <li> Texting to Multiple Users from a Database: (Achieved)

from __multiple_dm_from_db__ import Multiple_dm_from_db

Multiple_dm_from_db(driver, <general message (optional)>)

<br> </li> <li> Texting to all Followers: (Achieved)

from __multiple_dm_followers__ import Multiple_dm_followers

Multiple_dm_followers(driver, <general message (optional)>)

<br> </li> <li> Creating Group and texting in it: (Achieved)

from __group_dm__ import Group_dm 

Group_dm(driver, [users], <message>)

<br> </li> <li> Downloading a number of posts with a keyword: (Achieved)

from __download_pics__ import Download_pics

Download_pics(driver, <keyword>)

<br> </li> <li> Liking a number of posts of a user/hashtag: (Achieved)

from __like_by_keyword__ import Like_by_keyword

Like_by_keyword(driver, <keyword>)

<br> </li> <li> Logging Out: (Achieved)

from __logout__ import Logout

Logout(driver)

<br> </li> <li> GUI app: (On the way)</li> </ul> <br>

<b> Platform:</b> Python files. Virtual Environment using PIPENV.

<b> Libraries:</b> Selenium, Instabot, InstaPy, Time, Pyperclip, Pyautogui, OpenCv, os, wget, pymongo

<b> Softwares:</b> Windows Chromedriver, MongoDB

<b> Low-Level Specs:</b> Whole program is built in Object Oriented fashion and Modular structure is followed throughout.