Mactrix

A native macOS client for Matrix – an open protocol for decentralised, secure communications.

Overview

Mactrix is built with Apple's native AppKit and SwiftUI frameworks to provide seamless native integration with macOS. It leverages the robust matrix-rust-sdk for stability and performance.

Feel free to join our Matrix room at #mactrix:qpqp.dk.

Installation

You can download the latest stable release from the releases page under Assets. Keep in mind that Mactrix does not have an auto-updating system yet, so you will have to download updates manually. You can subscribe to Github releases to stay notified for new releases.

If you want to test out unreleased features, you can download automatically built versions of every commit to the main branch from the actions page under Artifacts.

Note

Mactrix is not notarized by Apple, so macOS may block it the first time you open it. If you get a popup stating that Apple could not verify the program, go to System Settings → Privacy & Security and click Open Anyway. Alternatively, run this command in the terminal:

xattr -d com.apple.quarantine /Applications/Mactrix.app

Build From Source

Requirements

• macOS 15.7 or later
• Up-to-date Xcode installed

Xcode will automatically download all dependencies when building the project for the first time.

Building

git clone https://github.com/viktorstrate/mactrix.git
cd mactrix
xed Mactrix.xcworkspace

Then open the project in Xcode and build using Cmd+B.

Completed Feature List

• Authentication
  • Password
  • OAuth
  • Email and Phone
• Multi account
• Timeline
  • Messages
    • Send attachments
    • Markdown formatting
    • Mention users
  • Message actions
    • Add reactions, Reply to, Pin, Edit
    • Delete
    • Download to file
    • View source
  • Show reactions
  • Group timeline state items
  • Show read receipts
  • Attachments
    • Support file, image, video, gallery
    • Support audio playback
    • Preview attachments
• Rooms
  • New room,
  • Room settings,
  • Invite to room
• Threads
  • Focus thread
  • Reply in thread
• Spaces
  • Show spaces in sidebar
  • Details view when selecting a space
  • Drag and drop to organize spaces
• Search bar
  • Search in joined rooms and directs
  • Search for users
  • Search for public rooms
  • Search for messages
  • Search for room or user ID directly
• Settings
  • Account details
  • Sign out
  • Sessions
    • Emoji verification
    • See verified / unverified status
    • Verify with recovery key
    • Change recovery key
    • Rename current and other sessions
    • Sign out other sessions
    • Send only to verified users
    • Export / import encryption keys
  • Start on login
  • Presence
    • Read receipts and typing indicator toggles
• Notifications
  • Message notification
  • Verify session notification
• Multiple windows and tabs
• Navigation: forwards and backwards button
• Support matrix URLs
• Keyboard navigation and accessibility
• Video and voice chat

Screenshots

Main Chat Interface

Device Verification

The app supports device verification by comparing emojis with another client.

Create Room

Creation

Search

Find specific rooms, users, and public communities from the search bar.