forked from ticketfrei/ticketfrei
85 lines
3.7 KiB
Markdown
85 lines
3.7 KiB
Markdown
# Ticketfrei micro messaging bot
|
|
|
|
<!-- This mastodon/twitter bot has one purpose - breaking the law. -->
|
|
|
|
The functionality is simple: it retweets every tweet where it is mentioned.
|
|
|
|
This leads to a community which evolves around it; if you see ticket controllers, you tweet their location and mention the bot. The bot then retweets your tweet and others can read the info and think twice if they want to buy a ticket. If enough people, a critical mass, participate for the bot to become reliable, you have positive self-reinforcing dynamics.
|
|
|
|
There is one security hole: people could start mentioning the bot with useless information, turning it into a spammer. That's why it has to be maintained; if someone spams the bot, mute them and undo the retweet. So it won't retweet their future tweets and the useless retweet is deleted if someone tries to check if something was retweeted in the last hour or something.
|
|
To this date, we have never heard of this happening though.
|
|
|
|
Website: https://wiki.links-it.de/IT/Ticketfrei
|
|
|
|
## Install
|
|
|
|
Setting up a ticketfrei bot for your city is quite easy. Here are the few steps:
|
|
|
|
First you need to install python and virtualenv with your favourite package manager.
|
|
Create and activate virtualenv:
|
|
|
|
```shell
|
|
$ sudo apt install python virtualenv
|
|
$ virtualenv -p python3 .
|
|
$ . bin/activate
|
|
```
|
|
|
|
Install the dependencies:
|
|
```shell
|
|
$ pip install python-twitter pytoml requests Mastodon.py
|
|
```
|
|
|
|
Configure the bot:
|
|
```shell
|
|
$ cp ticketfrei.cfg.example ticketfrei.cfg
|
|
$ vim ticketfrei.cfg
|
|
```
|
|
Edit the account credentials, so your bot can use your accounts.
|
|
|
|
### blacklisting
|
|
|
|
Also add the words to the goodlist, which you want to require. A tweet is only retweeted, if it contains at least one of them. If you want to RT everything, just add your account name.
|
|
|
|
There is also a blacklist, which you can use to automatically sort out malicious tweets. Be careful though, our filter can't read the intention with which a word was used. Maybe you wanted it there.
|
|
|
|
Note that atm the good- & blacklist are still outside of ticketfrei.cfg, in separate files. we will repare this soon.
|
|
|
|
### screen
|
|
|
|
To keep the bots running when you are logged out of the shell, you can use screen:
|
|
|
|
```shell
|
|
sudo apt-get install screen
|
|
echo "if [ -z "$STY" ]; then screen -RR; fi" >> ~/.bash_login
|
|
screen
|
|
python3 ticketfrei.py
|
|
```
|
|
|
|
To log out of the screen session, press "ctrl+a", and then "d".
|
|
|
|
## ideas
|
|
|
|
* You can only use the twitter API if you have confirmed a phone number and sacrificed a penguin in a blood ritual. So we should build it in a way that it uses the twitter web GUI. It's difficult, but maybe it works. We had another twitter bot that worked similarly, years ago: https://github.com/b3yond/twitter-bot
|
|
* Build a tool that deletes wrong toots/tweets on both platforms, would work nicely with a web UI.
|
|
* write the muted people to the db, to easily undo the mutes if necessary.
|
|
|
|
## to do
|
|
Desktop/pycharm-community-2017.1.4/bin/pycharm.sh
|
|
- [x] Twitter: Crawl mentions
|
|
- [x] Mastodon: Crawl mentions
|
|
- [ ] Write toots/tweets to database/log
|
|
- [x] Twitter: retweet people
|
|
- [x] Mastodon: boost people
|
|
- [x] Twitter: access the API
|
|
- [ ] Web UI that lets you easily delete toots/tweets per db id and/or mute the tweet author
|
|
- [x] Write Bots as Classes to be easier implemented
|
|
- [x] Create extra Class for the filter
|
|
- [x] Put as much as possible into ticketfrei.cfg
|
|
- [x] Make both bots run on their own *and* next to each other
|
|
- [x] implement trigger class in retootbot
|
|
- [x] read config in retweetbot
|
|
- [x] put shutdown contact in ticketfrei.cfg
|
|
- [x] document what you have to configure if you setup the bot in another city
|
|
- [ ] write a script to setup the bot easily. ask the admin for the necessary information
|
|
- [ ] ongoing: solve issues
|