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 but all major mobile and desktop platforms are supported to some degree.
Lith is a utility application for WeeChat (not to be confused with WeChat), a terminal chat application mostly focused on the IRC protocol. It is a only a graphical relay for messages that are actually received and sent by WeeChat. That means you need to prepare a WeeChat instance on on your computer or server (or have a provider do that for you) to be actually able to use Lith in any meaningful way.
For setup on the WeeChat side, please consult the following sources:
On desktop systems, you can run WeeChat on the same device as Lith but the main focus of this project is to handle remote connections, especially on mobile platforms and iOS in particular. The remote WeeChat server needs to be directly over the internet either through a TCP socket or WebSockets.
There is also a browser version of Lith you can try right now thanks to WebAssembly: https://lith.app/Lith/.
Lith currently supports the following platforms:
Lith is written using C++ and the Qt framework with QML. The only supported version is Qt 6.5 and newer. Other dependencies are listed below.
When building for all supported platforms, only the following steps should be necessary if CMake is setup correctly:
mkdir build && cd build
cmake ..
cmake --build .
Alternatively, you can just open the project file in Qt Creator.
There is also a package for Arch Linux in the AUR: https://aur.archlinux.org/packages/lith-git
Besides Qt, Lith currently depends on the packages listed below. You don't need to install them manually. This can be controlled, see the section below describing the CMake options to choose which packages to use.
Qt always needs to be installed outside of Lith's build system. Other dependencies are:
LITH_FEATURE_KEYCHAIN
- ON
by default. Enables keychain integration on Linux, macOS, Windows, iOS and Android.LITH_FEATURE_QHOT
- OFF
by default. Builds internal qhot
instance and adds a target to automatically run Lithqhot
. Not useful for end users.LITH_FORCE_DOWNLOAD_DEPENDENCIES
- OFF
by default. Makes CPM go for downloading packages fromLITH_FORCE_LOCAL_PACKAGES_ONLY
.LITH_FORCE_LOCAL_PACKAGES_ONLY
- OFF
by default. Enforces usage of only packages installed on localFor bug reports and questions, feel free to use the Issues page here on GitHub.
There's also an IRC channel: #lith
on libera.chat (irc.libera.chat:6697 with SSL)
You can contact me directly on [email protected]