Repository navigation
imsg v1.0.0 — Native Linux Qt6/QML iMessage, SMS & RCS Client
imsg v1.0.0 — Native Linux Qt6/QML iMessage, SMS & RCS Client
imsg is a native C++20 and Qt6/QML desktop and CLI client for Apple iMessage, RCS, and SMS on Linux (Arch Linux, Omarchy, Wayland/Hyprland, KDE Plasma, GNOME), powered by a macOS BlueBubbles relay.
Highlights
- Zero-Config First-Run GUI Setup (
Ctrl+,/⚙ Server): Configure your Primary BlueBubbles Server URL, Optional Failover URL, and API Password directly from the app or via~/.config/imsg/config.json/libsecret(secret-tool). - Real-Time Socket.IO v4 Push & Multi-Channel HTTP Isolation: Dedicated
QNetworkAccessManagerpools (m_sendNam,m_mediaNam,m_socketNam) prevent heavy photo downloads from blocking outbound message sends or typing indicators. - Native HEIC/AVIF Magic-Byte Decoding: Automatically detects disguised Apple
ftyp(heic,heix,mif1,avif) attachments and converts them viaheif-convert(libheif) or ImageMagick with built-in full-window zoomable photo gallery. - Tapback Reactions, Sticker Overlays & Rich Link Previews: Interactive
❤️ 👍 👎 😂 !! ?reaction pills with sender attribution tooltips, sticker overlays, YouTube embeds, and asynchronous OpenGraph link preview cards. - Authoritative SQLite Read-State Sync & Unjoined SMS Recovery: Reconciles
message.is_read = 0directly against macOSchat.dband synthesizes fallback threads for unjoined short-code 2FA SMS rows. - Omarchy Live Theme Sync & Split-Window Responsive Layout: Automatically reloads
~/.config/omarchy/current/theme/colors.tomland adapts cleanly down to 50% tiled split-window widths. - Headless CLI Automation:
imsg status [--json],imsg recent [--limit N] [--json], andimsg send <to> <text> [--json].
Installation (Arch Linux)
# Install the prebuilt Arch Linux package attached below:
sudo pacman -U imsg-1.0.0-1-x86_64.pkg.tar.zst
# Or build from PKGBUILD.aur:
makepkg -si -p PKGBUILD.aurRelease Tarball Checksum (v1.0.0.tar.gz)
025aee701cfce5edafb8e8316b6cc58eba1f17145022fd33b8c2c4f5e3bc0b4c imsg-1.0.0.tar.gz
Full Changelog: https://github.com/nertwork/imsg/commits/v1.0.0