NAME

       ibid.ini - Configuration file for Ibid

DESCRIPTION

       ibid.ini contains all the configuration for an Ibid bot.

       A  complete  description of the contents of this file is out of the scope of this manpage.
       For more details see the Ibid documentation: http://ibid.omnia.za.net/docs/

       Lines beginning with # are considered to be comments and ignored.  To use a # symbol in an
       option   (e.g.   an   IRC  channel  name),  quote  the  option  with  double-quotes,  e.g.
       channels="#ibid",

       This file will be written to by the bot when configuration settings  are  altered  online.
       It  can  also  be edited manually and a running bot told to "reload config".  Manual edits
       and comments will be preserved when the bot modifies its own configuration, provided  that
       they have not been edited since bot start-up or the last config reload.

SECTIONS

   auth
       Settings   related   to   permissions   and   authentication.    Permissions   listed   in
       auth.permissions are granted to all users unless revoked by source or account.

   sources
       Sources are Ibid connections to an IM service.  They range from IRC networks to the  bot's
       built-in HTTP server.

       Each  source  is  configured  in  a  section named after the source.  The source name will
       define the driver that the source should use, unless a type option is provided.

       Sources can be disabled by setting disabled=True.

   plugins
       Plugin configuration.  Each plugin is configured within a section named after the plugin.

       cachedir
              The directory that temporary files (such as downloaded data), useful to be the  bot
              but expendable, is stored in.

       core.autoload
              If  True,  all  plugins  not  explicitly  ignored  will be loaded.  (Note that some
              plugins mark themselves as non-auto-loadable).  Defaults to True.

       core.load
              The list of plugins (or plugin.Processors) to load.

       core.noload
              The list of plugins (or plugin.Processors) to ignore and not load.

       core.names
              The names that the bot should respond to.

       core.ignore
              Nicks that the bot should completely ignore (e.g. other bots).

EXAMPLE

       botname = joebot
       logging = logging.ini

       [auth]
           methods = password,
           timeout = 300
           permissions = +factoid, +karma, +sendmemo, +recvmemo, +feeds, +publicresponse

       [sources]
           [[telnet]]
           [[timer]]
           [[http]]
               url = http://joebot.example.com
           [[smtp]]
           [[pb]]
           [[atrum]]
               channels = "#ibid",
               nick = $botname
               type = irc
               auth = hostmask, nickserv
               server = irc.atrum.org

       [plugins]
           cachedir = /tmp/ibid
           [[core]]
               names = $botname, bot, ant
               ignore = ,

       [databases]
           ibid = sqlite:///ibid.db

FILES

       logging.ini
              A standard Python logging.config configuration file describing  loggers,  handlers,
              and formatters for log messages.  See http://docs.python.org/library/logging.html

SEE ALSO

       ibid(1), ibid.ini(5), twistd(1), http://ibid.omnia.za.net/