element-hq/element-ios

Element iOS

Element Classic iOS is a previous-generation Matrix client provided by Element. It is based on MatrixSDK. This client is still supported and receives security updates but no new features or usability enhancements are made. It is recommended to use Element X that is the next-generation mobile app.

Beta testing

You can try last beta build by accessing our TestFlight Public Link. For questions and feedback about latest TestFlight build, please access the Element iOS Matrix room: #element-ios:matrix.org.

Build instructions

If you have already everything installed, opening the project workspace in Xcode should be as easy as:

$ xcodegen                  # Create the xcodeproj with all project source files
$ pod install               # Create the xcworkspace with all project dependencies
$ open Riot.xcworkspace     # Open Xcode

Else, you can visit our installation guide. This guide also offers more details and advanced usage like using MatrixSDK in its development version.

Contributing

If you want to contribute to Element iOS code or translations, go to the contribution guide.

Support

When you are experiencing an issue on Element iOS, please first search in GitHub issues and then in #element-ios:matrix.org. If after your research you still have a question, ask at #element-ios:matrix.org. Otherwise feel free to create a GitHub issue if you encounter a bug or a crash, by explaining clearly in detail what happened. You can also perform bug reporting (Rageshake) from the Element application by shaking your phone or going to the application settings. This is especially recommended when you encounter a crash.

Copyright & License

Copyright (c) 2014-2017 OpenMarket Ltd. Copyright (c) 2017 Vector Creations Ltd. Copyright (c) 2017-2025 New Vector Ltd. Copyright (c) 2025 Element Creations Ltd.

This software is dual licensed by New Vector Ltd (Element). It can be used either:

(1) for free under the terms of the GNU Affero General Public License (as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version); OR

(2) under the terms of a paid-for Element Commercial License agreement between you and Element (the terms of which may vary depending on what you and Element have agreed to).

Unless required by applicable law or agreed to in writing, software distributed under the Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.