Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Lith - Multiplatform WeeChat relay client

Lith is a project mostly focused on bringing a fast and user-friendly WeeChat client to all major desktop and mobile operating systems. The main focus of this project is to bring a full-featured native relay client to iOS (due to the lack of a native client there).

Lith in Linux

Getting Started

Lith is supposed to be run in addition to an existing WeeChat instance. In case you're planning to run Lith on your desktop-type device, WeeChat can be running locally and in case of both of mobile and desktop systems, WeeChat can be connected to over the network. In this case, it's necessary for WeeChat server to be directly reachable from your Lith device directly over the network.

Setup is necessary on the WeeChat side, please consult the following sources:

Binary Packages

Lith currently supports the following platforms:


  • Inline preview of images and videos
  • Fast buffer list filtering
  • Dark and light mode support
  • Native local notifications on desktop platforms


  • Message text is not selectable
  • Keyboard shortcuts can only be tweaked by editing the config file
  • Android: Builds are not signed
  • macOS: Builds are not signed + Some keyboard shortcuts are broken
  • Windows: Builds are not signed + There is no installer
  • More:

Future plans

  • Full App Store release
  • Push notification support (first on iOS, then Android, probably)

Build instructions

Lith is written using C++ and the Qt framework with QML. The only supported version is Qt 6.2 and newer.

When building for all supported platforms, only the following steps should be necessary (provided you have set up your Qt environment correctly):

mkdir build && cd build
qmake ..
make # nmake on Windows

Alternatively, you can just open the project file in Qt Creator.

There is also a package for Arch Linux in the AUR:

Get in touch

For bug reports and questions, feel free to use the Issues page here on GitHub.

There's also an IRC channel: #lith on ( with SSL)

You can contact me directly on