Add readme

This commit is contained in:
nin0dev 2024-06-17 19:22:56 -04:00
parent 02f0330226
commit a2443723b2

29
README.md Normal file
View file

@ -0,0 +1,29 @@
# Vencord EAS
This is the repo for both the frontend and backend for the Vencord Emergency Alert System.
## Installation
You run the server by:
1. Installing the `websockets` and `python-dotenv` packages;
1. Making a `.env` file;
1. Adding a line with `TOKEN={token}`, with `{token}` being any string that'll be used to broadcast messages;
1. Running `python main.py`.
## Usage
You can send raw text to the WS server. This text is in form of commands:
- `HI` will reply with a message response;
- `GET` will reply with a message response too;
- `MSG {token} {message}` will set the message and broadcast it to all logged-in clients;
- `CLEAR {token}` will clear the current message.
You may receive one of two packets while using the server:
- `MSG {message}` to indicate there's a new message. The client should react by showing an alert with the message. If no message is present, the packet will be `MSG` only. In this case, the client shouldn't react.
- `OK` indicates the action was successful. The client should react by showing an alert telling the user so.
## Frontend
The frontend is a static HTML page and can be hosted on anything.