2016-05-07 22:26:54 +00:00
[](https://avatar.playat.ch:1000/)
2016-02-10 04:30:05 +00:00
[](https://www.npmjs.org/package/thelounge)
2016-05-30 23:27:59 +00:00
[](https://travis-ci.org/thelounge/lounge)
[](https://ci.appveyor.com/project/astorije/lounge/branch/master)
2016-02-10 04:30:05 +00:00
[](https://david-dm.org/thelounge/lounge)
2016-09-27 05:24:47 +00:00
[](https://david-dm.org/thelounge/lounge?type=dev)
2015-09-13 21:15:49 +00:00
2016-02-10 04:30:05 +00:00
# The Lounge
2014-10-01 19:10:14 +00:00
2015-09-13 21:20:05 +00:00
__What is it?__
2016-02-10 04:30:05 +00:00
The Lounge is a web IRC client that you host on your own server.
2014-08-18 12:50:12 +00:00
2016-02-10 07:47:01 +00:00
*This is the official, community-managed fork of @erming 's great initiative, the [Shout ](https://github.com/erming/shout ) project.*
2015-09-13 21:20:05 +00:00
__What features does it have?__
2016-02-10 04:30:05 +00:00
2014-08-18 12:50:12 +00:00
- Multiple user support
- Stays connected even when you close the browser
- Connect from multiple devices at once
- Responsive layout — works well on your smartphone
2014-08-18 12:55:27 +00:00
- _.. and more!_
2014-08-18 12:50:12 +00:00
2016-02-23 19:01:11 +00:00
__Why the fork?__
We felt that the original [Shout ](https://github.com/erming/shout ) project
"stagnated" a little because its original author wanted it to remain his pet
project (which is a perfectly fine thing!).
A bunch of people, excited about doing things a bit differently than the upstream
project forked it under a new name: “The Lounge”.
This fork aims to be community managed, meaning that the decisions are taken
in a collegial fashion, and that a bunch of maintainers should be able to make
the review process quicker and more streamlined.
2016-09-20 04:06:54 +00:00
## Installation and usage
2014-07-20 23:14:36 +00:00
2016-09-20 04:06:54 +00:00
The Lounge requires [Node.js ](https://nodejs.org/ ) v4 or more recent.
2016-04-26 10:51:11 +00:00
2016-09-20 04:06:54 +00:00
### Running stable releases from npm (recommended)
2016-04-26 10:51:11 +00:00
2016-09-20 04:06:54 +00:00
Run this in a terminal to install (or upgrade) the latest stable release from
[npm ](https://www.npmjs.com/ ):
2014-07-20 23:14:36 +00:00
2016-09-20 04:06:54 +00:00
```sh
[sudo] npm install -g thelounge
```
2014-07-20 23:14:36 +00:00
2016-09-20 04:06:54 +00:00
When installation is complete, run:
2014-08-19 01:53:17 +00:00
2016-09-20 04:06:54 +00:00
```sh
lounge start
2014-08-17 15:40:28 +00:00
```
2016-09-20 04:06:54 +00:00
For more information, read the [documentation ](https://thelounge.github.io/docs/ ), [wiki ](https://github.com/thelounge/lounge/wiki ), or run:
```sh
2016-02-10 04:30:05 +00:00
lounge --help
2014-08-13 01:27:53 +00:00
```
2014-07-20 23:14:36 +00:00
2016-09-20 04:06:54 +00:00
### Running from source
2015-02-06 11:10:11 +00:00
2016-09-20 04:06:54 +00:00
The following commands install the development version of The Lounge. A word of
caution: while it is the most recent codebase, this is not production-ready!
2015-02-06 11:10:11 +00:00
2016-09-20 04:06:54 +00:00
```sh
git clone https://github.com/thelounge/lounge.git
cd lounge
2015-02-06 11:10:11 +00:00
npm install
2015-11-09 16:11:21 +00:00
npm start
2015-02-06 11:10:11 +00:00
```
2016-09-20 04:06:54 +00:00
## Development setup
Simply follow the instructions to run The Lounge from source above, on your own
fork.
Before submitting any change, make sure to:
- Read the [Contributing instructions ](https://github.com/thelounge/lounge/blob/master/CONTRIBUTING.md#contributing )
- Run `npm test` to execute linters and test suite
- Run `npm run build` if you change or add anything in `client/js/libs` or `client/views`
