matrix-rust-sdk

<h1 align="center">Matrix Rust SDK</h1>

<div align="center">

  <em>Your all-in-one toolkit for creating Matrix clients with Rust, from simple bots to full-featured apps.</em>

  <br />

  <img src="contrib/logo.svg">

  <hr />

  <a href="https://github.com/matrix-org/matrix-rust-sdk/releases">

    <img src="https://img.shields.io/github/v/release/matrix-org/matrix-rust-sdk?style=flat&labelColor=1C2E27&color=66845F&logo=GitHub&logoColor=white"></a>

  <a href="https://crates.io/crates/matrix-sdk/">

    <img src="https://img.shields.io/crates/v/matrix-sdk?style=flat&labelColor=1C2E27&color=66845F&logo=Rust&logoColor=white"></a>

  <a href="https://codecov.io/gh/matrix-org/matrix-rust-sdk">

    <img src="https://img.shields.io/codecov/c/gh/matrix-org/matrix-rust-sdk?style=flat&labelColor=1C2E27&color=66845F&logo=Codecov&logoColor=white"></a>

  <br />

  <a href="https://docs.rs/matrix-sdk/">

    <img src="https://img.shields.io/docsrs/matrix-sdk?style=flat&labelColor=1C2E27&color=66845F&logo=Rust&logoColor=white"></a>

  <a href="https://github.com/matrix-org/matrix-rust-sdk/actions/workflows/ci.yml">

    <img src="https://img.shields.io/github/actions/workflow/status/matrix-org/matrix-rust-sdk/ci.yml?style=flat&labelColor=1C2E27&color=66845F&logo=GitHub%20Actions&logoColor=white"></a>

</div>

<div align="center">

The Matrix Rust SDK is a collection of libraries that make it easier to build

[Matrix] clients in [Rust].

<br />

<br />

<picture>

  <source srcset="contrib/element-logo-light.png" media="(prefers-color-scheme: dark)">

  <source srcset="contrib/element-logo-dark.png" media="(prefers-color-scheme: light)">

  <img src="contrib/element-logo-fallback.png" alt="Element logo">

</picture>

<br />

<br />

Development of the SDK is proudly sponsored and maintained by

[Element](https://element.io). Element uses the SDK in their next-generation

mobile apps Element X on [iOS](https://github.com/element-hq/element-x-ios) and

[Android](https://github.com/element-hq/element-x-android) and has plans to

introduce it to the web and desktop clients as well.

The SDK is also the basis for multiple Matrix projects and we welcome

contributions from all.

</div>

## Purpose

The SDK takes care of the low-level details like encryption,

syncing, and room state, so you can focus on your app's logic and UI. Whether

you're writing a small bot, a desktop client, or something in between, the SDK

is designed to be flexible, async-friendly, and ready to use out of the box.

## Project structure

The Matrix Rust SDK is made up of several crates that build on top of each

other. The following crates are expected to be usable as direct dependencies:

- [matrix-sdk-ui](https://docs.rs/matrix-sdk-ui/latest/matrix_sdk_ui/) – A

  high-level client library that makes it easy to build full-featured UI clients

  with minimal setup. Check out our reference client,

  [multiverse](https://github.com/matrix-org/matrix-rust-sdk/tree/main/labs/multiverse),

  for an example.

- [matrix-sdk](https://docs.rs/matrix-sdk/latest/matrix_sdk/) – A mid-level

  client library, ideal for building bots, custom clients, or higher-level

  abstractions. You can find example usage in the

  [examples directory](https://github.com/matrix-org/matrix-rust-sdk/tree/main/examples).

- [matrix-sdk-crypto](https://docs.rs/matrix-sdk-crypto/latest/matrix_sdk_crypto/)

  – A standalone encryption state machine with no network I/O, providing

  end-to-end encryption support for Matrix clients and libraries. See the

  [crypto tutorial](https://docs.rs/matrix-sdk-crypto/latest/matrix_sdk_crypto/tutorial/index.html)

  for a step-by-step introduction.

All other crates are effectively internal-only and only structured as crates for

organizational purposes and to improve compilation times. Direct usage of them

is discouraged.

## Status

The library is considered production ready and backs multiple client

implementations such as Element X

[[1]](https://github.com/element-hq/element-x-ios)

[[2]](https://github.com/element-hq/element-x-android),

[Fractal](https://gitlab.gnome.org/World/fractal) and

[iamb](https://github.com/ulyssa/iamb). Client developers should feel confident

to build upon it.

## Bindings

The higher-level crates of the Matrix Rust SDK can be embedded in other

environments such as Swift, Kotlin, JavaScript, and Node.js. Check out the

[bindings/](./bindings/) directory to learn more about how to integrate the SDK

into your language of choice.

## License

[Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0)

[Matrix]: https://matrix.org/

[Rust]: https://www.rust-lang.org/