diff options
| author | nico <nico@magicbroccoli.de> | 2018-06-21 23:15:44 +0200 |
|---|---|---|
| committer | nico <nico@magicbroccoli.de> | 2018-06-21 23:15:44 +0200 |
| commit | faf2c428bf07aa69693bb20cc554095ac59720da (patch) | |
| tree | 398d9f634c5c6bd636c7318f0fcb3d8908d74bb2 /README.MD | |
initial commit
+ added .gitignore file
+ added basic README file
Diffstat (limited to 'README.MD')
| -rwxr-xr-x | README.MD | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/README.MD b/README.MD new file mode 100755 index 0000000..4fc3196 --- /dev/null +++ b/README.MD @@ -0,0 +1,36 @@ +# Python XMPP Chatbot
+
+## beforehand
+Do not opperate this bot on foreign servers.
+
+### functions
+- query xmpp server software and version [XEP-0092](https://xmpp.org/extensions/xep-0092.html)
+- query xmpp server uptime [XEP-0012](https://xmpp.org/extensions/xep-0012.html)
+- displaying a help output
+- respond to username being mentioned
+
+### todo
+- [ ] query xmpp server contact addresses [XEP-0157](https://xmpp.org/extensions/xep-0157.html)
+ - [x] iq is being catched but the answer needs to be extracted out of it
+- [ ] Github Webhook
+
+### install
+#### requirements
+- slixmpp
+- configparser
+- datetime
+- random
+
+#### configuration
+`bot.cfg` replace dummy file with correct credentials/ parameters
+````cfg
+[Account]
+jid=nick@domain.tld/querybot-0.1
+password=super_secret_password
+[MUC]
+rooms=room_to_connect_to@conference.domain.tld
+nick=mucnickname
+[ADMIN]
+admins=admins ( ! muc nick and not the jid nickname)
+````
+ If done correctly `./main.py &` and enjoy your bot.
\ No newline at end of file |