Files
xmpp-radio-tower/README.md
2025-12-13 19:03:33 +00:00

1.3 KiB

xmpp-radio-tower

Experimental music bot for xmpp similar to discord music bots

How to install

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.

python3 -m venv venv

pip install

Literally

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:

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

# 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.