⛔ DISCLAIMER 1: This is an unofficial library and offers no warranty! The developers and contributors of the project do not assume any responsibility in case of ban of your account. Use of instagram bots does not comply with the terms of the service: use this software at your own risk. A "bot" is legal software, but the use of a bot continuously violates the terms of use of Instagram and you risk a: soft ban (such as limited actions or follow-up) or you risk ban with suspension for a few days (or permanent). All trademarks and logos belong to their respective owners.
⛔ DISCLAIMER 2: The API (on which the bot is partially based) login ( just for the first login of the profile ) can cause the creation of a warning email about a new access to instagram from a new device (samsung phone usually)
This project is free, and I try to provide excellent free support. Why donate? I work on this project several hours a week or in my spare time and try to keep it up to date and working. This cannot be done without your financial support, even small. There are professional bots that saves passwords on the cloud for €14/month: we want to protect your passwords and offer you a better product than others storing all the datas locally on your machine. A lower donation would allow continuous development, ever better quality and the realization of this dream. THANK YOU!
🔵 ACTIONS: With the term actions are identified the buttons at the start of each page. Then name of the button can be read by hovering the mouse on it.
⚫ LABELS: Each input, label, button has a label on it with a small description of the element, it is readable by hovering the mouse on it.
🔴 API: This bot uses a Nodejs instagram-private-api for upload medias. If you have the 2FA enabled for do the login you are going to insert two times the 2FA code, once for thw browser login and once for the api login.
✏️ LIST FIELDS: Each list field to fill in the bot settings has to respect the following format: elem1 & elem2 & elem3 ....
Instagram api manual:
- 📒 Dashboard
- 🔨 In development
- 📘 Profiles
- 📕 Images
- 📗 Posts
- 📙 Stories
- 🎬 actions
- 🌀 Auto Story
- 📔 Stats
- 📒 Logs
- 💢 Issues
- 🔨 In development
From this panel you can manage the account settings, create/delete new profiles and start/stop bots.- All the given datas are stored LOCALLY on your machine. There are no cloud services so all the informations are securely saved and ONLY YOU can read them.
- ⚡ Run: Runs the bot of the current selected profile.
- ⚡ Save settings: Save the settings of the selected profile. Each time that you edit something be sure to save it before running the bot.
- ⚡ Api login: Does the login in the private api for the selected profile
- ⚡ New profile creation:
- Write the profile name in the Create new profile field. If you want to reuse the settings already wrote for another profile before than write the name in the Create new profile field select the wanted profile.
- Compile the setting
- Click the Save settings button and the profile will automatically created.
- ⚡ Run All: Runs all the bots of the saved profiles.
- ⚡ Stop: Stop the bot of the selected profile. For stop a bot is possible to simply close the window of the bot.
- ⚡ Stop All: Stop all the running bots.
- ⚡ Clear Fields: Clears all the fields withot saving/deleting anithing.
- ⚡ Delete Profile: Delete the selected profile and all the related datas ( except for the images )
- ⚡Clear Session: Clear all the datas of the session in the browser and in the api.
- ⚡ username : your login username
- ⚡ password : your login password
- if the account has 2FA enabled and the Auto post/story is active the code will be sent twice, once for thw API login and once for the Brwoser login.
- The login is made only once (if the previous session is valid). It can be made again by clearing the profile session with the action Clear Session
- ⚡ follow public : Allow the bot to the public profiles
- ⚡ follow private : Allow the bot to follow the private profiles
- ⚡ follow no post : Allow the bot to follow profiles without posts
- ⚡ left comment : Allow the bot to left a custom comment under the posts of the visited user
- ⚡ left like : Allow the bot to left a like under the posts of the visited user
- ⚡ left message : Allow the bot to left a dm to the visited user
- ⚡ unfollow : Allow the bot to unfollow someone
- The unfollow action is made only on profiles that the bot has previously followed.
-
Each interaction value is valid only if the corresponding interaction status is active. For example if you set number of likes = 3 but the left like interaction is not active the number of likes are ignored
-
⚡ number of likes: The number of likes that the bot has to left on the visited profile. if number of likes = 3 it will like the last 3 post of the user.
-
⚡ pages for profile collection : A list of pages from where the bot collect the profiles with which interact. ( & separator )
-
⚡ number of comments : The number of comments that the bot has to left on the visited profile.
-
⚡ comment : A list of commets from where the bot can choiche for pick a comment to left. ( & separator )
-
⚡ message : A list of messages from where the bot can choiche for pick a text to send to the visited user. ( & separator )
-
⚡ delay : The delay that the bot has to sleep before to start another Interactions cycle with the next user. Interactions with user1 + unfollow ---> sleep delay ---> Interactions with user2 + unfollow ---> sleep delay ---> ....
-
⚡ start unfollow: The number of people that the bot has to follow before that it starts to unfollow someone. if start unfollow = 100 it will start to unfollow after 100 profiles followed.
-
⚡ random actions: This setting randomize the actions:
- likes: The bot will left a random number of likes, from 1 to number of likes.
- comments: The bot will left a random number of comments, from 1 to number of comments.
- follow: The bot will follow or not the visited profile.
- unfollow: The bot will unfollow or not someone.
- messages: THe bot will send or not a dm to the visited profile.
-
⚡ random time: This settings randomize the sleep delay between one interaction cycle and another.
- The bot will sleep from delay/2 to 2 * delay
-
⚡ collect following time: The delay that the bot has for scrape your profile following list and find who it has to unfollow by comparing your following list with the previously followed peoples.
-
⚡ collect to follow time: The delay that the bot has for scrape the followers list of the pages for profile collection and save the scraped profiles for interact with them.
- ⚡ follow per day : The maximum range of follow to left in one day.
- ⚡ likes per day : The maximum range of likes to left in one day.
- ⚡ unfollow per day: The maximum range of unfollow to left in one day.
- ⚡ comment per day : The maximum range of commets to left in one day.
- ⚡ message per day : The maximum range of messages to left in one day.
- ⚡ hashtags: The hashtags list from where you want the bot to collect the images from, you can add too profiles name. @ for profiles, # for hashtags, ! for absolute paths of folders ( & separator ) ex: ( #hashtag1 & #hashtag2 & @profile1 & @profile2 & !abs/path/to/folder).
- ⚡ collect images: Allow the bot to automatically collect new images each given delay.
- ⚡ collect images delay: The delay that the bot has to wait before collect again the images.
- By default in eache random post the owner of the posted image will be tagged in the post.
- ⚡ auto post: Allow the bot to do auto posts.
- ⚡ random post: Allow the bot to create a random post from the collected images.
- ⚡ random post delay: The delay that the bot has to wait before post a new random post
- ⚡ captions: The captions list that the bot will use for create the random post. ( & separator )
- ⚡ auto story: Allow the bot to do auto stories.
- ⚡ random story: Allow the bot to create a random story from the collected images.
- ⚡ random story delay: The delay that the bot has to wait before post a new random story
- From this panel you can manage the collected images and run the profiles images collector for collect new images.
- The collected images are not downloaded but the ig images links are stored in a file, so they doesn't fill your disk space!
- Be aware that the ig videos links are temporary, usually a video link expires after few days so don't collect videos and hope that they will remain there for months.
- ⚡ Run: Runs the image collector of the selected profile. It collects the most popular images/videos and their owner of the given hashtags, and the latest (12-18) posts of a given profile. ( usually each hashtag has 9 popular medias).
- ⚡ Save settings: Save the settings of the selected profile. Each time that you edit something be sure to save it before running the bot.
- ⚡ Run All: Runs all the images collectors of the saved profiles.
- ⚡ Stop: Stop the image collector of the selected profile. Is possible to simply close the window of the collector too.
- ⚡ Stop All: Stop all the images collectors.
- ⚡ Delete All Images: Delete all the images of the hastas related to the selected profile. The deleted images are gone too for all the others profiles. All the profiles shares the images, if you have two profiles A and B and both have the hashtag #pizza if you delete on or more images of the hashtag #pizza from the profile A the images are deleted too for the profile B.
- ⚡ Delete Profile: Delete the selected profile and all the related datas ( except for the images )
- ⚡Clear Session: Clear all the datas of the session in the browser and in the api.
- ⚡ hashtags: The hashtags list from where you want the bot to collect the images from, you can add too profiles name. @ for profiles, # for hashtags, ! for absolute paths of folders ( & separator ) ex: ( #hashtag1 & #hashtag2 & @profile1 & @profile2 & !abs/path/to/folder).
- ⚡ collect images: Allow the bot to automatically collect new images each given delay.
- ⚡ collect images delay: The delay that the bot has to wait before collect again the images.
- From this panel you can manage/schedule posts.
-
⚡ Random Post: generate random posts based on the given
-
⚡ Add Post: Add a post card at the bottom of the page that can be filled with custom datas for create a scheduled post. The supported files are .mp4 for videos and .jpg for images. You can add too a tag list containing the users to tag. ( & separator ).
-
⚡ Save settings: Save the settings of the selected profile. Each time that you edit something be sure to save it before running the bot.
-
⚡ Delete All posts: Remove all the Scheduled posts of the selected profile.
-
⚡ Delete Profile: Delete the selected profile and all the related datas ( except for the images )
-
⚡ Clear Session: Clear all the datas of the session in the browser and in the api.
For Generate a Random Posts:
- Fill the random posts number field with the posts to generate.
- Fill the random posts start date field with the date that indidicates the start of the pubblication of the posts.
- Select the capiton type between: - random caption: take a random caption from the given captions. - default caption: take the caption collected with the post. - default + random: use the default one and adds to it a random caption from the given captions.
- Click the random posts button, this will generate 'n' posts with random videos/images previously collected from the bot, the posts dates start from the given date and each time that a new random post is created this date is incremented with the number given in the random post delay field.
- By default in eache random post the owner of the posted image will be tagged in the post.
- ⚡ auto post: Allow the bot to do auto posts.
- ⚡ random post: Allow the bot to create a random post from the collected images.
- ⚡ random post delay: The delay that the bot has to wait before post a new random post
- ⚡ captions: The captions list that the bot will use for create the random post. ( & separator )
- captions special words:
- @owner : when the bot will post the image/video will replace this word with the source ( so the owner of the post ) of the post.
- From this panel you can manage/schedule stories.
- ⚡ Random Stories:
- Fill the random stories number field with the posts to generate.
- Fill the random story start date field with the date that indidicates the start of the pubblication of the posts.
- Click the _random stories button, this will generate 'n' stories with random videos/images previously collected from the bot, the stories dates start from the given date and each time that a new random story is created this date is incremented with the number given in the random story delay field.
- ⚡ Add Story: Add a story card at the bottom of the page that can be filled with custom datas for create a scheduled story. The supported files are .mp4 for videos and .jpg for images.
- ⚡ Save settings: Save the settings of the selected profile. Each time that you edit something be sure to save it before running the bot.
- ⚡ Delete All Stories: Remove all the Scheduled posts of the selected profile.
- ⚡ Delete Profile: Delete the selected profile and all the related datas ( except for the images )
- ⚡ Clear Session: Clear all the datas of the session in the browser and in the api.
- ⚡ auto story: Allow the bot to do auto stories.
- ⚡ random story: Allow the bot to create a random story from the collected images.
♦️ random story delay: The delay that the bot has to wait before post a new random story
- This is a view only panel. When the bot is active it stores the interactions that it does and some datas relative to your profile for create ANALYTICS GRAPHS. The following graphs are aviable.
- Daily stats
- Likes interaction
- Comments interaction
- Follow interaction
- Unfollow interaction
- Visited profiles
- Profile uploaded posts count: No
- Following
- Followers
- This is a view only panel. There are stored all the bot logs, basically what it does and when it does it. If you see that something isn't working just checks the logs for see if something bad happend.
- With the logs filter u can choose to view only a specific type of logs:
- errors
- info
- warnings
- success
- Sometimes the error are displayed too in the upper alert box!
- For any problem or help request open an issue.
- Code and Contributions Licese
Copyright (c) 2020 Linch1-Wiinsta: Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- Images and logos have CC BY-NC 4.0 License
- Documentations and Translations have CC BY 4.0 License