status-app/README.md

<div align="center">
    <img src="status.png" alt="status logo" width="200" />

[![Download](https://img.shields.io/github/v/release/status-im/status-app?label=Download)](https://github.com/status-im/status-app/releases/latest)

[<img alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" height="40">](https://play.google.com/store/apps/details?id=app.status.mobile)
[<img alt="Download on the App Store" src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" height="40">](https://apps.apple.com/us/app/status-privacy-super-app/id6754166924)

</div>

# Status App

The [**Status App**](https://status.app/) is a privacy-first, decentralised messenger built with [Nim](https://nim-lang.org/) and [Qt/QML](https://doc.qt.io/qt-5/qmlapplications.html). It offers end-to-end encrypted messaging, community chats, and Ethereum wallet integration — all without requiring a phone number or email.


<p align="center">
  <img src="screenshots/mobile-anonymous-profiles.png" alt="mobile anonymous profiles" width="24%" />
  <img src="screenshots/mobile-messenger.png" alt="mobile messenger" width="24%" />
  <img src="screenshots/mobile-communities.png" alt="mobile communities" width="24%" />
  <img src="screenshots/mobile-wallet.png" alt="mobile wallet" width="24%" />
</p>
<p align="center">
  <img src="screenshots/mobile-swap.png" alt="mobile swap" width="24%" />
  <img src="screenshots/mobile-buy.png" alt="mobile buy" width="24%" />
  <img src="screenshots/mobile-nfts.png" alt="mobile nfts" width="24%" />
  <img src="screenshots/mobile-market.png" alt="mobile market" width="24%" />
</p>

![Status Desktop Screenshot](screenshots/desktop-community.png)


## 📑 Table of Contents

- [Status App](#status-app)
  - [📑 Table of Contents](#-table-of-contents)
  - [🚀 Download \& Install](#-download--install)
    - [Supported Versions](#supported-versions)
    - [Windows](#windows)
    - [Linux](#linux)
    - [macOS](#macos)
  - [🛠️ Build from Source](#️-build-from-source)
  - [🤝 Contributing](#-contributing)
  - [📚 Documentation](#-documentation)

## 🚀 Download & Install

Get the latest release for your platform:

- **Android**: [Play Store](https://play.google.com/store/apps/details?id=app.status.mobile)
- **Apple**: [App Store](https://apps.apple.com/us/app/status-privacy-super-app/id6754166924)
- **Windows**: [Download EXE](https://github.com/status-im/status-app/releases/latest)
- **Linux**: [Download Tarball](https://github.com/status-im/status-app/releases/latest)
- **macOS**: [Download DMG](https://github.com/status-im/status-app/releases/latest)

### Supported Versions

| Platform | Supported versions | Notes |
| --- | --- | --- |
| **Windows** | Intel chip (no native Windows ARM build yet) | Windows 11 is used for testing |
| **Linux** | Continuous effort to support the lowest Ubuntu LTS version. | Actively tested on Ubuntu 22.04; should run on most Linux flavours using glibc 2.31 or newer |
| **macOS** | ARM chip | MacOS latest version |
| **Android** | 9 to 16 |  |
| **iOS** | 17 and higher |  |

### Windows

1. [Download](https://github.com/status-im/status-app/releases/latest) the `.exe` file.
2. Run the `.exe` installer.
3. Launch the installed app 🎉

### Linux

1. [Download](https://github.com/status-im/status-app/releases/latest) the `.tar.gz` file.
2. Extract the tarball file (replace `*` with the version)
    ```shell
    cd ~/Downloads
    tar xvf StatusIm-Desktop-*.tar.gz
    ```
3. Optionally, [verify the Status app GPG signature](https://status.app/help/getting-started/download-status-for-linux#verify-the-status-app-gpg-signature).
4. Go to the directory where it extracted and double-click the AppImage file 🎉

### macOS

1. [Download](https://github.com/status-im/status-app/releases/latest) the `.dmg` file.
2. Open it and drag `Status.app` to the Applications folder.
3. Open the Applications folder and double-click the Status icon 🎉


## 🛠️ Build from Source

To build Status from source, follow the instructions specific to your operating system. Detailed build instructions are available in the official documentation:

- [Building Desktop](BUILDING.md)
- [Building Mobile](/mobile/README.md)

## 🤝 Contributing

We welcome contributions from the community! To get started:

<!-- TODO Improve the contributing guide to be more about how to contribute -->
<!-- TODO add guide on how to translate -->
<!-- TODO Create a guide per persona in the contributing guide -->

- Read our [Contributing Guidelines](CONTRIBUTING.md).
  - [Developing Status](CONTRIBUTING.md#️-developing)
  - [Testing Status](CONTRIBUTING.md#-desktop-status-app-community-testing)
- Check out [good first issues](https://github.com/status-im/status-app/contribute) to get involved.
- Join the [#feedback-desktop](https://status.app/cc/G-EAAORobqgnsUPSVCLaSJr855iXTIdQiY1Q0ckBe8dWWEBpUAs9s8DTjWEpvsmpE83Izx1JWQuZrWWKUoxiXCwdtB-wPBzyvv_n9a0F61xTaPZE7BEJDC7Ly_WcmQ4tHRAKnPfXE_JUtEX_3NhnXQN0eh4ue0D77dWvaDpDrSi0U0CaGLZ-pqD_iV0z9RMFE2LKulDZdwL40etJ8lxjyTFoxS0lUhdWKinIOk8qBmJJpCmsqMrSklEU#zQ3shZeEJqTC1xhGUjxuS4rtHSrhJ8vUYp64v6qWkLpvdy9L9) and [#feedback-mobile](https://status.app/cc/G-EAAOTgmsumqFvQZ-DSRkmf6xZuG-jQBrqnB6ytivISS1qeYURpfrzeMMePtpp7Inw_qy_cLdpZLJNUgOmfMHIZ4n2zSTr-n9u34C4yZa7c4JGLz9U6GIfjPqa0J0Ng2GC_Pu76QxgM-1v0z8V0PxxAf3fdHNbQXy-vfqWhK2iF0E6AaaJMh3sCmp_YpfFwR0DPmDIORPwdI_5ot4VZpkSb9FCkBwJO0xKNc5zI4oYpjfAhZVAyNWIHJs0D#zQ3shZeEJqTC1xhGUjxuS4rtHSrhJ8vUYp64v6qWkLpvdy9L9) channels on Status.


## 📚 Documentation

- [📘 User Help documentation](https://status.app/help)
- [🛠️ Installation Guide](https://status.app/help/getting-started#for-new-users)
- [🏗️ Building Desktop from Source](BUILDING.md)
- [📱 Building Mobile from Source](/mobile/README.md)
- [🏛️ Architecture Docs](docs/architecture.md)
- [🤝 Contributing Guide](CONTRIBUTING.md)
- [💡 You have an idea for a cool feature or improvement?](https://discuss.status.app/c/features/51)
- [🗺️ Status Roadmap](/docs/roadmap)
  - [🌟 Feature FURPS](/docs/FURPS)


&nbsp;

---

For more information, visit our [official website](https://status.app/) or explore our [GitHub organization](https://github.com/status-im).

This project is tested with BrowserStack.