Skip to content
mishanPublic

About

A Hotline client for GTK 4 and libadwaita, largely written in Rust. It works with servers of every Hotline protocol version and implements the modern protocol extensions: voice and video chat, inline media, animated icons and chat history.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Latest commit

 

History

2,953 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GtkHx

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.

Chat on a Hotline server

Screenshots

Browsing a server's files Threaded news
Browsing a server's files Threaded news
Finding servers on a tracker Video chat
Finding servers on a tracker Video chat and screen sharing
The Classic theme Transfers
The Classic theme, with the original pixel-art icons Transfers you can pause and resume, and the server's queue

Get GtkHx

  • 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 .flatpak bundle from a release before, run flatpak uninstall com.nasledov.gtkhx first; your settings stay.
  • macOS: the .zip for 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.

Finding a server

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.

Features

  • 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.

Servers

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.

Building

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 build

Voice 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

flatpak-builder --user --install --force-clean build-flatpak \
    com.nasledov.gtkhx.yml
flatpak run com.nasledov.gtkhx

Contributing

Tests 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 build

tools/isolated-run.sh runs the tests on a private display and audio server, so they can't reach your desktop.

License

GtkHx is free software, under the GNU General Public License, version 2 or (at your option) any later version. See LICENSE.

About

A Hotline client for GTK 4 and libadwaita, largely written in Rust. It works with servers of every Hotline protocol version and implements the modern protocol extensions: voice and video chat, inline media, animated icons and chat history.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages