PonyChat's fork of Shout
Go to file
Mattias Erming 7936dab6e3 Show current nick 2014-09-25 16:51:53 -07:00
client Show current nick 2014-09-25 16:51:53 -07:00
screenshots Update screenshot 2014-08-17 08:25:45 -07:00
src Show current nick 2014-09-25 16:51:53 -07:00
users/example Add username field to user info. 2014-09-24 20:08:14 +09:00
.gitignore Bump version 2014-08-14 09:43:36 -07:00
.vimrc Add .vimrc that does not expand tabs by default 2014-09-13 23:00:09 +01:00
Gruntfile.js Normalize line endings 2014-09-13 14:29:45 -07:00
README.md Added '/clear' command 2014-09-19 13:24:11 -07:00
app.json Added app.json 2014-09-09 18:17:13 -04:00
build.sh Precompile Handlebars templates 2014-08-25 16:13:47 -07:00
config.js Autoload users 2014-09-24 15:23:54 -07:00
index.js Rename cli folder 2014-08-25 02:40:13 -07:00
package.json Show current nick 2014-09-25 16:51:53 -07:00

README.md

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
  • .. and more!

Ok, you caught my attention. I want to try it!
Here's a Shout server running in public mode, which allows for anonymous connections:

Try the Demo

Clicking the link above will open http://demo.shout-irc.com/

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 the config.json file by running:

shout config

The settings:

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:

$ shout --help

  Usage: shout [options] [command]

  Commands:

    start
       Start the server

    config
       Edit config: '/usr/lib/node_modules/shout/config.json'

    list
       List all existing users

    add <name>
       Add a new user

    remove <name>
       Remove an existing user

    reset <name>
       Reset user password

    edit <name>
       Edit user: '/home/erming/.shout/users/<name>/user.json'


  Options:

    -h, --help         output usage information
    -h, --host <ip>    host
    -p, --port <port>  port

Pretty simple, huh?

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

Commands

These are the commands currently implemented:

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

License

Available under the MIT license.