Mad Chatter is a fun, easy to customize chat server. It's written in Ruby and utilizes HTML 5 Web Sockets for fast communication.
Since Mad Chatter is written in Ruby, you'll need to install Ruby in order to continue. We have a wiki page to help you with that:
Once you have RubyGems installed, you can install the Mad Chatter gem:
gem install mad_chatter
Then generate the directory where your chat application will live:
mad_chatter new mychatroom
This command will generate the following structure:
To start your chat server, navigate to the directory that was just created and run...
This will start up the Mad Chatter chat server as well as a simple web server for you to preview/demo your new chat room. Now you can check it out by opening http://localhost:3000 in your browser. You should see something like this:
When you're ready to have other people start using your new chat server (friends, family, co-workers, etc) you'll need to set up a web server so other people can access it. Set up your web server to serve the
web directory that we created above. Now you're ready to start Mad Chatter and leave it running in the background. Here are a few useful commands for that:
mad_chatter start mad_chatter stop mad_chatter restart
Mad Chatter can do some special things depending on the chat messages you send. Every chat message is parsed to see if it is a normal chat message, or if it's a special action. These actions are much like IRC commands. For example, if I wanted to change my name from Andrew to Andy I could chat this message:
Mad Chatter will interpret this message as an action and change the user name to andy.
If I wanted to embed a YouTube video for all the members of the chatroom to enjoy, I could type:
Or if I wanted to shake everyone's chat window:
You can even create your own actions!
The goal of Mad Chatter is to make it easy to create, host, and customize your own chat server. Let's take a look at the different ways you can customize your new chat server.
config.yml file you can see a few things you can customize.
extensions directory contains all of your extensions. If you wanted to create a custom action, this is where you would put it. You will find a few examples in that directory.
Once you've got your chat server running and being used by other people, you might be interested in using and distributing an installable application so your users have the convenience of clicking on an icon, receiving growl notifications, etc. Here's a list of the currently available "wrapper" applications:
You can also vote on upcoming features: https://madchatter.uservoice.com
Created by Andrew Havens and released under the MIT license.