BOTD is a IRC channel daemon serving 24/7 in the background.. no copyright. no LICENSE.
BOTD is a IRC channel daemon serving 24/7 in the background.
I N S T A L L
download the tarball from pypi, https://pypi.org/project/botd/#files
if you want to have BOTD started at boot, run botinstall:
> sudo botinstall
this will install an botd service in /etc/systemd/system
if you don’t want the botd to start on boot after install run:
> sudo rm /etc/systemd/system/botd.service
you can also download with pip3 and install globally:
> sudo pip3 install botd --upgrade --force-reinstall
U S A G E
> bot <cmd> > bot -s > botirc localhost \#dunkbots botje
> botinstall > botctl <cmd>
logfiles can be found in /var/log/botd.
C O N F I G U R A T I O N
use botctl (sudo) to edit on the system installed botd service. IRC configuration uses the cfg command to edit server/channel/nick:
> botctl cfg irc server localhost > botctl cfg irc channel #dunkbots > botctl cfg irc nick botje
use the -w option if you want to use a different work directory then /var/lib/botd.
R S S
the rss plugin uses the feedparser package, you need to install that yourself:
> pip3 install feedparser
make sure you have bot.rss added to your cfg.modules:
> botctl cfg krn modules bot.rss add an url: > botctl rss https://news.ycombinator.com/rss ok 1 run the rss command to see what urls are registered: > botctl rss 0 https://news.ycombinator.com/rss the fetch command can be used to poll the added feeds: > botctl fetch fetched 0
U D P
make sure you have bot.udp added to your cfg.modules:
> botctl cfg krn modules bot.udp
using udp to relay text into a channel, use the botudp program to send text via the bot to the channel on the irc server:
> tail -f /var/log/botd/botd.log | botudp
to send a message to the IRC channel, send a udp packet to the bot:
import socket def toudp(host, port, txt): sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) sock.sendto(bytes(txt.strip(), "utf-8"), host, port)
C O D I N G
if you want to develop on the library clone the source at bitbucket.org:
> git clone https://bitbucket.org/botd/botlib
if you want to add your own modules to the bot, you can put you .py files in a “mods” directory and use the -m option to point to that directory.
BOTLIB contains the following modules:
bot.dft - default bot.flt - fleet bot.irc - irc bot bot.krn - core handler bot.rss - rss to channel bot.shw - show runtime bot.udp - udp to channel bot.usr - users
BOTLIB uses the LIBOBJ library which gets included in the tarball.
lo.clk - clock lo.csl - console lo.hdl - handler lo.shl - shell lo.thr - threads lo.tms - times lo.typ - types
basic code is a function that gets an event as a argument:
def command(event): << your code here >>
to give feedback to the user use the event.reply(txt) method:
def command(event): event.reply("yooo %s" % event.origin)
have fun coding ;]
C O N T A C T
you can contact me on IRC/freenode/#dunkbots or email me at email@example.com
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size botd-11.tar.gz (23.9 kB)||File type Source||Python version None||Upload date||Hashes View|