1 changed files with 16 additions and 88 deletions
@ -1,100 +1,28 @@ |
|||||
# RECbot |
# LogBot |
||||
|
|
||||
A small XMPP bot written in Python that logs XMPP conversations into a HTML page, allowing collaborative log writing over time. |
A small XMPP bot written in Python that logs XMPP conversations into a HTML page, allowing collaborative log writing over time. |
||||
|
|
||||
The bot is used in group chats, where it includes all images that are send to the group and all messages that include `@bot`. |
The bot is used in group chats, where it includes all images that are send to the group and all messages that include `@logbot`. |
||||
|
|
||||
*work-in-progress* |
*work-in-progress* |
||||
|
|
||||
## Situated tails |
## How to use LogBot? |
||||
|
|
||||
* Archive bot, Relearn 2017, <https://gitlab.com/relearn/relearn2017/-/tree/master/xmpp-bots/archive-bot> |
|
||||
* Streambot, Varia website extension 2017-2018, <https://git.vvvvvvaria.org/varia/xmpp.streambot> |
|
||||
* Logbot, Varia XMPP extension 2017-2020, <https://git.vvvvvvaria.org/varia/bots/src/branch/master/logbot> |
|
||||
|
|
||||
## Use RECbot |
|
||||
|
|
||||
* check if `RECbot` is one of the participants in the groupchat! |
|
||||
* send an image to the groupchat **OR** use one of the `__ACTION WORDS__` below |
|
||||
* the bot confirms your contribution and writes the message to a file |
|
||||
* check the output of RECbot (locally or online, for example: <https://vvvvvvaria.org/logs>) |
|
||||
|
|
||||
RECbot works with `__ACTION WORDS__` and unique `<HANDLE>` codes. |
|
||||
|
|
||||
* `__ADD__` RECbot entries with `__ADD__ <message>`, for example: `__ADD__ Logging as a form of stretching time.` or `__ADD__ https://nicelink.org` |
|
||||
* `__DELETE__` RECbot entries with `__DELETE__ <HANDLE>`, for example: `__DELETE__ ~+*/+-` (\*spark) |
|
||||
* `__BOOK__` (\*sparks) |
|
||||
|
|
||||
## Install RECbot |
|
||||
|
|
||||
RECbot uses the `slixmpp` library to connect to XMPP and `beautifulsoup` to parse the HTML pages. |
|
||||
|
|
||||
`$ sudo pip3 install slixmpp beautifulsoup4` |
|
||||
|
|
||||
## Run RECbot! |
|
||||
|
|
||||
`$ python3 RECbot.py` |
|
||||
|
|
||||
The bot will ask you to provide the following details: |
|
||||
|
|
||||
* XMPP address of a (bot)account |
|
||||
* password |
|
||||
* groupchat address |
|
||||
* nickname for the bot |
|
||||
* output folder path |
|
||||
|
|
||||
You can also run it as a oneliner, for example by writing: |
|
||||
|
|
||||
`$ python3 RECbot.py -u bot@vvvvvvaria.org -p CHANGEME -g roomname@muc.vvvvvvaria.org -n RECbot -o /var/www/logs/` |
*Oh dear, logbot is here!* |
||||
|
|
||||
* `-u` / `--use` = user / use this XMPP address |
* `@logbot`: send a message to the groupchat with `@logbot` and it will add the whole message to the log |
||||
* `-p` / `--password` = password |
* send an image to the groupchat, it will add it to the log |
||||
* `-g` / `--groupchat` = groupchat |
* `@delete <num>` Delete posts from the log. For example: @logbot @delete 5 |
||||
* `-n` / `--nickname` = nickname |
* `@bots`: To see who is around :) |
||||
* `-o` / `--output` = output |
* `@uptime`: To check how long @logbot has been around |
||||
|
* `@help`: Print this message |
||||
## \*sparks |
|
||||
|
|
||||
----------- |
|
||||
|
|
||||
It would be so nice to have different RECbot *modes*: `--log`, `--stream`, `--distribusi` |
|
||||
|
|
||||
* `--log`: RECbot writes a growing HTML page with images and text, that can be marked up and styled in HTML/CSS. |
|
||||
* `--stream`: RECbot stores all images that are send to the group, and displays them as an image stream. |
|
||||
* `--distribusi`: RECbot saves files (images, messages as markdown, files, links as HTML pages) and generates a distribusi page of all collected material. |
|
||||
|
|
||||
Under the hood the process can be cut up into two procedures: |
|
||||
|
|
||||
* saving text/image/audio/video based messages as files (.txt, .png/.jpg, .ogg, .og4/.mp4) |
|
||||
* recbot.py |
|
||||
* generating different outputs, depending on the selected *mode* |
|
||||
* distribusi.py[\*] |
|
||||
* log.py[\*] |
|
||||
* stream.py[\*] |
|
||||
|
|
||||
These modes can be changed at any moment. |
|
||||
|
|
||||
[\*] These are standalone scripts. They can be used on any set of files in a folder and generate HTML pages with customizable styling. |
|
||||
|
|
||||
``` |
|
||||
RECbot <modes> <log HTML page> |
|
||||
|
|
||||
│ --distribusi > distribusi.py |
|
||||
│ [output folder] --log > log.py [output_folder/index.html] |
|
||||
│ (saved as files) --stream > stream.py (saved as index.html + stylesheet.css) |
|
||||
│ --xxx > xxx.py |
|
||||
│ |
|
||||
└── stores text/media |
|
||||
files in output folder |
|
||||
(local/server) |
|
||||
``` |
|
||||
|
|
||||
------------ |
|
||||
|
|
||||
How can `__ACTION WORDS__` become magical `__MAGIC WORDS__` ??? |
|
||||
|
|
||||
------------ |
|
||||
|
|
||||
|
## Situated tails |
||||
|
|
||||
|
* Archive bot, Relearn 2017, <https://gitlab.com/relearn/relearn2017/-/tree/master/xmpp-bots/archive-bot> |
||||
|
* Streambot, Varia website extension 2017-2018, <https://git.vvvvvvaria.org/varia/xmpp.streambot> |
||||
|
* Logbot v1, Varia XMPP extension 2017-2020, <https://git.vvvvvvaria.org/varia/bots/src/branch/master/logbot> |
||||
|
|
||||
|
## Requirements |
||||
|
|
||||
|
* [xbotlib](https://git.autonomic.zone/decentral1se/xbotlib) |
||||
Loading…
Reference in new issue