view release on metacpan or  search on metacpan

README  view on Meta::CPAN

  Stays connected
    Bondage will reconnect to IRC when it gets disconnected or the IRC
    server stops responding.

  Recall messages
    Bondage can send you all the messages you missed since you detached, or
    it can send you all messages received since it connected to the IRC
    server, or neither. This feature is based on similar features found in
    miau, dircproxy, and ctrlproxy.

  Auto-away
    Bondage will set your status to away when no clients are attached.

  Reclaim nickname
    Bondage will periodically try to change to your preferred nickname if it
    is taken.

  Flood protection
    Bondage utilizes POE::Component::IRC's flood protection to ensure that
    you never flood yourself off the IRC server.

  NickServ support
    Bondage can identify with NickServ for you when needed.

  Rejoins channels if kicked
    Bondage can try to rejoin a channel if you get kicked from it.

  Encrypted passwords
    Bondage supports encrypted passwords in its configuration file for added
    security.

  SSL support
    You can connect to SSL-enabled IRC servers, and make Bondage require SSL
    for client connections.

  IPv6 support
    Bondage can connect to IPv6 IRC servers, and also listen for client
    connections via IPv6.

  Cycles empty channels
    Bondage can cycle (part and rejoin) channels for you when they become
    empty in order to gain ops.

  CTCP replies
    Bondage will reply to CTCP VERSION requests when you are offline.

CONFIGURATION
    The following options are recognized in the configuration file which is
    called ~/.bondage/config.yml.

  Global options
   "listen_host"
    (optional, default: *"0.0.0.0"*)

    The host that Bondage accepts connections from. This is the host you use
    to connect to Bondage.

   "listen_port"
    (required, no default)

    The port Bondage binds to.

   "listen_ssl"
    (optional, default: *false*)

    Set this to true if you want Bondage to require the use of SSL for
    client connections. You'll need to have ssl.crt and ssl.key files in
    Bondage's working directory. More information, see
    <http://www.akadia.com/services/ssh_test_certificate.html>

   "password"
    (required, no default)

    The password you use to connect to Bondage. If it is 32 characters, it
    is assumed to be encrypted (see "bondage -c");

   "networks"
    (required, no default)

    This should contain a list of network names, each pointing to a list of
    relevant options as described in the following section.

     networks:
       freenode:
         option1: value
         option2: value
       ircnet
         option1: value
         option2: value

  Network-specific options
   "bind_host"
    (optional, default: *"0.0.0.0"*)

    The host that Bondage binds to and connects to IRC from. Useful if you
    have multiple IPs and want to choose which one to IRC from.

   "server_host"
    (required, no default)

    The IRC server you want Bondage to connect to.

   "server_port"
    (optional, default: *6667*)

    The port on the IRC server you want to use.

   "server_pass"
    (optional, no default)

    The IRC server password, if there is one.

   "use_ssl"
    (optional, default: *false*)

    Set this to true if you want to use SSL to communicate with the IRC
    server.

   "nickserv_pass"
    (optional, no default)

    Your NickServ password on the IRC network, if you have one. Bondage will
    identify with NickServ with this password on connect, and whenever you
    switch to your original nickname.

   "nickname"
    (optional, default: your UNIX user name)

    Your IRC nick name.

   "username"
    (optional, default: your UNIX user name)

    Your IRC user name.

   "realname"
    (optional, default: your UNIX real name, if any)

    Your IRC real name, or email, or whatever.

   "flood"
    (optional, default: *false*)

    Set to a true value to allow flooding (disables flood protection).

   "channels"
    (optional, no default)

    A list of all your channels and their passwords.

     channels:
       "chan1" : ""
       "chan2" : "password"
       "chan3" : ""