`ircbothist` - IRC Bot for persistent history

## Install (Debian-based system):

```
# apt update
# apt install python3 python3-venv python3-pip
# mkdir -p /opt/ircbothist
# wget -c "https://q3aql.dev/scripts/ircbothist.py" -O /opt/ircbothist/ircbothist.py
# python3 -m venv /opt/ircbothist
# source /opt/ircbothist/bin/activate
# pip install --upgrade pip
# pip install irc
# useradd -m -s /bin/bash ircbot
# chown ircbot:ircbot -R /opt/ircbothist
```

## Edit configuration:

```                                                                                                                                                                                                                  
# vim /opt/ircbothist/ircbothist.py                                                                                                                                                                       
```  

Replace these lines with your configuration:

```
######## CONFIGURATION (Edit with your settings)
SERVER   = "localhost"
PORT     = 6667
USE_TLS  = False
NICK     = "history-bot"
REALNAME = "IRC Message History"
CHANNELS = ["#support", "#linux"]
MAX_HISTORY = 200
PERSIST_FILE = "history.pkl"
SAVE_INTERVAL = 60
#########
```

## Add the bot at system startup:

Create the file `/etc/systemd/system/ircbothist.service` with the following:

```
[Unit]
Description=IRC history bot
After=network.target

[Service]
Type=simple
User=ircbot
Group=ircbot
WorkingDirectory=/opt/ircbothist
Environment=PATH=/opt/ircbothist/bin
ExecStart=/opt/ircbothist/bin/python3 /opt/ircbothist/ircbothist.py
Restart=on-failure
RestartSec=5s
KillMode=process

[Install]
WantedBy=multi-user.target
```

Add the service at startup and start it:

```
# systemctl daemon-reload
# systemctl enable ircbothist
# systemctl start ircbothist
```

## How to uninstall:

```
# rm -rf /opt/ircbothist
# rm -rf /etc/system/system/ircbothist.service
# deluser ircbot
```

## Dependencies
* python3
* python3-irc
* python3-pip