mirror of https://github.com/mightyBroccoli/xmpp-chatbot.git synced 2024-09-19 20:20:13 +02:00

nico 6bb9f1d5b8 readme + usability improvements

+ added requirements.txt
* updated readme

2018-10-04 00:46:57 +02:00

1.6 KiB

Raw Blame History

Python XMPP Chatbot

beforehand

Do not operate this bot on foreign servers. Many servers prohibit the usage of bots on their service.

functions

query xmpp server software and version XEP-0092
query xmpp server uptime XEP-0012
query xmpp server contact addresses XEP-0157
display information about XEP from the XSF extensions website
display help output
respond to username being mentioned

install

virtualenv

With virtualenv it is possible to run the bot inside a virtual environment without disrupting other python processes and or dependencies. This repo comes with a requirements.txt to make the install process as easy as possible.

cd to_the_path/of_the_bot/
mkdir ./venv

# create the virtual environment
virtualenv -p $(which python3) ./venv
source ./venv/bin/activate
pip3 install -r requirements.txt

configuration

Replace the dummy bot.cfg file, filled with correct credentials/ parameters.

[Account]
jid=nick@domain.tld/querybot
password=super_secret_password
[MUC]
rooms=room_to_connect_to@conference.domain.tld,another_room@conference.domain.tld
nick=mucnickname

systemd

Copy the systemd dummy file into systemd service folder. systemdctl daemon-reload and systemctl start magicbot.service to start the bot. If it is neccecary to start the bot automatically when the system boots do systemctl enable magicbot.service.

starting the bot without systemd

Got to the bots directory and run ./main.py &.

1.6 KiB Raw Blame History