Skip to main content

Discord webhooks for new Instagram posts from any profile

Project description

InstaWebhooks

InstaWebhooks - Discord webhooks for Instagram

Continuous Integration PyPI PyPI - Python Version PyPI - License Code style: black Linting: pylint

Documentation

Monitor Instagram accounts for new posts and send them to a Discord webhook.

  • Works with any Instagram account, including private accounts if you are a follower

  • Customizable Discord embeds for new posts and message contents including mentions/pings

  • User-definable refresh interval for checking for new posts the second they are posted

Example of a new post notification

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:

Example of a customized message

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instawebhooks-0.1.4.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

instawebhooks-0.1.4-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file instawebhooks-0.1.4.tar.gz.

File metadata

  • Download URL: instawebhooks-0.1.4.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for instawebhooks-0.1.4.tar.gz
Algorithm Hash digest
SHA256 7c5b1096bcece6743257d5a04e8d3b05296cc0807b65e40032fdc9eb1f9213fa
MD5 cc8fb4681caa7e43673c71c6daa488e1
BLAKE2b-256 859a0e26843c6edb54e070ec15fb6850a636f858b60c8e7fabf4c388ff6d9fa2

See more details on using hashes here.

Provenance

The following attestation bundles were made for instawebhooks-0.1.4.tar.gz:

Publisher: publish.yml on RyanLua/InstaWebhooks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file instawebhooks-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: instawebhooks-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for instawebhooks-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4eba99b84580922b14a88db8052ebb3e61401a1747d1be3611a85420f8677583
MD5 e6919d35fd4e097d7dd0be433f79f2bc
BLAKE2b-256 8e7ef2848aad026c8db4dff18fa730f5fa0a0fe1a16e51578a386e7b060fe623

See more details on using hashes here.

Provenance

The following attestation bundles were made for instawebhooks-0.1.4-py3-none-any.whl:

Publisher: publish.yml on RyanLua/InstaWebhooks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page