Komai · こまい

A fine Matrix chat app you can get to love

A native desktop Matrix client for Linux, Windows, and macOS. It started as a fork of nheko, got rebuilt on Rust, and it's named after the komainu, the lion-dogs that guard a shrine gate. Fast, quiet, and built to live on your desktop instead of a browser tab.

Free and open source, under GPL-3.0-or-later.

The Komai main chat window: a room list on the left, a message timeline in the middle, and the composer at the bottom

Why a native app

You already have too many browser tabs open. Chat doesn't need to be one of them.

Quick and light

Built in Rust, C++, and QML, which is the fancy way of saying it starts fast and stays out of your RAM. No Electron, no bundled browser, no fan spinning up because you opened a chat app.

Made for a real screen

Desktop-first, not a phone app that got stretched. Room tabs across the top, keyboard and Vim-style shortcuts under your fingers, and a layout that actually uses your monitor.

Yours to shape

10+ themes tuned for real contrast, plus any you write yourself. It all lives in plain YAML, so set it up once and carry that file to every machine you own.

Room tabs, with pinning

Keep the rooms you live in one click away. Open a handful across the top, pin the ones that matter, and flip between them like browser tabs. Still weirdly rare in Matrix clients, and the kind of thing you can't give up once you've had it.

A row of pinned room tabs across the top of the Komai window

Select messages like files

Drag across a run of messages, Ctrl-click a few, or grab them from the keyboard, then copy, reply, forward, or delete the lot in one move. The clean way to tidy a channel, or lift a whole thread of quotes out of a busy room without death by right-click.

Several messages highlighted at once in the Komai timeline with a batch-action toolbar

Drive it from the outside

Komai speaks MCP, ships CLI commands, and answers on D-Bus, so scripts and other programs on your machine can read and send messages through it. Most chat apps are a sealed box. This one has doors. That's a real script in the screenshot, posting into a room over the API.

An external tool sending messages through Komai over its automation interface

Voice and video, built in

Element Call is wired right into Komai: end-to-end encrypted MatrixRTC calls, one-on-one or a whole room piling in, with no separate app to launch.

Calls are Linux-only for now. The Windows and macOS builds ship without voice or video, so you'll know going in, not after.
An Element Call voice and video call running inside Komai

Find rooms worth joining

The room directory searches the wider Matrix network through matrixrooms.info, the public room index etke.cc builds and runs. Filter by name, topic, or how alive a room is, and actually find your people instead of trading room addresses in a DM.

Komai room directory searching public Matrix rooms through matrixrooms.info

And the rest of the day-to-day

The things you expect from a Matrix client, done properly.

  • End-to-end encryption

    Encrypted messaging on the Rust matrix-sdk. Device verification and key backup are built in.

  • Threads and forwarding

    Replies, Discord-style threads, and forwarding a message on to another room.

  • Media viewer

    View images and play audio and video in the app, without bouncing out to another window.

  • Voice transcription

    Long-press Space to dictate straight into the composer, through any OpenAI-compatible backend you point it at.

  • Offline spellcheck

    Multi-language checking that runs on your machine and picks up your system dictionaries.

  • Custom emoji

    Your own emoji, with CLDR keyword search, so typing :whiskey finds πŸ₯ƒ.

  • Metadata stripping

    EXIF, IPTC, and XMP data is stripped from images before upload, on by default.

  • Application profiles

    Keep separate accounts in separate profiles and switch between them cleanly.

  • Message effects

    Little touches like rain and thunder over a message when the moment calls for it.

  • Themes to spare

    10+ built-in themes tuned for WCAG AA contrast, plus themes you write yourself.

  • 30+ languages

    Komai speaks your language, with more added as translators reach them.

  • Keyboard and Vim

    A keyboard-driven main workflow. Shortcuts come in both plain and Vim-style throughout.

Download Komai

Free, open source, and always the current build. Pick your platform.

🐧 Linux

x86_64 and arm64
  • AppImage, one portable file that runs just about anywhere
  • Flatpak, sandboxed, straight from the release page
  • Arch: komai-bin (prebuilt) or komai (from source) on the AUR

The AppImage needs FUSE 2. Most distros moved on to FUSE 3, so if it refuses to start, that's why. Grab the compat package with sudo apt install libfuse2 on Debian or Ubuntu, or fuse2 on Arch.

πŸͺŸ Windows

x64, Windows 10 22H2+
  • Portable ZIP, no installer
  • Extract anywhere and run komai.exe

Not code-signed yet, so Windows throws a SmartScreen warning on first launch. Click More info, then Run anyway, and you're in.

No voice or video calls in this build, and no auto-update, so each new version is a fresh download.

🍏 macOS

Apple Silicon, macOS 13.3+
  • DMG for Apple Silicon Macs
  • Drag komai.app into Applications

Not signed or notarized yet, so Gatekeeper gets nervous on first launch. On macOS 13 and 14, right-click the app and hit Open. On 15 and up, open it once, then approve it under System Settings, Privacy & Security, Open Anyway.

Apple Silicon only for now, and no voice or video yet.

Want an older version, a checksum to verify against, or a URL to pin in your own scripts? It's all on the GitHub releases page.

Made by the etke.cc team

Komai is built by the team at etke.cc, on the matrix-rust-sdk, and it began as a fork of nheko by the Nheko-Reborn team (thanks, folks). The room search inside it runs on matrixrooms.info, the Matrix room index etke.cc also maintains, and when we're not building clients we run managed Matrix hosting for people who'd rather not babysit a server.

Like the client but don't want to run a homeserver? The same crew can host one for you at etke.cc.

GPL-3.0-or-later. No CLA, no contributor gatekeeping, no hoops.