logo glowing bear WeeChat web frontend

Connection error The client was unable to connect to the WeeChat relay
Secure connection error A secure connection with the WeeChat relay could not be initiated. This is most likely because your browser does not trust your relay's certificate. Please read the encryption instructions below!
Secure connection error Unable to connect to unencrypted relay when your are connecting to Glowing Bear over HTTPS. Please use an encrypted relay or load the page without using HTTPS.

Configuring the relay

To start using glowing bear, please enable the relay plugin in your WeeChat client:
/set relay.network.password yourpassword
/relay add weechat 9001
WeeChat version 0.4.2 or higher is required.
The communication goes directly between the app and your WeeChat relay in plain text. Check the instructions below for help on setting up encrypted communication. Connection settings, including your password, are saved locally on your device between sessions.

Shortcuts

Glowing Bear has a few shortcuts:
  • ALT-n: Toggle nicklist
  • ALT-l: Focus on input bar
  • ALT-[0-9]: Focus on buffer
  • ALT-a: Focus on next buffer with activity
  • ALT-<: Switch to previous buffer
  • ALT-g: Focus on buffer list filter
  • Esc-Esc: disconnect (double-tap)
  • arrow keys: history navigation

If you check the encryption box, the communication between browser and WeeChat will be encrypted with SSL.

Note: If you are using a self-signed certificate that is not trusted by your device, you have to visit https://{{ host || 'weechathost' }}:{{ port || 'relayport' }}/ in your browser first to add a security exception. You can close it once you confirmed the certificate, no content will appear. This is a bug in the browsers.

Setup: If you want to use an encrypted session you first have to set up the relay to use SSL. You basically have two options: a self-signed certificate is easier to set up, but requires manual security exceptions. Using a certificate that is trusted by your device requires more setup, but does not require any security exceptions. As the process for requesting a certificate is different for every certification authority, we detail the method for setting up WeeChat with a self-signed certificate here. To create one, execute the following commands in a shell on the same host and as the user running WeeChat:

$ mkdir -p ~/.weechat/ssl
$ cd ~/.weechat/ssl
$ openssl req -nodes -newkey rsa:4096 -keyout relay.pem -x509 -days 365 -out relay.pem -subj "/CN={{host || 'your weechat host'}}/"

If WeeChat is already running, you can reload the certificate and private key and set up an encrypted relay on port 8000 with these WeeChat commands:

/relay sslcertkey
/relay add ssl.weechat 8000

Glowing bear is built by a small group of developers in their free time. As we're always trying to improve it, we would love getting your feedback and help. If that sounds like something you might enjoy, check out our main project page and its mobile app spin-off on GitHub!

If you're interested in contributing or simply want to say hello, head over to #glowing-bear on freenode! We won't bite, promise (-ish).

brand
Fetch more lines Fetching more lines...
: