Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ryanlua/instawebhooks

Discord webhooks for new Instagram posts from any account. Get notified of posts from Instagram to your Discord server.
https://github.com/ryanlua/instawebhooks

cli discord instagram instaloader python webhooks works-with-codespaces

Last synced: 4 days ago
JSON representation

Discord webhooks for new Instagram posts from any account. Get notified of posts from Instagram to your Discord server.

Host: GitHub
URL: https://github.com/ryanlua/instawebhooks
Owner: RyanLua
License: mit
Created: 2024-06-29T06:46:27.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-11-05T02:30:37.000Z (9 days ago)
Last Synced: 2024-11-05T22:17:31.001Z (8 days ago)
Topics: cli, discord, instagram, instaloader, python, webhooks, works-with-codespaces
Language: Python
Homepage: https://pypi.org/project/instawebhooks
Size: 692 KB
Stars: 4
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        

# InstaWebhooks - Discord webhooks for Instagram

[![Continuous Integration](https://github.com/RyanLua/InstaWebhooks/actions/workflows/ci.yml/badge.svg)](https://github.com/RyanLua/InstaWebhooks/actions/workflows/ci.yml) [![PyPI - Version](https://img.shields.io/pypi/v/instawebhooks)](https://pypi.org/project/instawebhooks/#history) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/instawebhooks)](https://pypi.org/project/instawebhooks/) [![GitHub License](https://img.shields.io/github/license/RyanLua/InstaWebhooks)](https://github.com/RyanLua/InstaWebhooks/blob/main/LICENSE.txt) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![linting: pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/pylint-dev/pylint) [![Discord](https://img.shields.io/discord/1162303282002272359?label=discord)](https://discord.gg/wmM64GcZwe)

> [InstaWebhooks Documentation](https://github.com/RyanLua/InstaWebhooks/wiki)

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



## 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](https://instaloader.github.io/) to fetch Instagram posts and [Discord Webhooks](https://discord.com/developers/docs/resources/webhook) to send messages to Discord via [requests](https://requests.readthedocs.io/en/latest/) which happens to be the same dependancy Instaloader uses. It uses [argparse](https://docs.python.org/3/library/argparse.html) for the CLI and [logging](https://docs.python.org/3/library/logging.html) for logging.

## Example

Below, InstaWebhooks is monitoring the Instagram account [`raenlua`](https://www.instagram.com/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.

```console

$ instawebhooks -i 1800 -c "New post from {owner_name}: {post_url}" raenlua https://discord.com/api/webhooks/0123456789/abcdefghijklmnopqrstuvwxyz

07/29/2024 10:02:10 PM - INFO - Starting InstaWebhooks...

07/29/2024 10:02:14 PM - INFO - InstaWebhooks started successfully.

07/29/2024 10:02:14 PM - INFO - Monitoring 'raenlua' every 1800 seconds on https://discord.com/api/webhooks/0123456789/abcdefghijklmnopqrstuvwxyz.

07/29/2024 10:02:18 PM - INFO - New post sent to Discord successfully.

```

What it looks like:



## Installation

InstaWebhooks is available on [PyPI](https://pypi.org/project/instawebhooks/), and can be installed using `pip`:

```

pip install instawebhooks

```

For more ways to install, see "[Installation](https://github.com/RyanLua/InstaWebhooks/wiki/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 `` and ``):

```

instawebhooks  

```

For more about each option and argument, includig example templates, see "[Usage](https://github.com/RyanLua/InstaWebhooks/wiki/Usage)."

## Contributing

For contributions, see the [contributing guidelines](CONTRIBUTING.md).

This project supports [development containers](https://containers.dev/), allowing you to instantly setup your development environment. For more, read about [installing from dev container](https://github.com/RyanLua/InstaWebhooks/wiki/Installation#from-development-container)