~emersion/gamja

Simple IRC web client
10 days ago
10 days ago

#gamja

A bare-bones IRC web client.

screenshot

#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:

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

#Query parameters

gamja settings can be overridden using URL query parameters:

  • server: path or URL to the WebSocket server
  • channels: comma-separated list of channels to join

#Contributing

Send patches on the mailing list, report bugs on the issue tracker. Discuss in #soju on Freenode.

#License

AGPLv3, see LICENSE.

Copyright (C) 2020 The gamja Contributors