tilde.chat/wiki/pages/bots.md

3.8 KiB

author published title description category
~cmccabe true cool irc bots information about irc bots on tilde.chat
main

tilde.chat irc bots

you might have seen some bots lurking about in chat. this page is intended to be a common place for documentation.

bots should be well behaved and efficient with system resources. if you see a bot that is not, please remind the botmaster about this and/or notify an admin. naughty bots can make the system less enjoyable for everyone, and we all have to work together to police them.

rules and etiquette for tilde.chat irc bots

your bot must respond to !botlist with the following information:

  • your system username (as creator/botmaster) - so we can contact you if the bot misbehaves
  • one line description of the bot's functionality
  • list of the bots public commands

be conservative about automatically re-connecting to the server or channel.

if your bot's code is not yet stable, keep it in the #bots channel and do testing there.

don't join #chaos or unless you want your bot to be spammed to hell and back.

tilde.team bot starter kit

khuxkm is hard at work developing a starter kit framework in python that you can use to build your own irc bot. find the source here. it's installed globally on ~team, so get coding!

add your bot to the list below

follow the example of sedbot when you add your bot in a PR to the wiki

  • sedbot
    • botmaster: ~ben
    • short description: sent a typo in chat? fix it up with a sed expression and sedbot will try to correct it
    • list of functions:
      • s/needle/replace/flags
      • most regex character classes match here
      • flags include g and i
    • source
  • tracer
    • botmaster: ~ben
    • short description: generate tracery output from grammars in you ~/.tracery (on ~team) - forked and ported from selfsame/tracer for py3 support
    • list of functions:
      • !!list
      • !!
      • !!fuse
      • | at the end of commands will echo the output in a new message eg: !!drink | !toot
    • source
  • tooter
    • botmaster: ~ben
    • short description: toots from @tildeverse@tilde.zone (@tildeteam@tilde.zone in #team)
    • list of functions:
      • !toot
    • source
  • radiobot
    • botmaster: ~ben
    • short description: a janky bot in bash to post tilderadio updates - also toots from @tilderadio@tilde.zone
    • list of functions:
      • radiobot: subscribe (or unsubscribe) - send a query when a dj goes online
      • radiobot: np - show what's currently playing on tilderadio
      • radiobot: dj - show who's currently broadcasting
      • radiobot: link - show a link to the tilderadio stream
      • radiobot: source - show a link to the sourcecode
      • radiobot: slogan - grab a random tilderadio slogan
    • source
  • BabiliBot
    • botmaster: ~aewens
    • short description: the unofficial bot of #meta, also includes integrations such as mirroring tilde.news and bbj into #tildeverse and #team (respectively)
    • list of functions:
      • !summon -- Sends email to user to summon them
      • !hmmscore user:optional -- How many times user has said "hmm"
      • !oofscore user:optional -- How many times user has said "oof"
      • !hmmscoreboard / !oofscoreboard -- Top three scores
      • !whois -- Does a WHOIS search to see if domain is registered or not
    • source