cringebot/README.md

# cringebot
`cringebot` is a bot that tracks and auto-deletes on Mastodon/Pleroma accounts according to a set maximum age, if they are bad enough. Tracking multiple instances simultaneously is possible. Once a status is flagged for retention, the bot will not check it again.

## Installation (Linux)

#### Obtain root login shell
```
sudo -i
```

#### Install dependencies
```
apt install python3 bogofilter
pip3 install Mastodon.py html2text
```

#### Download cringebot and make user account
```
git clone https://git.thj.no/thor/cringebot.git /usr/local/lib/cringebot
useradd -d /usr/local/lib/cringebot -M -s /bin/bash -U cringebot
chown -R cringebot.cringebot /usr/local/lib/cringebot
```

#### Create configuration
```
cd /usr/local/lib/cringebot
cp config.example.json config.json
editor config.json
```

#### Install systemd service
```
ln -s cringebot.service /etc/systemd/system/cringebot.service
systemctl enable cringebot
systemctl start cringebot
```

#### Management
```
# Initial setup / learning mode
python3 cringebot.py -l

# Restart service
systemctl restart cringebot

# Check service status
systemctl status cringebot

# Monitor log output
journalctl -t cringebot -f
```

## Maintainer

The maintainer can be contacted at `@thor@pl.thj.no`.