What is InstaWebhooks?

InstaWebhooks is a Python package CLI that allows you to monitor Instagram accounts for new posts and send them to a Discord webhook. It is designed to be simple to use and easy to set up, with a focus on customizability and ease of use.

Internally, InstaWebhooks uses Instaloader to fetch Instagram posts and Discord Webhooks to send messages to Discord via requests which happens to be the same dependency Instaloader uses. It uses argparse for the CLI and logging for logging.

Example

Below, InstaWebhooks is monitoring the Instagram account raenlua for new posts and sending them to a Discord webhook every 30 minutes and sends a message to Discord with the post URL and the owner’s name.

# Install InstaWebhooks
pip install instawebhooks

# Run InstaWebhooks with custom message contents
instawebhooks -c "New post from {owner_name}: {post_url}" raenlua https://discord.com/api/webhooks/0123456789/abcdefghijklmnopqrstuvwxyz

What it looks like:

Installation

InstaWebhooks is available on PyPI, and can be installed using pip:

pip install instawebhooks

For more ways to install, see Installation.

Usage

You can run instawebhooks --help to see the full list of options and arguments available.

The most basic usage of InstaWebhooks is to provide an Instagram account and a Discord webhook URL (replace <INSTAGRAM_USERNAME> and <DISCORD_WEBHOOK_URL>):

instawebhooks <INSTAGRAM_USERNAME> <DISCORD_WEBHOOK_URL>

For more about each option and argument, including example templates, see Usage.

Contributing

For contributions, see the contributing guidelines.

This project supports development containers, allowing you to instantly setup your development environment. For more, read about installing from dev container.