No description
Find a file
2014-08-18 14:50:12 +02:00
client Use superagent for image download 2014-08-17 14:40:26 -07:00
screenshots Update screenshot 2014-08-17 08:25:45 -07:00
src Use superagent for image download 2014-08-17 14:40:26 -07:00
users/example Added user loading 2014-08-13 18:52:02 -07:00
.gitignore Bump version 2014-08-14 09:43:36 -07:00
config.json Update cli commands 2014-08-17 06:33:48 -07:00
Gruntfile.js Handle timezones 2014-07-23 17:16:00 -07:00
index.js Update cli commands 2014-08-17 06:33:48 -07:00
package.json Use superagent for image download 2014-08-17 14:40:26 -07:00
README.md Update README.md 2014-08-18 14:50:12 +02:00

Shout

What is it?
Shout is a web IRC client that you host on your own server.

What features does it have?

  • Multiple user support
  • Stays connected even when you close the browser
  • Connect from multiple devices at once
  • Responsive layout — works well on your smartphone

It works great when running it on the Amazon EC2 micro instance!

Here's my Shout server running in public mode, which allows for anonymous connections:

Try the Shout client

Install

sudo npm install -g shout

Usage

When the install is complete, go ahead and start the server:

shout

For more information:

shout --help

Screenshot

Configuration

Open your config.json file and edit:

port
The default port to be used.
You can override this by running shout --port 80

public
Set to either true|false.
When set to false, a login will be required for connecting users.

User Management

Go ahead and run shout --help:

Usage: shout [options] [command]

Commands:

  list
    List all existing users
  
  add <name>
    Add a new user
  
  remove <name>
    Remove an existing user

Pretty simple, huh?

If you want to edit users manually, see users/example/user.json.

Commands

These are the commands currently implemented:

  • /close
  • /connect
  • /deop
  • /devoice
  • /disconnect
  • /invite
  • /join
  • /kick
  • /leave
  • /me
  • /mode
  • /msg
  • /nick
  • /notice
  • /op
  • /part
  • /query
  • /quit
  • /raw
  • /say
  • /send
  • /server
  • /slap
  • /topic
  • /voice
  • /whois

License

Available under the MIT license.