Table of Contents

• About
• How to set up
  • Reddit requirements
  • Local requirements
  • Configuration

Instagramer

This is a bot that downloads every day the top posts from a specific subreddit and reposts them on Instagram. The bot can post images and videos.

You can find the example account here: @the_real_lord_of_the_memes. It reposts the top memes from the subreddit r/memes.

How to set up

Reddit requirements

In order to download posts from Reddit you need to create an account. After this you need to create a Reddit app on this page: https://www.reddit.com/prefs/apps.

On the bottom of the page click on "create another app...":

Now create the app with the suiting parameters. Select script:

After that you should see something like this:

Later on we need these parameters:

• 1: CLIENT_ID
• 2: SECRET_TOKEN

Congratulations 🎉! The first steps are done!

Local requirements

This bot makes use of a PostgreSQL database in order to avoid downloading and uploading the same post again. It logs every downloaded and uploaded post and checks if it was already downloaded or uploaded. For that you need to have a local PostgreSQL installation, a database and two tables called DownloadLog and PostLog. Those are the SQL statements you can use to generate the tables, but the bot will auto-generate the tables accordingly if not done yet:

CREATE TABLE public."DownloadLog" (
	"uuid" TEXT PRIMARY KEY,
	"url" TEXT NOT NULL,
	"title" TEXT,
	"startedAt" TIMESTAMP NOT NULL,
	"finishedAt" TIMESTAMP,
	"downloadStatus" TEXT NOT NULL
);

CREATE TABLE public."PostLog" (
	"uuid" TEXT PRIMARY KEY,
	"startedAt" TIMESTAMP NOT NULL,
	"finishedAt" TIMESTAMP,
	"postStatus" TEXT NOT NULL,
	"errorMsg" TEXT
);

If this is done you have to grab the file .env.sample rename it to .env and insert your parameters. For REDDIT_CLIENT_ID and REDDIT_SECRET_TOKEN you have to insert the two values from your Reddit app as mentioned above. For SUBREDDIT define the subreddit you want to download the posts from. At the moment only one subreddit at a time is supported.

This bot also supports notifications over Discord. There you can receive notifications if something went wrong or if something went right. If you want to have functionality just insert a Discrod webhook for DISCORD_WEBHOOK in the .env file. If you don't want to receive notifications just leave the field empty. Here you can find an instruction how to setup Discord webhooks.

Also, you have to install the libraries from the Pipfile or requirements.txt file.

Are all steps completed you can now test if it works by running python main.py in the src folder.

The posts are going to be cached in the resource folder, so do not delete this folder! After two days every unnecessary folder in it will be deleted to keep a better overview and structure.

Configuration

If you want to change the schedule times you can simply do that be adjusting these parameters in main.py on the bottom of the file:

schedule.every().day.at("22:00").do(download_posts)

schedule.every().day.at("23:00").do(remove_dir)

schedule.every().day.at("06:00").do(upload_post)
schedule.every().day.at("09:00").do(upload_post)
schedule.every().day.at("12:00").do(upload_post)
schedule.every().day.at("15:00").do(upload_post)
schedule.every().day.at("18:00").do(upload_post)
schedule.every().day.at("21:00").do(upload_post)

Here is the documentation to the schedule library.

If you want to change the number of posts on Instagram you have to change following:

• Change the number of POSTS_TO_DOWNLOAD in the file .env on the top of the file.
• Adapt the schedule times accordingly of main.py as mentioned above. (Adapt, add or remove schedule times)