Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/stephanakkerman/instagram-discord-bot

A simple script for keeping your Discord server users updated about your Instagram posts
https://github.com/stephanakkerman/instagram-discord-bot

discord discord-bot discord-py instagram instagram-api instagram-bot python

Last synced: 9 days ago
JSON representation

A simple script for keeping your Discord server users updated about your Instagram posts

Awesome Lists containing this project

README

        

# Instagram_Bot
This is a simple script Python for self hosting a Discord bot that will posts everytime the specified user posts something on their Instagram account.\
[![Python 3.8](https://img.shields.io/badge/python-3.8-blue.svg)](https://www.python.org/downloads/release/python-380/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![MIT License](https://img.shields.io/github/license/StephanAkkerman/Instagram_Bot.svg?color=brightgreen)](https://opensource.org/licenses/MIT)

---

## Setup
The first step is creating a Discord bot, setting up the basics, and inviting it to your server. For the first part you can watch this [video (watch until 2:20)](https://www.youtube.com/watch?v=Pbq7vPsHDtc).

Or follow these written instructions:
- Setup your own Discord bot, following this [written tutorial](https://realpython.com/how-to-make-a-discord-bot-python/) or this
- Give the bot admin rights and all permissions possible, since this is the easiest way to set it up.
- Invite the bot to your server.
- Create the text channel where you would like to receive your Instagram updates in.

Last you need to fill in the important information in `config_example.yaml`, so the bot knows which server it should be connected to.
- Open `config.yaml`
- Write your bot token behind `TOKEN:` (line 2)
- Write your server name behind `GUILD_NAME:` (line 3)
- Write the dedicated channel name behind `CHANNEL:` (line 6)
- Write the dedicated Instagram username behind `USERNAME:` (line 7)

## Combining with your own bot
If you would like to combine this bot with your own bot, copy the `main.py` file and load your own Discord extenions.
See line 31 in `main.py` on how to do this, or check out my other Discord bot for more extensive Discord bots and examples.

## Dependencies
The required packages to run this code can be found in the `requirements.txt` file. To run this file, execute the following code block:
```
$ pip install -r requirements.txt
```
Alternatively, you can install the required packages manually like this:
```
$ pip install
```

## How to run
- Clone the repository
- Fill in the fields in config.yaml
- Run `$ python src/main.py`
- See result

## Webhook
If self hosting a Discord bot is not what you are looking for, check out this [webhook implementation](https://github.com/Floor-Gang/Instagram-to-discord)!