Instagram for the lazy - automatically upload a photo to Instagram
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

instacron Instagram for the lazy

Automatically upload a photo to Instagram

Takes a random photo from the folder photos and adds a caption with a random quote. For example:

Just as treasures are uncovered from the earth, so virtue appears from good deeds, and wisdom appears from a pure and peaceful mind. To walk safely through the maze of human life, one needs the light of wisdom and the guidance of virtue. 🌬🌱 Taken in Colombia, Villavieja 🇨🇴 on 13 January 2016. #instacron 🐍

Luck is what happens when preparation meets opportunity. ⚽🚌 Taken in Colombia, Cali 🇨🇴 on 25 October 2015. #instacron 🐍

I think and that is all that I am. 💔🤷 Taken in Peru, Cusco 🇵🇪 on 21 November 2015. #instacron 🐍

When all photos in the photos folder have been uploaded, it starts to upload the least frequently uploaded photos first.

Why does this exist?

I like to take pictures that I would like to share with the world but I am way too lazy to upload them using the app.


You need Python≥3.6

Clone the repo with

git clone

and install the requirements with

cd instacron
pip install -r requirements.txt


  • Put photos in photos (see the expected filename structuce here.)
  • run python and follow the instructions to have it set up a config file.

Alternatively setup a cronjob to periodically post a photo, see for instructions.


See the FAQ: Understanding Responses from Instagram in the mgp25/Instagram-API repository for information about the error codes the Instagram API might return.