kgb.conf -- KGB bot configuration file
is the main configuration file of the KGB bot. Its location is
unless changed with the --conf
option. See kgb-bot
The file format is YAML. Elaborate example configuration is at the end of this
A map with the following possible keys:
- IP address to listen to. Defaults to 127.0.0.1.
For making KGB bot listen on all addresses, set the value to 0.0.0.0.
- Port to listen to.
- SOAP service name. Defaults to "KGB".
Directory to store PID file to. Defautls to /var/run/kgb-bot/
Path to file with additional configuration. May be a path to a directory, in
which case all files in it ending with ".conf" are loaded, in
Minimum version of the protocol that will be supported by the server. Defaults
to 1. Protocol version 0 has no authentication.
When messages are sent to IRC, there is certain rate limitting, which may
prevent the message to be sent right away. In this case messages are enqueued,
and this parameter configures the size of the queue. When the queue is full
client requests are rejected.
A map with keys project names and values maps with project details:
- Password used for authenticating all requests from this
- If true, disables commit announces to 'broadcast' IRC
A map with keys network names and values map of network configuration,
containing the following items:
- IP address/hostname of the IRC server to connect to.
- Port number to connect to.
- Bot's nick on the network.
- The full name of the bot on the network.
- The username presented to the network.
- A password for the network.
- A password for Nick server identification.
- If defined to a true value, the built-in rate-limitting
feature of the IRC component will be turned off. WARNING: this may
cause the bot to be kicked off the IRC network. Use only when you control
both the bot and the IRC network (e.g. when testing).
A list of channels. Each element is a map and represents the channel's
- Channel name, e.g. "#commits".
- Network name, as described in the networks map.
- Enables broadcasting all commit notifications to this
- A list of project names, as described in the
repositories map. Mandatory unless broadcast is enabled.
- Each channel can contain separate list of smart answers,
A list of strings to be used as replies when the bot is addressed on IRC.
If set to a true value, polygen
(1) will be used to generate replies when
the bot is addressed on IRC.
Enables logging of additional diagnostic information.
A list of IRC masks, used to determine if a given IRC nick is bot administrator.
Note that currently these nicks have no additional power.
A map of colors to be used when painting commit messages. The following keys are
- Commit ID. Default: none.
- Changed path. Default: teal.
Depending on the action performed to the path, additional coloring is
- Used for added paths. Default: green.
- Used for modified paths. Default: teal.
- Used for deleted paths. Default: bold red.
- Used for replaced paths (a Subversion concept). Default:
- Used for paths with changed properties (a Subversion
concept), combined with other colors depending on the action -- addition,
modification or replacement. Default: underline.
- Commit author. Default: green.
- Commit branch. Default: brown.
- Project module. Default: purple.
- URL to commit information. Default: silver.
- The separator before the commit log. Default: none.
# vim: filetype=yaml
# just a name to identify it
# needs to be the same on the client
# private repositories aren't announced to broadcast channels
# private: yes
# Some witty answer for people that talk to the bot
# - "I won't speak with you!"
# - "Do not disturb!"
# - "Leave me alone, I am buzy!"
# Admins are allowed some special !commands (currently only !version)
# - some!irc@mask
# - some!other@host
ircname: KGB bot
# a broadcast channel
- name: '#commits'
# a channel, tied to one or several repositories
- name: '#foo'
# Can also be set per-channel
# - "I'm in ur channel, watching ur commits!"
# - "I am not listening"
# - "Shut up! I am buzy watching you."
# anything less is rejected
# default colors:
deletion: "bold red"
# you can combine them like "bold red" (ouch!)
# available colors: black, navy, green, red, brown, purple, orange, yellow,
# lime, teal, aqua, blue, fuchsia, gray, silver, white
# available modifiers: bold underline reverse
- Damyan Ivanov firstname.lastname@example.org
Copyright (C) 2012, 2013 Damyan Ivanov
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301, USA.