herald
Owner-follow bot with a configurable keyword responder.
Herald tracks the owner's IRC presence and mirrors their channel movements. It can also respond to keywords in channel messages with random replies.
Dependencies
No external libraries required.
Plugins
| File | Role |
|---|---|
commands.py |
Follow logic and admin commands |
respond.py |
Keyword-based auto-responder |
Commands (owner only)
| Command | Description |
|---|---|
!pause |
Pause keyword responses |
!resume |
Resume keyword responses |
!follow on |
Start tracking owner's channels (checks every 30s via WHOIS) |
!follow off |
Stop tracking |
!unfollow |
Immediately leave all follow-joined channels |
!join #channel |
Join a channel manually |
!part [#channel] |
Leave a channel |
!chans |
List channels |
!help |
Show usage (PM) |
Automatic behaviour
- When the owner PARTs a channel, herald leaves too (unless it's a preconfigured channel).
- When the owner QUITs, herald leaves all non-preconfigured channels.
- With
!follow on, herald also joins any channel the owner is in that herald isn't.
Preconfigured channels are the ones listed under channels in the config.
Keyword responder (respond.py)
Configure in [respond]:
[respond]
keywords =
hello
hi there
responses =
Hey!
What's up?
When any keyword appears (case-insensitive) in a channel message, herald
replies with a randomly chosen response.
Config keys
| Key | Description |
|---|---|
[respond] keywords |
Newline-separated list of trigger words |
[respond] responses |
Newline-separated list of possible replies |