To participate in the campaign please join on https://retweets.floblockchain.com!
The FLO version of https://github.com/bithon/Taubenschlag
Request a Twitter dev account: https://developer.twitter.com/en/account/environments
A domain routed to the server of the bot: retweets.floblockchain.com
You need a server with Python3, a webserver and a reverse proxy. The Webserver and reverse proxy can easily get provided with apache2:
apt-get install apache2 python-certbot-apache
Set the hostname in /etc/apache2/sites-enabled/000-default.conf to retweets.floblockchain.com
systemctl restart apache2
Follow the certbot wizard and select reweets.floblockchain.com for HTTPS activation and choose "redirect http to https"
certbot --apache
systemctl restart apache2
Now try to access the new host: https://retweets.floblockchain.com
We have to configure a reverse proxy in apache:
sudo a2enmod proxy proxy_http
And add those 2 lines to /etc/apache2/sites-enabled/000-default-le-ssl.conf
ProxyPass /oAuthTwitter http://127.0.0.1:17613/oAuthTwitter
ProxyPassReverse /oAuthTwitter http://127.0.0.1:17613/oAuthTwitter
Restart the server:
shutdown -r 0
Download/Copy FLO Retweets Bot and make the app available in /opt/flo-retweets.
Install requirements:
apt install python3-pip
python3 -m pip install -r /opt/flo-retweets/requirements.txt
cd /var/www/html
rm *
ln -s /opt/flo-retweets/html/* .
Create two apps in https://developer.twitter.com/en/account/environments
- Is the main app with read+write permissions (user auth to this app)
- Is the DM sending interface app with read+write+dm permissions (user dont know about his app)
You have to provide a callback URL for app 1: https://retweets.floblockchain.com/oAuthTwitter/verify
Copy the access tokens from the two twitter apps to ./conf.d/secrets.cfg (use the template in
./conf.d/secrets.cfg_template).
Modify ./conf.d/main.cfg if needed.
Modify ./conf.d/rt-level-rule-set.cfg to setup RT sources.
Install screen if it is not:
apt install screen
Create a cronjob as root with:
crontab -e
and insert the line:
@reboot su - root -c "screen -dm -S flo-retweets /opt/flo-retweets/taubenschlag.py"
Thats it, now restart and see if it works:
shutdown -r 0
After the reboot test: https://retweets.floblockchain.com and try one auth!
To see the output of the bot use as root:
screen -x flo-retweets
Hint: After screen -x press tab-tab, to leave screen press CTRL+a and then d.
Create a cronjob with:
crontab -e
and add this lines:
SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
0 */12 * * * root test -x /usr/bin/certbot -a \! -d /run/systemd/system && perl -e 'sleep int(rand(43200))' && certbot -q renew
Its important to backup /opt/flo-retweets/db/flo_retweets_bot.json, do it with cat flo_retweets_bot.json > backup.json.
The bot offers in main.cfg the setting ssh_backup_on_new_user. If set to True the bot copy the db on every new
user auth via ssh (scp) to a remote server. Login for scp can be defined in secrets.cfg.
To restore a backup just stop the bot, do cat backup_file > taubenschlag.json and start the bot.
https://github.com/bithon/Taubenschlag/issues
To contribute follow this guide.