Convos - Multiuser IRC proxy with web interface
0.8602
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.
Keep the JS simple and manageable
Use Redis to manage state / publish subscribe
Bootstrap-based user interface
Convos has sane defaults so after installing Convos you should be able to just run it:
# Install $ cpanm Convos # Run it $ convos daemon --listen http://*:8080
The steps above will install and run Convos in a single process. This is a very quick way to get started, but we incourage to run Convos as one backend and one frontend:
# Start the backend first $ convos backend start # Then start the frontend $ convos daemon --listen http://*:8080
This allow you to upgrade and restart the frontend, without having to reconnect to the IRC servers.
See Convos::Manual::Running for more details.
Some parts of the Convos templates can include custom content. Example:
# Create a directory where you can store the templates $ mkdir -p custom-convos/vendor # Edit the template you want to customize $ $EDITOR custom-convos/vendor/login_footer.html.ep # Start convos with CONVOS_TEMPLATES set. Without /vendor at the end $ CONVOS_TEMPLATES=$PWD/custom-convos convos daemon --listen http://*:5000
Any changes to the templates require the server to restart.
The templates that can be customized are:
vendor/login_footer.html.ep
This template will be included below the form on the /login page.
/login
vendor/register_footer.html.ep
This template will be included below the form on the /register page.
/register
vendor/wizard.html.ep
This template will be included below the form on the /wizard page that a new visitor sees after registering.
/wizard
Homepage: http://convos.by
Project page: https://github.com/Nordaaker/convos
Icon: https://raw.github.com/Nordaaker/convos/master/public/image/icon.svg
Logo: https://raw.github.com/Nordaaker/convos/master/public/image/logo.svg
Convos::Controller::Client
Mojolicious controller for IRC chat.
Convos::Controller::User
Mojolicious controller for user data.
Convos::Core
Backend functionality.
Holds a Convos::Core object .
DEPRECATED.
This method will run once at server start
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.
Jan Henning Thorsen - jhthorsen@cpan.org
jhthorsen@cpan.org
Marcus Ramberg - marcus@nordaaker.com
marcus@nordaaker.com
To install Convos, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Convos
CPAN shell
perl -MCPAN -e shell install Convos
For more information on module installation, please visit the detailed CPAN module installation guide.