thelounge/README.md at 9f5d3807ecdaa0bb810fda6626bf92bdd84e9000

mirror of https://github.com/thelounge/thelounge synced 2024-11-22 20:13:07 +00:00

Mattias Erming 6c8328146e Update README.md

2014-06-13 00:51:15 +02:00

2.1 KiB

Raw Blame History

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.

Screenshot

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
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: "",
    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.1 KiB Raw Blame History