Skip to content
A bot which pulls images from Reddit and uploads them to Instagram
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
media_handlers bugfixes mediahandler Aug 27, 2019
mediadownloader.js bugfixes mediahandler Aug 27, 2019
package-lock.json added media downloaders Aug 27, 2019


A bot for Instagram which pulls images from Reddit. This is also the source code of @me_irl_bot (before it got deleted by Instagram) and @ik_ihe_bot.


The following software needs to be installed on your system in order for this bot to work:

Now keep in mind that I run the bot on Linux (Raspbian), so this guide is also focused on Linux. You should be able to run this bot on other operating systems as well, but for video support it might require some modifying of the code in the video-mediahandler. Automation-wise, I also have no idea how to do that on other systems, so you would have to figure that out yourself. Don't have a Linux system? Luckily, a Raspberry Pi can fix that for you - it's a small little system that is perfect for situations like these. I run my bot on one too. You can get them for prices as low as $35-40.


Download or clone this repository into an empty folder. Create a file in this folder called logindetails.json and enter the following information into this file, replacing all the ENTER fields:

  "subreddit": "/r/ENTER_A_SUBREDDIT"

Please note that two-factor authentication is not supported, so disable that for any account you plan on using. Also, I shouldn't have to mention this, but be careful showing/sharing any of the contents from this file - it does contain your password.

After creating this file, open a CLI, change directory to the project's folder (cd /PATH/TO/PROJECT), then run npm install and wait for the installation to complete.

Running the bot

To run the bot, simply run the command node main.js in the project's folder.

Automating the bot

To let the bot automatically mirror posts from a subreddit, you can automate it with cron on Linux. To do so, run the command crontab -e, select your favorite text editor if not done yet (I recommend using nano), and add the following two lines to the end of the file opened:

0,20,40 9-17 * * * node /PATH/TO/PROJECT/main.js >/dev/null 2>&1
0,30 18-23,0-8 * * * node /PATH/TO/PROJECT/main.js >/dev/null 2>&1

This will make the bot run three times an hour between 09:00 and 18:00, and two times an hour between 18:00 and 09:00. Please note that it uses your machine's timezones. You can modify any times and frequencies here - to do so, please take a look at cron tutorials.

When you're done, simply press Ctrl + X and save the file. That's all, no need to restart your system! The changes will automatically be applied.

Preventing Instagram's bot detection

Now, something important to notice: Instagram will at some point probably detect your bot, and ban it from using Instagram. To make sure this does not happen as easily, we can create a short simple script that adds a random delay when running the bot, so that your account won't be uploading images at regular intervals too much.

Create a new file using nano in the project's folder. Enter the following contents:


sleep $((($RANDOM % 300)+20))
node /PATH/TO/PROJECT/main.js

This will add a random delay of at least 20, at most 320 seconds when running the bot via this script. Do not forget to modify any active cron jobs: instead of running node /PATH/TO/PROJECT/main.js, it should now run /PATH/TO/PROJECT/!

My bot has been banned, what do I do?

If it's not the account but the actual bot being banned (an IgSentryBlockError), modify main.js as follows: search for the line igClient.state.generateDevice. Here you'll find a function that generates a device to use for the bot, using a deviceID. Currently, it is as follows: igClient.state.generateDevice(loginDetails.userName + "_blahblahblah");. Simply edit the _blahblahblah part to any random text you'd like, save the file and run the bot again. It should now work again.

If the above does not fix your issue, it might be your IP-address that has been blocked from using Instagram's services. There's no way to circumvent this, except from using a VPN or proxy for your bot.

If it's the account that has been banned, there's nothing more you can do other than contacting Instagram and appealing the ban, or creating a new account.

Please do not use this library for spamming purposes

I did not create this library to spam Instagram. Please respect this, and do not use it to flood Instagram with posts. Posting a maximum of 3 times an hour should be more than enough.

Need help?

If you need any more help setting up your bot, feel free to send me a message on Instagram! You can find me at @freekbes.

You can’t perform that action at this time.