Skip to content
Simple Weechat-Relay Android Client
Java Shell Python
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Weechat Android Relay Client

This is an Android Weechat Relay client. It is currently in beta status, with most things working. It has not been extensively tested, so it may force close or drain your battery excessively.(However, in my limited testing it seems quite fine, I use it daily)


Stable version

Either scan the QR code, or click the link to download the apk. Click on it and choose to install. Download Link


Latest Development Snapshot

If you're feeling adventurous, you can try the latest development version. This is built after every commit, and while I try to keep a working build, it may fail or have major bugs.

Get the latest development version here

Bug Reports and Feature Requests Welcome!

Please report any bugs or feature requests here on github, or send me an email: You can also ping me in #weechat on freenode.

Basic Usage

At the main screen, press menu, then choose preferences. Configure your hostname, port, and password. Some other options:

  • Connect automatically
  • Automatically reconnect, useful on a flakey network
  • Colors in chat(may be slow depending on device)
  • Timestamps can be toggled to make better use of screen space
  • Messages filtered by weechat can be filtered here(e.g. irc_smart_filter)
  • Play the default notification sound on highlight/private message

Then press Menu->Connect to connect to the server. If successful you will see a list of your weechat buffers. Clicking on a buffer opens it. A buffer currently displays the 200 most recent lines(including possible filtered lines). I plan to make this configurable in the future(More is slower).

The nicklist is missing from this version, I'm looking at the most useful way to add it back.

The app does run in the background, however if you would like to exit it, from the buffers list menu->quit. I've run it in the background all day with no real noticable drain on my battery.

Requirements + Setup

  • Weechat v0.3.7+
  • Android 2.1+ - The only permissions needed are internet access.
  • Note: If you want support for highlights(private message notifications will work otherwise), you must be using Weechat v0.3.8-dev after March 6th.

In weechat, you will need to configure the relay server. /help relay will get you most of the way there. Basically you will need to run:

/relay add weechat 8001

This will setup weechat to listen on port 8001 for connections. Make sure your firewall is setup to allow access to this port. You will probably want to set as well. Communications with weechat are not encrypted at this point in time.

Source Code

There are 3 basic parts to this, the android application, the java library which provides most of the functionality of connecting to the weechat relay server, and an example client showing the basic features of that library.

  • weechat-android - The android application.
  • weechat-relay - A library implementing the Weechat Relay Protocol
  • weechat-relay-example - A simple example program that makes use of the weechat-relay library

You can build these projects by running 'ant' from this directory. If you wish to build them individually, you must build weechat-relay(the library) first.

To build the android application, you will need to 'cd weechat-android', then run 'android update project --path .' before running ant.

For more details about Weechat and the Relay Protocol:


In this last one, the "U: 2 H: 1" in purple refers to 2 unread messages, 1 highlight. If it was only unread messages it is displayed in yellow.



  • Complete rewrite of the frontend
  • Support Notifications
  • Background service
  • Message filters
  • UTF-8 Support(Fixes #1)


  • Skipped


  • Preferences for Colors/Timestamp
  • Highlight support for messages
  • Misc bugfixes


  • Colors!
  • A few bugfixes


  • Initial Release
Something went wrong with that request. Please try again.