Update README.md

This commit is contained in:
2025-12-13 19:03:33 +00:00
parent 72904c1877
commit eb0eb2d022

View File

@@ -2,6 +2,52 @@
Experimental music bot for xmpp similar to discord music bots Experimental music bot for xmpp similar to discord music bots
# TODO # How to install
## Upload the source code
### Add a lot of Alastor (Radio Demon) easter eggs from Hazbin Hotel I do not remember most details about dependencies but I will try to make an install guide.
## Dependencies
The bot highly relies on the ffmpeg binary for audio. Also having an up to date version of yt-dlp helps a lot..
## Installation
Clone the projects or just copy the scripts over.
## Set up the Python Environment
I have used venv since it is what I know.
```bash
python3 -m venv venv
```
## pip install
Literally
```bash
pip install slixmpp aiortc aiohttp av mutagen yt-dlp slixmpp-omemo omemo dnspython
```
I am not sure if dnspython is necessary but just in case.
## Create Directories
Create the folder structure for music and downloads:
```bash
mkdir -p music/downloads
```
## Configuration
Take a look at file named `config.ini` in the bot folder. Edit it (every config has their descriptions near them).
## Run the Bot
### Manual Start
```bash
# Ensure you are in your python environment
python3 xmpp_radio_bot.py
```
## Usage
The bot mostly uses **OMEMO encrypted messages**. You may need to "Trust" the bot's fingerprint in your client (Gajim/Conversations/Dino) for commands to work if encryption is active. Plaintext works too but I do not check it mostly since OMEMO is good anyways.