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/.
- Inline preview of images and videos
- Fast buffer list filtering
- Dark and light mode support
- Native local notifications on desktop platforms
- Secure storage of login credentials
- Message text is not selectable
- Keyboard shortcuts can only be tweaked by editing the config file
- Android: Builds are not tested at all at this moment, not signed, currently not installable without signing
- macOS: Builds are not signed + Some keyboard shortcuts are broken
- Windows: Builds are not signed + There is no installer
- WebAssembly: Builds are pretty large (around 12MB at this moment), there are keyboard focus issues and video preview support is not supported.
- More: https://github.com/LithApp/Lith/issues
- Full App Store release
- Push notification support (first on iOS, then Android, probably)
Lith currently supports the following platforms:
- (Usable) iOS and iPadOS:
- RECOMMENDED: https://testflight.apple.com/join/QfcVgNHD - "Stable" track - even minor releases
- https://testflight.apple.com/join/xS3hWrmj - "Unstable" track - more or less everything I tag with an odd minor version, may be messy
- (build-only) Android: https://github.com/LithApp/Lith/releases
- (Usable) Linux: https://flathub.org/apps/details/app.lith.Lith
- (Usable, not tested) Windows: https://github.com/LithApp/Lith/releases
- (Usable, not tested) macOS: https://github.com/LithApp/Lith/releases
- (Not tested, feature gaps) WebAssembly: https://lith.app/Lith/
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:
- qtkeychain - Used to store login info (host, port, passphrase, ...).
- QCoro - Simplifies programming asynchronous code with Qt C++ coroutine integration.
- qhot - (Development only) Provides hot reload for QML, I use this to speed up UI feature development.
LITH_FEATURE_KEYCHAIN-ONby default. Enables keychain integration on Linux, macOS, Windows, iOS and Android.LITH_FEATURE_QHOT-OFFby default. Builds internalqhotinstance and adds a target to automatically run Lith inqhot. Not useful for end users.LITH_FORCE_DOWNLOAD_DEPENDENCIES-OFFby default. Makes CPM go for downloading packages from GitHub without checking local system. This option takes preference overLITH_FORCE_LOCAL_PACKAGES_ONLY.LITH_FORCE_LOCAL_PACKAGES_ONLY-OFFby default. Enforces usage of only packages installed on local system.
For 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 m@rtinbriza.cz