2016-02-10 05:30:05 +01:00
|
|
|
# The Lounge
|
2014-10-01 21:10:14 +02:00
|
|
|
|
2016-10-16 09:11:52 +02:00
|
|
|
[](https://avatar.playat.ch:1000/)
|
|
|
|
|
[](https://www.npmjs.org/package/thelounge)
|
|
|
|
|
[](https://travis-ci.org/thelounge/lounge)
|
|
|
|
|
[](https://ci.appveyor.com/project/astorije/lounge/branch/master)
|
|
|
|
|
[](https://david-dm.org/thelounge/lounge)
|
|
|
|
|
[](https://david-dm.org/thelounge/lounge?type=dev)
|
|
|
|
|
|
2015-09-13 23:20:05 +02:00
|
|
|
__What is it?__
|
2016-02-10 05:30:05 +01:00
|
|
|
|
|
|
|
|
The Lounge is a web IRC client that you host on your own server.
|
2014-08-18 14:50:12 +02:00
|
|
|
|
2016-02-10 08:47:01 +01:00
|
|
|
*This is the official, community-managed fork of @erming's great initiative, the [Shout](https://github.com/erming/shout) project.*
|
|
|
|
|
|
2015-09-13 23:20:05 +02:00
|
|
|
__What features does it have?__
|
2016-02-10 05:30:05 +01:00
|
|
|
|
2014-08-18 14:50:12 +02: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 14:55:27 +02:00
|
|
|
- _.. and more!_
|
2014-08-18 14:50:12 +02:00
|
|
|
|
2016-02-23 20:01:11 +01: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-12-09 06:51:22 +01:00
|
|
|
<p align="center">
|
|
|
|
|
<img src="https://cloud.githubusercontent.com/assets/5481612/19623041/9bbaec40-9888-11e6-9961-8f3e0493ba30.png" width="550">
|
|
|
|
|
</p>
|
|
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
## Installation and usage
|
2014-07-21 01:14:36 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
The Lounge requires [Node.js](https://nodejs.org/) v4 or more recent.
|
2016-04-26 12:51:11 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
### Running stable releases from npm (recommended)
|
2016-04-26 12:51:11 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
Run this in a terminal to install (or upgrade) the latest stable release from
|
|
|
|
|
[npm](https://www.npmjs.com/):
|
2014-07-21 01:14:36 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
```sh
|
|
|
|
|
[sudo] npm install -g thelounge
|
|
|
|
|
```
|
2014-07-21 01:14:36 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
When installation is complete, run:
|
2014-08-19 03:53:17 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
```sh
|
|
|
|
|
lounge start
|
2014-08-17 17:40:28 +02:00
|
|
|
```
|
2016-09-20 06:06:54 +02: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 05:30:05 +01:00
|
|
|
lounge --help
|
2014-08-13 03:27:53 +02:00
|
|
|
```
|
2014-07-21 01:14:36 +02:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
### Running from source
|
2015-02-06 12:10:11 +01:00
|
|
|
|
2016-10-29 02:13:54 +02:00
|
|
|
The following commands install the development version of The Lounge:
|
2015-02-06 12:10:11 +01:00
|
|
|
|
2016-09-20 06:06:54 +02:00
|
|
|
```sh
|
|
|
|
|
git clone https://github.com/thelounge/lounge.git
|
|
|
|
|
cd lounge
|
2015-02-06 12:10:11 +01:00
|
|
|
npm install
|
2015-11-09 17:11:21 +01:00
|
|
|
npm start
|
2015-02-06 12:10:11 +01:00
|
|
|
```
|
|
|
|
|
|
2016-10-29 02:13:54 +02:00
|
|
|
A word of caution:
|
|
|
|
|
|
|
|
|
|
- While it is the most recent codebase, this is not production-ready!
|
|
|
|
|
- It is not recommended to run this as root. However, if you decide to do so,
|
|
|
|
|
you will have to run `npm run build`.
|
|
|
|
|
|
2016-09-20 06:06:54 +02: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`
|
