PonyChat's fork of Shout
Go to file
Suyeol Jeon 1839162421 Add username field to user info.
Most of the networks don't allow unicode username. This patch allows users to specify username optionally. When specified, username is used for connecting IRC networks instead of nickname.
2014-09-24 20:08:14 +09:00
client Use <div> instead of <button> in sidebar 2014-09-22 11:54:38 -07:00
screenshots Update screenshot 2014-08-17 08:25:45 -07:00
src Add username field to user info. 2014-09-24 20:08:14 +09: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 Added logging 2014-09-16 12:47:01 -07:00
index.js Rename cli folder 2014-08-25 02:40:13 -07:00
package.json Use <div> instead of <button> in sidebar 2014-09-22 11:54:38 -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.