https://github.com/jack-mil/server-bot-experiment
Experimental Discord API & Web server interaction proof-of-concept
https://github.com/jack-mil/server-bot-experiment
bot discord flask-application live-frame server-sent-event
Last synced: 2 months ago
JSON representation
Experimental Discord API & Web server interaction proof-of-concept
- Host: GitHub
- URL: https://github.com/jack-mil/server-bot-experiment
- Owner: jack-mil
- License: mit
- Created: 2021-07-12T03:31:12.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-06-01T20:21:41.000Z (about 1 year ago)
- Last Synced: 2025-06-02T06:15:43.645Z (about 1 year ago)
- Topics: bot, discord, flask-application, live-frame, server-sent-event
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Image-Frame Discord Bot
This is a rudimentary proof-of-concept experiment that uses the Discord bot API to connect
a Discord client "user" and a remote "server" (such as RPI with display) over the internet
without additional networking.
The server runs two Docker containers:
- A Flask server listening to REST API requests on the local network (`127.0.0.1`)
- The Discord bot, which can pass data back/forth to the outside world over the internet
- The bot forwards API requests to the local web server
With this setup, it is possible to send commands, data, or whole files to the "server" from
the Discord mobile app with no network configuration.
As long as the client and server both haver internet access.
The Discord bot can forward data on to the local web server,
which can save or process the data as needed.
*One application for this is a live "picture frame" where users can message images to the
bot to be displayed on the RPI device (running a browser in kiosk mode).* Images can be
hosted on the Discord CDN or downloaded to the server directly.
The current proof-of-concept shows that a webpage displayed on the Pi can be updated
asynchronously with images sent to the Discord bot using the Server-Sent-Events browser
feature to update the web page with images in a "feed" style.
An exercise in specific learning areas:
- Making Flask REST-like APIs
- Asynchronous programming with `discord.py`
- Containerization with Docker Compose
- Browser support of Server-Sent-Events (SSE) and dynamic page updating
- Some client side Javascript required in the web page hosted by the local server
### Attribution
The [EM Felix Bot](https://github.com/engineer-man/felix) served as a great foundation for a modular bot structure.
Parts of code where copied from there, before being modified and features removed for my experimental purposes.
Code from that project is used under the MIT License. [Felix License](https://github.com/engineer-man/felix/blob/1c635ed909ce98b1c446f371dffde265351f4021/LICENSE)