DESCRIPTION

       Ctrlproxy uses a configuration directory called .ctrlproxy that lives
       inside the users' home directory. The main configuration file lives in
       this directory and is called config. It is an ini-style configuration
       file with sections and key-value pairs.

       This manpage discusses the variables that can be set in this file in a
       standard ControlProxy installation.

SETTINGS

   [global]
       The [global] section contains some of the most important settings.

       replication
           Replication backend to use. See the section about replication below
           for details.

       report-time
           Set to true to prefix replicated lines with the time the line was
           sent.

       autosave
           Automatically save configuration on exit

       autoconnect
           Semi-colon separated list of networks or servers to connect to on
           startup.

       motd-file
           Path to the message of the day file that is sent to clients upon
           connect.

       match
           If the replication backend is set to highlight, this variable
           should contain a semicolon-separated list of words to search for.

   [admin]
       If the [admin] section is present, ControlProxy will create a fake
       network with a control channel that can be used for administration.

       no_privmsg
           Don't interpret messages to the user ctrlproxy as administration
           commands.

           This option would be needed if you want to be able to send messages
           to an actual user with the nickname ctrlproxy.

   [log-custom]
       If the [log-custom] section is present, ControlProxy will write a log
       to ~/.ctrlproxy/log-custom/

   [log-irssi]
       only_noclient
           Boolean variable. If set to true, then the connection will only be
           changed to away if there are no clients connected.

       time
           Number of seconds of idleness after which the connection should be
           set to away. Default is 10 minutes.

   [socks]
       If the [socks] section is present, ControlProxy will listen for SOCKS
       connections.

       port
           TCP/IP port to listen on for new connections.

       allow
           Semicolon-separeted list of usernames and passwords allowed to
           connect. Separate user name and password by a colon.

   [nickserv]
       learn

   [listener]
       auto
           Automatically start a listener on a new port for each network that
           ctrlproxy connects to.

       autoport
           First port of port range used when adding new listeners.

       password
           Password that the user should specify to log in.

REPLICATION

       When a client connects, ctrlproxy will send information about the
       channels the user is on. Optionally, it can also send some of the
       messages that were received before the client connected (replication).

       The replication variable determines what kind of replication is used.
       At the moment, the following values are supported:

       none
           No replication.

       highlight
           Send messages that one of a set of regular expressions. The regular
           expressions should be specified in variable.

       lastdisconnect
           Send all messages since the last client disconnected.

       simple
       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.,
       59 Temple PLace, Suite 330, Boston, MA 02111-1307 USA

BUGS

       CtrlProxy currently does not warn about unknown configuration
       parameters.

AUTHOR

       Jelmer Vernooij[1]

REFERENCES

        1. Jelmer Vernooij
           mailto:jelmer@nl.linux.org



                                  07/22/2007               CTRLPROXY_CONFIG(5)