NAME
    Convos - Multiuser IRC proxy with web interface

VERSION
    0.4001

DESCRIPTION
    Convos is to a multi-user IRC Proxy, that also provides a easy to use
    Web interface. Feature list:

    *   Always online

        The backend server will keep you logged in and logs all the activity
        in your archive.

    *   Archive

        All chats will be logged and indexed, which allow you to search in
        earlier conversations.

    *   Avatars

        The chat contains profile pictures which can be retrieved from
        Facebook or from gravatar.com.

    *   Include external resources

        Links to images and video will be displayed inline. No need to click
        on the link to view the data.

  Running convos
    Convos has sane defaults so after installing Convos you should be able
    to just run it:

      # Install
      $ cpanm Convos
      # Run it
      $ convos backend &
      $ convos daemon

    The above works, but if you have a lot of users you probably want to use
    hypnotoad instead of "daemon":

      $ hypnotoad $(which convos)

    The command above will start a full featured, UNIX optimized, preforking
    non-blocking webserver. Run the same command again, and the webserver
    will hot reload the source code without loosing any connections.

  Configuration
    You can also customize the config by setting "MOJO_CONFIG" before
    running any of the commands above. Example:

      $ MOJO_CONFIG=$HOME/.convos.conf convos daemon

    You can use
    <https://github.com/Nordaaker/convos/blob/release/convos.conf> as config
    file template.

  Architecture principles
    *   Keep the JS simple and manageable

    *   Use Redis to manage state / publish subscribe

    *   Archive logs in plain text format, use ack to search them.

    *   Bootstrap-based user interface

  Environment
    Convos can be configured with the following environment variables:

    *   CONVOS_BACKEND_EMBEDDED=1

        Set CONVOS_MANUAL_BACKEND to a true value if you're starting Convos
        with "morbo" and want to run the backend embedded.

    *   CONVOS_DEBUG=1

        Set CONVOS_DEBUG for extra debug output to STDERR.

    *   CONVOS_MANUAL_BACKEND=1

        Disable the frontend from starting the backend.

    *   CONVOS_PING_INTERVAL=30

        Set how often to send "keep-alive" through the web socket. Default
        is every 30 second.

    *   MOJO_IRC_DEBUG=1

        Set MOJO_IRC_DEBUG for extra IRC debug output to STDERR.

RESOURCES
    *   Homepage: <http://convos.by>

    *   Project page: <https://github.com/Nordaaker/convos>

    *   Icon:
        <https://raw.github.com/Nordaaker/convos/master/public/image/icon.sv
        g>

    *   Logo:
        <https://raw.github.com/Nordaaker/convos/master/public/image/logo.sv
        g>

SEE ALSO
    *   Convos::Archive

        Mojolicious controller for IRC logs.

    *   Convos::Client

        Mojolicious controller for IRC chat.

    *   Convos::User

        Mojolicious controller for user data.

    *   Convos::Core

        Backend functionality.

ATTRIBUTES
  archive
    Holds a Convos::Core::Archive object.

  cache
    Holds a Mojolicious::Static object pointing to a cache dir. The
    directory is "/tmp/convos" by default.

  core
    Holds a Convos::Core object.

  upgrader
    Holds a Convos::Upgrader object.

METHODS
  startup
    This method will run once at server start

COPYRIGHT AND LICENSE
    Copyright (C) 2012-2013, Nordaaker.

    This program is free software, you can redistribute it and/or modify it
    under the terms of the Artistic License version 2.0.

AUTHOR
    Jan Henning Thorsen - "jhthorsen@cpan.org"

    Marcus Ramberg - "marcus@nordaaker.com"

