mirror of https://codeberg.org/emersion/gamja.git synced 2024-11-28 18:26:19 -05:00

A simple IRC web client

Find a file

Simon Ser 5507b3253b Mark server buffer as unread after server query command When a command will print its reply in the server buffer, mark it as unread to make it more obvious where to look. Closes: https://todo.sr.ht/~emersion/gamja/53		2021-06-10 19:33:59 +02:00
components	Bump direct message unread priority	2021-06-10 18:57:57 +02:00
lib	s/var/let/	2021-06-10 18:11:11 +02:00
.editorconfig	Add .editorconfig	2020-07-22 14:51:37 +02:00
.gitignore	Add support for config file	2021-05-25 12:33:22 +02:00
commands.js	Mark server buffer as unread after server query command	2021-06-10 19:33:59 +02:00
index.html	Set the viewport meta tag	2021-05-26 22:42:35 +02:00
keybindings.js	s/var/let/	2021-06-10 18:11:11 +02:00
LICENSE	Initial commit	2020-04-24 19:03:43 +02:00
package-lock.json	Update dependencies	2021-05-17 09:52:42 +02:00
package.json	Update preact	2021-01-12 16:04:49 +01:00
README.md	readme: make it clear server.url can be a path in config.json	2021-06-10 18:28:44 +02:00
state.js	s/var/let/	2021-06-10 18:11:11 +02:00
store.js	s/var/let/	2021-06-10 18:11:11 +02:00
style.css	Improve buffer header layout on mobile	2021-06-06 17:27:05 +02:00

README.md

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:

[fileserving]
enabled = true
webroot = /path/to/gamja

Then connect to webircgateway and append ?server=/webirc/websocket/ to the URL.

nginx

If you use nginx as a reverse HTTP proxy, make sure to bump the default read timeout to a value higher than the IRC server PING interval. Example:

location /socket {
	proxy_pass http://127.0.0.1:8080;
	proxy_read_timeout 600s;
	proxy_http_version 1.1;
	proxy_set_header Upgrade $http_upgrade;
	proxy_set_header Connection "Upgrade";
	proxy_set_header X-Forwarded-For $remote_addr;
	proxy_set_header X-Forwarded-Proto $scheme;
}

If you are unable to configure the proxy timeout accordingly, you can set the server.ping option in config.json to an interval, in seconds, between which gamja will send opportunistic pings.

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
nick: nickname
channels: comma-separated list of channels to join (# needs to be escaped)

Alternatively, the channels can be set with the URL fragment (ie, by just appending the channel name to the gamja URL).

Configuration file

gamja default settings can be set using a config.json file at the root:

{
	// IRC server settings.
	"server": {
		// WebSocket URL or path to connect to (string).
		"url": "wss://irc.example.org",
		// Channel(s) to auto-join (string or array of strings).
		"autojoin": "#gamja",
		// Controls how the password UI is presented to the user. Set to
		// "mandatory" to require a password, "optional" to accept one but not
		// require it, and "disabled" to never ask for a password. Defaults to
		// "optional".
		"auth": "optional",
		// Interval in seconds to send PING commands (number). Set to 0 to
		// disable. Enabling PINGs can have an impact on client power usage and
		// should only be enabled if necessary.
		"ping": 60
	}
}

Contributing

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

License

AGPLv3, see LICENSE.