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%
| cmake/toolchains | ||
| include | ||
| release/v0.1.0 | ||
| src | ||
| tests | ||
| .gitignore | ||
| CMakeLists.txt | ||
| README.md | ||
| SPEC.md | ||
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
- Click File → Login
- Enter your homeserver URL (e.g.,
https://matrix.org), username, and password - The session is saved to
matrix_config.jsonfor auto-login
Sending messages
- Select a room from the room list
- Type your message and press Enter or click Send
Sending files
- Select a room
- Click Send → Send File
- 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