PonyChat's fork of Shout
Go to file
Mattias Erming a50015867b Remove 'messages' from config 2014-06-16 15:13:43 +02:00
client Remove 'messages' from config 2014-06-16 15:13:43 +02:00
lib Remove 'messages' from config 2014-06-16 15:13:43 +02:00
screenshots Updated screenshots 2014-06-16 00:09:07 +02:00
.gitignore Updated jQuery plugins 2014-05-14 00:47:46 +02:00
README.md Update README.md 2014-06-16 00:18:55 +02:00
config.js Remove 'messages' from config 2014-06-16 15:13:43 +02:00
index.js Release 0.4.0 2014-06-15 19:35:43 +02:00
package.json Release 0.5.0 2014-06-16 11:15:26 +02:00

README.md

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

  1. Install Node.js and NPM
    sudo apt-get -y install nodejs npm

  2. Clone the project from GitHub
    git clone http://github.com/erming/shout

  3. Open folder
    cd shout/

  4. Install Node packages
    npm install

  5. Run the server
    npm start or node index.js

  6. 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.