Mew, a full-featured Matrix protocol client in C, targeting Windows XP, Windows 11, and Linux. Features vodozemac E2EE, mbedtls TLS, sliding sync, MatrixRTC, and native Win32 GUI.
  • C 97.7%
  • CMake 2.3%
Find a file
2026-10-12 07:22:46 -04:00
cmake/toolchains Initial commit: Matrix client C with vodozemac E2EE 2026-10-09 08:05:18 -04:00
include feat: fix XP build with dllexport stubs, complete E2EE & Sliding Sync modules 2026-10-10 19:03:18 -04:00
release/v0.1.0 release: v0.1.1 - update Windows binaries with UI improvements 2026-10-12 07:22:46 -04:00
src feat(ui): complete sync parsing, file transfer, and invite handlers 2026-10-12 07:08:55 -04:00
tests Initial commit: Matrix client C with vodozemac E2EE 2026-10-09 08:05:18 -04:00
.gitignore chore: add .gitignore for deps/ 2026-10-10 21:22:43 -04:00
CMakeLists.txt feat: fix XP build with dllexport stubs, complete E2EE & Sliding Sync modules 2026-10-10 19:03:18 -04:00
README.md feat(ui): complete sync parsing, file transfer, and invite handlers 2026-10-12 07:08:55 -04:00
SPEC.md Rename project to 'mew' — update all references 2026-10-09 15:54:07 -04:00

mew — Matrix Client for Windows XP

A native Matrix client built in C with E2EE support via vodozemac. Designed to run on Windows XP SP3+ and Windows 11, with a Linux build also available.

Features

  • End-to-end encryption — Olm/Megolm via vodozemac-c
  • Sliding Sync — Real-time room updates
  • Native Win32 UI — No dependencies beyond the Windows API
  • File transfer — Upload/download via Matrix media repo
  • Room management — Join, leave, invite users
  • Persistent sessions — Config save/load for auto-login
  • Cross-platform builds — Linux x86_64, Windows XP (i686), Windows 11 (x86_64)

Requirements

Build dependencies

Dependency Minimum Version Purpose
CMake 3.20+ Build system
GCC (MinGW-w64) 12+ Cross-compilation for Windows
GCC (native) 12+ Linux build
Rust 1.70+ vodozemac-c FFI crate
OpenSSL dev 3.x TLS for HTTP client
zlib dev 1.2+ Compression

Runtime dependencies (Windows)

  • Windows XP SP3+ (i686 build) or Windows 10/11 (x86_64 build)
  • No additional libraries — statically linked everything
  • Visual C++ Runtime 2019+ (for MinGW-w64 runtime)

Building

1. Clone the repository

git clone https://git.meow.boutique/Lucky/mew.git
cd mew

2. Build dependencies

Debian/Ubuntu:

sudo apt install cmake gcc g++ make openssl zlib1g-dev pkg-config

Arch Linux:

sudo pacman -S cmake gcc make openssl zlib pkg-config

Windows (MSYS2 MinGW-w64):

# Install from MSYS2
pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-gcc \
          mingw-w64-x86_64-openssl mingw-w64-x86_64-zlib

3. Build vodozemac-c (FFI layer)

cd deps/vodozemac-c
cargo build --release
# Output: target/release/libvodozemac_c.a
cd ../..

4. Build

Linux x86_64 (native)

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
# Binary: build/bin/matrix-client

Windows 11 x86_64

cmake -B build-win11 \
  -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/x86_64-w64-mingw32.cmake \
  -DCMAKE_BUILD_TYPE=Release \
  -G "MinGW Makefiles"
cmake --build build-win11
# Binary: build-win11/bin/matrix-client.exe

Windows XP i686

cmake -B build-xp \
  -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/i686-w64-mingw32.cmake \
  -DCMAKE_BUILD_TYPE=Release \
  -G "MinGW Makefiles"
cmake --build build-xp
# Binary: build-xp/bin/matrix-client.exe

5. Create releases

mkdir -p release/v0.1.0

# Linux
cp build/bin/matrix-client release/v0.1.0/matrix-client-linux-x86_64

# Windows 11
cp build-win11/bin/matrix-client.exe release/v0.1.0/matrix-client-windows-11-x86_64.exe

# Windows XP
cp build-xp/bin/matrix-client.exe release/v0.1.0/matrix-client-windows-xp-x86.exe

Usage

Launching

Linux:

./build/bin/matrix-client

Windows: Double-click matrix-client.exe or run from command line.

First login

  1. Click File → Login
  2. Enter your homeserver URL (e.g., https://matrix.org), username, and password
  3. The session is saved to matrix_config.json for auto-login

Sending messages

  1. Select a room from the room list
  2. Type your message and press Enter or click Send

Sending files

  1. Select a room
  2. Click Send → Send File
  3. Choose the file to upload — it's uploaded to the media repo and sent as an m.file message

Sync

Click Sync → Start Sync to begin polling for new messages, room updates, and invites.

Project Structure

├── CMakeLists.txt              # Build configuration
├── cmake/
│   └── toolchains/             # MinGW cross-compilation toolchains
├── deps/
│   └── vodozemac-c/           # Rust FFI layer for vodozemac
├── include/
│   ├── matrix/                 # Core types
│   ├── protocol/               # Protocol APIs
│   └── crypto/                 # vodozemac-c bindings
├── src/
│   ├── ui/
│   │   ├── win32_main.c        # Win32 desktop client
│   │   └── console.c           # Console client (Linux/development)
│   ├── protocol/               # Matrix protocol implementations
│   │   ├── auth.c              # Login/register
│   │   ├── sync.c              # /sync polling
│   │   ├── sliding_sync.c      # MSC3575 sliding sync
│   │   ├── rooms.c             # Room join/leave/invite
│   │   ├── messages.c          # Send/receive messages
│   │   ├── upload.c            # Media upload
│   │   ├── download.c          # Media download
│   │   ├── encryption.c        # E2EE key management
│   │   └── homeserver.c        # /.well-known discovery
│   ├── e2ee/                   # End-to-end encryption
│   │   ├── olm_wrapper.c       # Olm session management
│   │   ├── megolm.c            # Megolm session management
│   │   ├── device_verifier.c   # Cross-signing
│   │   └── key_backup.c        # Key backup
│   └── core/                   # HTTP client, logging, utils
├── release/                    # Release binaries
└── build[+platform]/           # Build directories

Building from source (full dependency setup)

If you need to build everything from scratch:

# 1. Install build dependencies
# (see Requirements section above)

# 2. Clone vodozemac-c FFI if not present
git clone https://git.meow.boutique/Lucky/vodozemac-c.git deps/vodozemac-c

# 3. Build vodozemac-c
cd deps/vodozemac-c
cargo build --release
cd ../..

# 4. Build all targets
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake -B build-win11 -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/x86_64-w64-mingw32.cmake -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles"
cmake -B build-xp -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/i686-w64-mingw32.cmake -DCMAKE_BUILD_TYPE=Release -G "MinGW Makefiles"

cmake --build build
cmake --build build-win11
cmake --build build-xp

License

See LICENSE for details.

Contributing

Pull requests welcome! Please ensure all three build targets compile successfully before submitting.

Credits

  • vodozemac — Rust Matrix cryptographic library by Element
  • vodozemac-c — C FFI bindings
  • MinGW-w64 — Cross-compilation toolchain