Shout

Run your IRC client on a server and access it from the web browser. This gives you a persistent connection and allows you to chat from multiple devices at the same time.

Contributing

Shout is open source and open for contributions. Any sort of help is appreciated!
Come join #shout-irc on Freenode!

Screenshots

And also..
Mobile interface

Install

Install Node.js and NPM
sudo apt-get -y install nodejs npm
Clone the project from GitHub
git clone http://github.com/erming/shout
Open folder
cd shout/
Install Node packages
npm install --production
Run the server
npm start or node index.js
Open your browser
http://localhost:9000

Commands

These are the commands currently implemented:

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

Events

Using Socket.IO
Events sent from the server to the browser:

// Event: "join"
// Sent when joining a new channel/query.
socket.emit("join", {
  id: 0,
  chan: {
    id: 0,
    name: "",
    type: "",
    network: "",
    count: 0,
    messages: [],
    users: [],
  }
});

// Event: "messages"
// Sent after the server receives a "fetch" request from client.
socket.emit("messages", {
  id: 0,
  msg: []
});

// Event: "msg"
// Sent when receiving a message.
socket.emit("msg", {
  id: 0,
  msg: {
    time: "",
    type: "",
    from: "",
    text: "",
  }
});

// Event: "networks"
// Sent upon connecting to the server.
socket.emit("networks", {
  networks: [{
    id: 0,
    host: "",
    nick: "",
    channels: [],
  }]
});

// Event: "part"
// Sent when leaving a channel/query.
socket.emit("part", {
  id: 0
});

// Event: "users"
// Sent whenever the list of users changes.
socket.emit("users", {
  id: 0,
  users: [{
    mode: "",
    name: "",
  }]
});

License

Available under the MIT license.

2.3 KiB Raw Blame History