juergen/ticketfrei
1
0
Fork 0
Code Issues 15 Pull requests Releases Wiki Activity

brought README.md up to date

Browse source
This commit is contained in:
b3yond 2018-10-13 18:56:09 +02:00
parent 4428fa932f
commit f286c127ba
1 changed files with 21 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
README.md
View file

@ -1,7 +1,5 @@
# Ticketfrei social bot # Ticketfrei social bot
Version: 2.0beta
Ticketfrei is a mastodon/twitter/mail bot to dodge ticket controllers in public Ticketfrei is a mastodon/twitter/mail bot to dodge ticket controllers in public
transport systems. transport systems.
@ -13,19 +11,19 @@ your tweet and others can read the info and think twice whether they want to
buy a ticket or not. If enough people, a critical mass, participate for the bot buy a ticket or not. If enough people, a critical mass, participate for the bot
to become reliable, you have positive self-reinforcing dynamics. to become reliable, you have positive self-reinforcing dynamics.
Today, you can use a Twitter, a Mastodon, and Mail with the account. They will Today, you can use a Twitter, Mastodon, Telegram, and Mail with the account.
communicate with each other; if someone warns others via Mail, Twitter and They will communicate with each other; if someone warns others via Mail,
Mastodon users will also see the message. And vice versa. Telegram, Twitter and Mastodon users will also see the message. And vice versa.
In version 2, this bot has received a frontend website. On this website, people In version 2, this repository contains a web application. On this website,
can register an own bot for their city - the website manages multiple bots for people can register an own bot for their city - the website manages multiple
multiple citys. This way, you do not have to host it yourself. bots for multiple citys. This way, you do not have to host it yourself.
In the promotion folder, you'll find some promotion material you can use to In the promotion folder, you'll find some promotion material you can use to
build up such a community in your city. Unfortunately it is in german - but build up such a community in your city. Unfortunately it is in german - but
it's editable, feel free to translate it! it's editable, feel free to translate it!
Website: https://ticketfrei.links-tech.org Website (our flagship instance): https://ticketfrei.links-tech.org
More information: https://wiki.links-tech.org/IT/Ticketfrei More information: https://wiki.links-tech.org/IT/Ticketfrei
@ -34,9 +32,11 @@ More information: https://wiki.links-tech.org/IT/Ticketfrei
Just go to https://ticketfrei.links-tech.org or another website where this software is Just go to https://ticketfrei.links-tech.org or another website where this software is
running. running.
* Register a twitter account
* Register a Mastodon account
* Register on the ticketfrei site * Register on the ticketfrei site
* Optionally: register bots:
* Register a Twitter account
* Register a Mastodon account
* Register a Telegram bot
* Configure account * Configure account
* The hard part: do the promotion! You need a community. * The hard part: do the promotion! You need a community.
@ -50,7 +50,7 @@ to check if something was retweeted in the last hour or something.
To this date, we have never heard of this happening though. To this date, we have never heard of this happening though.
### blockisting ### Blocklisting
You also need to edit the goodlist and the blocklist. You can do this on the You also need to edit the goodlist and the blocklist. You can do this on the
website, in the settings of your bot. website, in the settings of your bot.
@ -70,9 +70,9 @@ a GitHub issue or write to tech@lists.links-tech.org, we are happy to help and s
We wrote these installation notes, so you can set up the website easily: We wrote these installation notes, so you can set up the website easily:
### Install ### Install from the git repository
To Do: This guide assumes you are on a Debian 9 Server:
```shell ```shell
sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git exim4 sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git exim4
@ -101,10 +101,11 @@ cp config.toml.example config.toml
vim config.toml vim config.toml
``` ```
This configuration is only for the admin. Users can log into This configuration is only for the admin. Moderators can log into
twitter/mastodon/mail and configure their personal bot on the settings page. twitter/mastodon/mail and configure their personal bot on the settings page.
Set up LetsEncrypt: Set up LetsEncrypt:
```shell ```shell
sudo apt-get install python-certbot-nginx -t stretch-backports sudo apt-get install python-certbot-nginx -t stretch-backports
sudo certbot --authenticator webroot --installer nginx --agree-tos --redirect --hsts sudo certbot --authenticator webroot --installer nginx --agree-tos --redirect --hsts
@ -176,11 +177,15 @@ less /var/log/syslog
# for the nginx web server: # for the nginx web server:
less /var/log/nginx/example.org_error.log less /var/log/nginx/example.org_error.log
# for the mail server
less /var/log/exim4/mainlog
``` ```
### Development Install ### Development Install
If you want to install it locally to develop on it: If you want to install it locally to develop on it, note that twitter and mail
will probably not work. You should test them on a server instead.
```shell ```shell
sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git