Skip to content

A Python tool that monitors EdStem for new threads and publishes updates to Discord via webhooks using edspy.

Notifications You must be signed in to change notification settings

bachtran02/ed-discohook

Repository files navigation

ed-discohook

A Python program that listens to edstem websockets for new threads and publish events to Discord via webhooks. This project mainly makes use of edspy, a Python wrapper for edstem API which I also maintain.

Demo

ed-discohook demo

How to set up

Docker (highly recommended)

I have been running this program in a Docker container. docker-compose.yml is included in the repo which makes building & running the program with Docker Compose inside of Docker very straightforward.

  1. Clone the repo.
  2. Create an .env file using this template and enter your Ed API token, which can be created here.
  3. In .env file, also enter Discord webhook URLs of the channels you want to send the payload to.

Read more about Discord wehooks here

It is a good practice not to put Discord webhook URLs in the main.py, so you may want to store them in the .env as well. You can use any variable name as you like, just make sure the names are matched in this part of main.py so the secrets can be looked up and retrieved correctly in the main file.

  1. Run docker compose build to build the project and then docker compose up to start running it.

About

A Python tool that monitors EdStem for new threads and publishes updates to Discord via webhooks using edspy.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published