Provides links to different translations of a random verse from the bible. Can post on Mastodon and Signal.
- Clone the project with Git or download it as a ZIP.
- Copy the file
config-template.ini
toconfig.ini
and edit the copy so that the data in it is correct. Also see below for explanations of the settings. - Python 3.9 or higher and the necessary libraries must be installed
(e.g. with the command
pip3 install -r requirements.txt
). Recommendation: Use a venv and install the libraries in it. - Run either
bot_console.py
,bot_mastodon.py
orbot_signal.py
periodically, e.g. once a day.
Simply outputs the message as text. Useful for shell scripts.
Posts the message as a status in Mastodon. The Mastodon account used must be configured with the following settings:
api_base_url
: the address of the Mastodon instanceaccess_token
: the access token of the Mastodon "application" (see below)
In the Mastodon settings there is the "Development" section and there the
"New Application" button. There must be an application that has at least the permission
write:statuses
- the token from this must be configured in the bot.
Posts the message as a Signal message in as many direct chats and/or groups as you like. This is implemented via signal-cli which has to be set up separately - see Installation and Einrichtung). Access to signal-cli is via DBus. Required settings for the bot:
sender
: the number that should send the messages (must be configured in signal-cli) in the format 49123456789recipients
(optional):|
-separated list of numbers in the format +49123456789, to which the messages should be sent directlygroups
(optional):|
-separated list of group names of whichsender
is a member - the message will be posted in these groups
language
: use book names and abbreviations in this language - the filebooks_XY.csv
has to exist in subdirectorydata
if language is set to XYtranslations
: used to generate the links to the bible verse, example:
NIV=New International Version|ELB=Elberfelder Bibel
- the part after the
=
is the displayed name and can be omitted - the first entry is used to read the bible text, if configured - see below
- the part after the
text_directory
: (optional) the "raw" output directory of a run of bibleserver-scraper (expected are files named "[translation]-[booknumber]-[bookabbreviation][chapternumber].txt", example: "LUT-09-1.Samuel24.txt")