Nexus Client

Warning

Nexus Client is still in development, and doesn't support everything needed for daily use.

Description

A simple and user-friendly Matrix client made with Flutter and a Gomuks backend.

Screenshots

Dark Mode	Light Mode

Progress

• Platform Support
  • Linux
  • Windows - Currently has some bugs, due to us not having any developers on Windows. If you want to fix these, get in contact with us though the Nexus Client Matrix room.
  • Android
  • MacOS - Unsigned .dmg only
  • iOS - Unsigned .ipa only
  • Web (may not be possible)
• Login (via OAuth)
• Rooms / Spaces
  • Displaying and choosing
  • Reading, showing unread
    • Mark as read button on rooms and spaces
  • Searching
  • Creating (Rooms, Spaces, and DMs)
  • Joining
    • Parse vias
    • Using a text/uri/link
      • Plain text
      • matrix: Uri
      • Matrix.to link
    • From space
    • From directory
  • Leaving
  • Subspaces
• Messages
  • Encryption
    • Restoring crypto identity from a recovery passphrase/key
  • Sending
    • Plain text
    • HTML/Markdown
    • Replies
      • Choose ping on/off
    • Per message profiles
    • Attachments
    • Commands with MSC4391
    • Mentions
      • Users
      • Rooms
      • Inline emoji picker (Putting this here since it'll be implemented the same way as mentions)
    • Custom emojis/stickers
    • GIFs using Gomuks' GIF proxies
  • Receiving
    • Plain text
    • Per message profiles
    • HTML
    • URL Previews
    • Replies
      • Viewing
      • Jump to original message
        • In loaded timeline
        • Out of loaded timeline
    • Edits
    • Attachments
      • Unencrypted
      • Encrypted
      • Blurhashing
      • Downloading attachments
      • Opening attachments in their own view
    • Polls
    • Mentions
      • Users
        • Clickable
      • Rooms
        • Clickable
        • Matrix URIs
        • Matrix.to links
      • Events
        • Render more nicely
        • Clickable
    • Custom emojis/stickers
    • History loading
  • Editing
  • Deleting
• Reactions
• Pins
  • Displaying
  • Pinning/Unpinning
• Threads
• Profile popouts
  • Working actions
• Copy link to:
  • Room
  • Space
  • Message
• Reporting
  • Events
  • Rooms
• Member list
  • Sort by power level
  • Colors based off of power level
• Notifications using UnifiedPush (#35)
• Notifications page
• Group calls using MSC4195
• Invites
• Settings

Try it out

If you want to try out Nexus, grab one of the following artifacts from CI:

• Android APK
• Windows EXE
• Unsigned iOS IPA
• Unsigned MacOS DMG
• Windows EXE
• Flatpak
  • AArch64/Arm64
  • x86_64/AMD64

Build it yourself

Prerequisites

Linux

• On NixOS: Either use direnv and direnv allow, or nix flake develop
• On other distros: Install Flutter, Go, Git, Libclang, Libass, MPV, and Glibc. Do not use any Snap packages, they cause various compilation issues.

Windows

You will need:

• Flutter
• Git
• Libass
• MPV
• Go
• Visual Studio 2022 (Desktop development with C++)
• MSYS2/MinGW-w64 GCC (for CGO)
• LLVM/Clang + libclang (for ffigen)

On Windows, make sure these are available in your shell PATH:

• C:\msys64\ucrt64\bin (or your MinGW bin path containing x86_64-w64-mingw32-gcc.exe)
• C:\Program Files\LLVM\bin (contains clang.exe and libclang.dll)

For dart scripts/generate.dart, you may also need:

$env:CPATH = "C:\msys64\ucrt64\include"

MacOS

Similar prerequisites apply (Flutter, Git, Go, C toolchain, LLVM/libclang), but exact setup has not been fully documented yet.

Clone repo

First, clone and open the repo:

git clone --recurse-submodules https://git.federated.nexus/Nexus/nexus
cd nexus

Set up Flutter

Get dependencies:

flutter pub get

Generate Gomuks bindings:

dart scripts/generate.dart

Note

If you are having issues with stddef.h not being found, try setting CPATH manually:

export CPATH="$(clang -v 2>&1 | grep "Selected GCC installation" | rev | cut -d' ' -f1 | rev)/include"

Build webcrypto:

flutter pub run webcrypto:setup

Build generated files, and watch for new changes:

flutter pub run build_runner watch

Run the app:

flutter run

Development instructions can be found in DEVELOPMENT.md.

Community

Join the Nexus Client Matrix room for questions or help with developing or using Nexus Client.

Credits

Thank you Hylke Bons (https://planetpeanut.studio) for making the amazing icon for Nexus! Thank you Tulir Asokan for making Gomuks, and helping us integrate it into Nexus!