gamja/README.md
2020-07-01 14:46:49 +02:00

50 lines
917 B
Markdown

# gamja
A bare-bones IRC web client.
## Usage
Requires an IRC WebSocket server.
First install dependencies:
npm install --production
### [soju]
Add a WebSocket listener to soju, e.g. `listen wss://127.0.0.1:8080`.
Configure your reverse proxy to serve gamja files and proxy `/socket` to soju.
### [webircgateway]
Setup webircgateway to serve gamja files:
```ini
[fileserving]
enabled = true
webroot = /path/to/gamja
```
Then connect to webircgateway and append `?server=/webirc/websocket/` to the
URL.
### Development server
Start your IRC WebSocket server, e.g. on port 8080. Then run:
npm install
npm start
This will start a development HTTP server for gamja. Connect to it and append
`?server=ws://localhost:8080` to the URL.
## License
AGPLv3, see LICENSE.
Copyright (C) 2020 The gamja Contributors
[soju]: https://soju.im
[webircgateway]: https://github.com/kiwiirc/webircgateway