GtkHx is a client for Hotline, the chat and file-sharing system from 1996. A Hotline server is a small community of its own: a public chat room, private messages, a shared file library, and a news board, all run by whoever hosts it. Trackers list the servers that are up, so you can go looking for one.
GtkHx was first written in 2000 for GTK+ 1.2. It has since been rebuilt for GTK 4 and libadwaita, and much of it rewritten in Rust, while staying fully compatible with the Hotline 1.2, 1.5 and 1.9 servers still running today.
- Linux: install from GtkHx's Flatpak repository, which keeps it up to
date with the rest of your Flatpak apps:
flatpak install --user https://dl.gtkhx.org/gtkhx.flatpakref. For betas,gtkhx-beta.flatpakref. If you installed a.flatpakbundle from a release before, runflatpak uninstall com.nasledov.gtkhxfirst; your settings stay. - macOS: the
.zipfor Apple silicon (arm64) or Intel (x86_64) from the releases page. - Windows: the
win64.zip, from the same page.
Or build it yourself; see Building.
GtkHx comes with a few servers in Settings → Connections to get you started. For more, open the tracker (Ctrl+T): it lists the servers that are online now, and you can search them by name.
- Chat with formatted text, colored names, inline images, emoji shortcodes, and a searchable history
- Private messages and private chat rooms
- Files: a two-panel browser for downloading and uploading, with previews of images, PDFs, source code and classic Mac PICT files
- News: both the original flat news and threaded news with categories and replies
- Voice chat, video chat and screen sharing, on servers that support them
- Several servers at once, each in its own tab
- Secure connections over TLS, with fingerprint pinning, and encrypted logins with Blowfish or ChaCha20-Poly1305
- Your layout: dock panels side by side or pull them out into windows of their own, the way the original Hotline client worked
- Themes, light and dark, including a Classic theme with the original pixel-art icons
- Notifications and a tray icon
- Runs on Linux, macOS and Windows
GtkHx also speaks the modern extensions some servers offer: native UTF-8, large file transfers, chat history, GIF icons, and tracker v3 with search.
GtkHx works with any Hotline 1.2, 1.5 or 1.9 server. It is tested against mhxd, Janus, hxd-ng and the Argus tracker.
You need Meson, a C compiler, Rust (see rust-version in
rust/Cargo.toml), and:
- GTK 4.16 or newer, libadwaita 1.6 or newer, GLib 2.76 or newer
- mullion-gtk 0.3.1 or newer (the dock), which Meson fetches and builds into GtkHx when it is not installed
- For voice and video: GStreamer 1.20 or newer, with its WebRTC plugin and libnice
Optional, each adding a kind of file preview: poppler (PDF), gtksourceview 5 (source code and markdown), ImageMagick (complex PICT images).
meson setup build
meson compile -C build
meson install -C buildVoice and video are built when GStreamer is found. -Dvoice=disabled
leaves them out, and -Dvoice=enabled makes a missing GStreamer an
error.
Update notices are on by default only when building for Windows or macOS,
meant for the builds GtkHx ships itself. Linux distribution packagers can keep
-Dupdate_check at its default; Homebrew, MacPorts and MSYS2 packagers should
pass -Dupdate_check=disabled. See docs/updates.md.
flatpak-builder --user --install --force-clean build-flatpak \
com.nasledov.gtkhx.yml
flatpak run com.nasledov.gtkhxTests run against a set of Hotline servers and trackers in Docker;
tests/run.sh builds and starts them, and
tests/COMPOSE.md describes the setup. Then:
tools/isolated-run.sh meson test -C buildtools/isolated-run.sh runs the tests on a private display and audio
server, so they can't reach your desktop.
- docs/ explains how each part of GtkHx works.
- ROADMAP.md is what's planned, and BACKLOG.md the smaller known gaps.
- AGENTS.md is the orientation guide to the codebase.
- The screenshots above are generated; see docs/screenshots.md.
GtkHx is free software, under the GNU General Public License, version 2 or (at your option) any later version. See LICENSE.