Fork of GlowingBear, with a different login page pre-filling informations.
Find a file
Lorenz Hübschle-Schneider 6fc6ef68ff Add a bit of FAQ
2014-06-12 12:27:23 +01:00
3rdparty Update favico.js to beyond bleeding edge 2014-02-02 12:55:28 +00:00
assets Crunch the svg as well 2014-05-24 11:14:33 +01:00
css Fix highlighting of channel upon selection in mobile firefox 2014-06-10 15:51:56 +01:00
directives Revert the revertion of multiline and clean it up for new directive. 2014-04-26 18:16:46 +02:00
js Do not automatically switch to newly open buffer. 2014-06-10 16:59:45 +02:00
.travis.yml Travis: disable build success IRC notifications 2014-05-03 14:17:57 +01:00
COPYING Add license information 2013-10-04 16:52:45 -04:00
index.html Turn notimestamp into a positive setting (showtimestamp) 2014-06-07 19:52:22 +01:00
manifest.json Use http URLs in app manifest, too 2014-05-07 23:03:41 +01:00
manifest.webapp PNG size optimisations, fix icon paths in firefox app (and use our logo) 2014-05-24 11:08:11 +01:00
README.md Add a bit of FAQ 2014-06-12 12:27:23 +01:00

A web client for WeeChat Build Status

Glowing Bear is a HTML5 web frontend for WeeChat that strives to be a modern and slick interface on top of WeeChat. It relies on WeeChat to do all the heavy lifting (connection, servers, history, etc) and then provides some nice features on top of that, like content embedding (images, video) and desktop notifications. The main advantage, though, is that you can access it from any modern device without having to worry about ssh connections or terminal emulators.

Glowing Bear uses WeeChat directly as the backend through its relay plugin, which allows it to directly connect to WeeChat from the browser using Websockets. That means that the client does not need a special "backend service", and you don't have to install anything. A connection is made from your browser to your WeeChat, with no services in between. Thus, Glowing Bear is written in pure client-side JavaScript with a bit of HTML and CSS.

Getting started

Required WeeChat version: 0.4.2

To use the web interface you first need to set a relay and a password:

/relay add weechat 9001
/set relay.network.password YOURPASSWORD

Then go to the GitHub hosted version of Glowing Bear!

You can run Glowing Bear in multiple ways: use it like any other webpage, as a Firefox or Chrome app, or a full-screen Chrome app on Android ("Add to homescreen"). We also provide an Android app that you can install from the Google Play Store.

Screenshots

Running as Chrome application in a separate window on Windows and as Firefox application on Android:

Glowing bear screenshot

FAQ

  • Can I use Glowing Bear to access a machine or port not exposed to the internet by passing the connection through my server? No, that's not what Glowing Bear does. You can use a websocket proxy module for your webserver to forward /weechat to your WeeChat instance though. Here are some pointers you might find helpful for setting this up with nginx or apache.
  • How does the encryption work? TLS is used for securing the connection if you enable encryption. You can find more detailed instructions on how to communicate securely in the "encryption instructions" tab on the landing page. Note that your browser will perform the certificate validation, so it is strongly recommended to use a certificate that your browser trusts.

Development

Getting started with the development of Glowing Bear is really simple, partly because we don't have a build process (pure client-side JS, remember). All you have to do is clone the repository, fire up a webserver to host the files, and start fiddling around. You can try out your changes by reloading the page.

Here's a simple example using the python simple web server:

git clone https://github.com/glowing-bear/glowing-bear
cd glowing-bear
python -m SimpleHTTPServer

Now you can point your browser to http://localhost:8000!

Remember that you don't need to host Glowing Bear yourself to use it, you can just use the GitHub hosted version, and we'll take care of updates for you. Your browser connects to WeeChat directly, so it does not matter where Glowing Bear is hosted.

If you'd prefer a version hosted with HTTPS, GitHub serves that with a undocumented, not officially supported link that as well. Be careful though, it might break any minute. Don't blame us if it stops working, you've been warned. Anyway, here's the link: secret GitHub HTTPS link (the trailing forward slash in the URL seems to make all the difference).

Contributing

Interested in contributing or simply want to talk about the project? Join us at #glowing-bear on freenode!