Impressum

Sun, 24 Apr 2022 08:01:00 +0100

In this new series, I want to shine some light onto specific parts of Monal’s internals. It’s dedicated to programmers or people curious about how Monal works internally. If you want to give some feedback, feel free to send an email to thilo@monal-im.org

Other articles in this series:

Monal Internals - Handlers framework

High priority pushes in combination with the com.apple.developer.usernotifications.filtering entitlement are not only used by Monal, but some other popular messaging apps, too (links to the source):

WhatsApp
WhatsApp
Signal
Threema
Telegram (binary)

Support

Sat, 12 Mar 2022 10:01:54 +0100

Monal Support Channel (XMPP MUC): monal@chat.yax.im

Github Tickets: https://github.com/monal-im/Monal/issues

Email: info[at]monal[minus]im[dot]org.

@@ -3209,9 +3209,9 @@ This improves the quality of the app significantly.

Alpha -upon request to info@monal-im.org
Then download from our alpha download site

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im +upon request to info@monal-im.org
Then download from our alpha download site

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im -brew tap monal-im/homebrew-monal-alpha
brew install --cask monal-alpha

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im +brew tap monal-im/homebrew-monal-alpha
brew install --cask monal-alpha

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im @@ -3260,9 +3260,9 @@ This improves the quality of the app significantly.

Alpha - upon request to info@monal-im.org
Then download from our alpha download site

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im + upon request to info@monal-im.org
Then download from our alpha download site

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im - brew tap monal-im/homebrew-monal-alpha
brew install --cask monal-alpha

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im + brew tap monal-im/homebrew-monal-alpha
brew install --cask monal-alpha

You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im diff --git a/site/install/index.html b/site/install/index.html index ffbf30a..5ba5395 100644 --- a/site/install/index.html +++ b/site/install/index.html @@ -101,7 +101,7 @@ User-interface overhaul Implemented XEPs -You can check the complete list of supported XEPs at https://xmpp.org/software/monal-im/">

Install

12.03.2022 · 4 min · Monal RSS | Suggest Changes

	iOS	macOS	macOS (homebrew)
Stable	App Store	App Store	brew install --cask monal
Beta	Testflight Invitation	Testflight Invitation	brew install --cask monal@beta
Alpha	upon request to info@monal-im.org Then download from our alpha download site You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im		brew tap monal-im/homebrew-monal-alpha brew install --cask monal-alpha You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im

Features

Monal currently covers the following chat features:

Decentralised and federated chat standard XMPP
Private and group messaging
Privacy-respecting push notifications
Encrypted private and group chats (state-of-the-art encryption (OMEMO)
Message history
Free selection of your XMPP account provider
Voice messaging
Message archiving
Upload of files, videos and images (HTTP Upload)
Audio and Video calls
Many settings and a design to offer privacy settings in the app to the need of the user
A detailed and technical listing of your supported features (so called XMPP Extensions) can be found in our DOAP file.

Planned features

User-interface overhaul

Implemented XEPs

You can check the complete list of supported XEPs at https://xmpp.org/software/monal-im/

XEP	Status	Since
XEP-0004: Data Forms	complete	4.9
XEP-0030: Service Discovery	complete	4.6
XEP-0045: Multi-User Chat	partial	5.0
XEP-0048: Bookmarks	complete	5.0
XEP-0054: vcard-temp Implemented only for MUC profiles	complete	5.0
XEP-0059: Result Set Management	complete	4.8
XEP-0060: Publish-Subscribe Used mainly for Pep	partial	4.9
XEP-0066: Out of Band Data Used to mark XEP-0363 filetransfers only	partial	4.9
XEP-0077: In-Band Registration	partial	4.7
XEP-0084: User Avatar	complete	4.9
XEP-0085: Chat State Notifications Only typing notifications, use XEP-0319 to publish interactions	partial	4.7
XEP-0092: Software Version	complete	5.0
XEP-0115: Entity Capabilities	complete	4.7
XEP-0153: vCard-Based Avatars XEP-0153: vCard-Based Avatars (implemented only for MUC profiles)	partial	5.0
XEP-0162: Best Practices for Roster and Subscription Management	partial	5.4
XEP-0163: Personal Eventing Protocol	complete	4.9
XEP-0167: Jingle RTP Sessions	complete	6.0
XEP-0176: Jingle ICE-UDP Transport Method	complete	6.0
XEP-0172: User Nickname	complete	4.9
XEP-0184: Message Delivery Receipts	complete	4.7
XEP-0191: Blocking Command	complete	5.0
XEP-0198: Stream Management	complete	4.6
XEP-0199: XMPP Ping	complete	4.7
XEP-0215: External Service Discovery	complete	6.0
XEP-0223: Persistent Storage of Private Data via PubSub XEP-0223: Persistent Storage of Private Data via PubSub	complete	4.9
XEP-0237: Roster Versioning	complete	4.6
XEP-0245: The /me Command	complete	4.9
XEP-0249: Direct MUC Invitations XEP-0249: Direct MUC Invitations	complete	5.0
XEP-0280: Message Carbons	complete	4.5
XEP-0286: Mobile Considerations on LTE Networks	complete	4.7
XEP-0293: Jingle RTP Feedback Negotiation	complete	6.0
XEP-0294: Jingle RTP Header Extensions Negotiation	complete	6.0
XEP-0305: XMPP Quickstart	complete	5.1.1
XEP-0308: Last Message Correction	complete	4.8
XEP-0313: Message Archive Management	complete	4.8
XEP-0319: Last User Interaction in Presence	complete	4.7
XEP-0320: Use of DTLS-SRTP in Jingle Sessions	complete	6.0
XEP-0333: Displayed Markers	complete	4.8
XEP-0338: Jingle Grouping Framework	complete	6.0
XEP-0339: Source-Specific Media Attributes in Jingle	complete	6.0
XEP-0352: Client State Indication	complete	4.7
XEP-0353: Jingle Message Initiation	complete	6.0
XEP-0357: Push Notifications	complete	4.8
XEP-0359: Unique and Stable Stanza IDs	complete	4.8
XEP-0363: HTTP File Upload	complete	4.9
XEP-0368: SRV records for XMPP over TLS	complete	4.6
XEP-0379: Pre-Authenticated Roster Subscription No automatic approval if server does not support subscription pre-approval; No checking of tokens, if server does not do so (XEP-0401)	partial	4.9
XEP-0380: Explicit Message Encryption	complete	5.1
XEP-0384: OMEMO Encryption	complete	4.8
XEP-0388: Extensible SASL Profile	complete	6.0
XEP-0392: Consistent Color Generation	complete	5.1
XEP-0398: User Avatar to vCard-Based Avatars Conversion Used for MUC avatars	complete	6.0
XEP-0401: Ad-hoc Account Invitation Generation	complete	6.0
XEP-0402: PEP Native Bookmarks	complete	5.4
XEP-0410: MUC Self-Ping (Schrödinger's Chat)	complete	5.0
XEP-0423: XMPP Compliance Suites 2020 Check this XEP to see what's missing	partial
XEP-0424: Message Retraction	complete	6.3
XEP-0425: Moderated Message Retraction	complete	6.3
XEP-0440: SASL Channel-Binding Type Capability	complete	6.0
XEP-0441: Message Archive Management Preferences Only to automatically turn on archiving if possible (setting: always)	complete	4.8
XEP-0445: Pre-Authenticated In-Band Registration	complete	5.2
XEP-0454: OMEMO Media sharing No support for embedded thumbnails	partial	5.0
XEP-0474: SASL SCRAM Downgrade Protection	complete	6.0
XEP-0480: SASL Upgrade Tasks	complete	6.0
XEP-0486: MUC Avatars	complete	5.0
XEP-0490: Message Displayed Synchronization	complete	6.3

Planned XEPs

XEP	Status
XEP-0158: CAPTCHA Forms	planned
XEP-0374: OpenPGP for XMPP Instant Messaging	planned
XEP-0386: Bind 2 XEP-0386: Bind 2.0	planned
XEP-0420: Stanza Content Encryption	planned
XEP-0158: CAPTCHA Forms	planned

Install

12.03.2022 · 4 min · Monal RSS | Suggest Changes

	iOS	macOS	macOS (homebrew)
Stable	App Store	App Store	brew install --cask monal
Beta	Testflight Invitation	Testflight Invitation	brew install --cask monal@beta
Alpha	upon request to info@monal-im.org Then download from our alpha download site You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im		brew tap monal-im/homebrew-monal-alpha brew install --cask monal-alpha You can get updates about alpha releases by joining this channel: monal-alpha@chat.yax.im

Features

Monal currently covers the following chat features:

Decentralised and federated chat standard XMPP
Private and group messaging
Privacy-respecting push notifications
Encrypted private and group chats (state-of-the-art encryption (OMEMO)
Message history
Free selection of your XMPP account provider
Voice messaging
Message archiving
Upload of files, videos and images (HTTP Upload)
Audio and Video calls
Many settings and a design to offer privacy settings in the app to the need of the user
A detailed and technical listing of your supported features (so called XMPP Extensions) can be found in our DOAP file.

Planned features

User-interface overhaul

Implemented XEPs

You can check the complete list of supported XEPs at https://xmpp.org/software/monal-im/

XEP	Status	Since
XEP-0004: Data Forms	complete	4.9
XEP-0030: Service Discovery	complete	4.6
XEP-0045: Multi-User Chat	partial	5.0
XEP-0048: Bookmarks	complete	5.0
XEP-0054: vcard-temp Implemented only for MUC profiles	complete	5.0
XEP-0059: Result Set Management	complete	4.8
XEP-0060: Publish-Subscribe Used mainly for Pep	partial	4.9
XEP-0066: Out of Band Data Used to mark XEP-0363 filetransfers only	partial	4.9
XEP-0077: In-Band Registration	partial	4.7
XEP-0084: User Avatar	complete	4.9
XEP-0085: Chat State Notifications Only typing notifications, use XEP-0319 to publish interactions	partial	4.7
XEP-0092: Software Version	complete	5.0
XEP-0115: Entity Capabilities	complete	4.7
XEP-0153: vCard-Based Avatars XEP-0153: vCard-Based Avatars (implemented only for MUC profiles)	partial	5.0
XEP-0162: Best Practices for Roster and Subscription Management	partial	5.4
XEP-0163: Personal Eventing Protocol	complete	4.9
XEP-0167: Jingle RTP Sessions	complete	6.0
XEP-0176: Jingle ICE-UDP Transport Method	complete	6.0
XEP-0172: User Nickname	complete	4.9
XEP-0184: Message Delivery Receipts	complete	4.7
XEP-0191: Blocking Command	complete	5.0
XEP-0198: Stream Management	complete	4.6
XEP-0199: XMPP Ping	complete	4.7
XEP-0215: External Service Discovery	complete	6.0
XEP-0223: Persistent Storage of Private Data via PubSub XEP-0223: Persistent Storage of Private Data via PubSub	complete	4.9
XEP-0237: Roster Versioning	complete	4.6
XEP-0245: The /me Command	complete	4.9
XEP-0249: Direct MUC Invitations XEP-0249: Direct MUC Invitations	complete	5.0
XEP-0280: Message Carbons	complete	4.5
XEP-0286: Mobile Considerations on LTE Networks	complete	4.7
XEP-0293: Jingle RTP Feedback Negotiation	complete	6.0
XEP-0294: Jingle RTP Header Extensions Negotiation	complete	6.0
XEP-0305: XMPP Quickstart	complete	5.1.1
XEP-0308: Last Message Correction	complete	4.8
XEP-0313: Message Archive Management	complete	4.8
XEP-0319: Last User Interaction in Presence	complete	4.7
XEP-0320: Use of DTLS-SRTP in Jingle Sessions	complete	6.0
XEP-0333: Displayed Markers	complete	4.8
XEP-0338: Jingle Grouping Framework	complete	6.0
XEP-0339: Source-Specific Media Attributes in Jingle	complete	6.0
XEP-0352: Client State Indication	complete	4.7
XEP-0353: Jingle Message Initiation	complete	6.0
XEP-0357: Push Notifications	complete	4.8
XEP-0359: Unique and Stable Stanza IDs	complete	4.8
XEP-0363: HTTP File Upload	complete	4.9
XEP-0368: SRV records for XMPP over TLS	complete	4.6
XEP-0379: Pre-Authenticated Roster Subscription No automatic approval if server does not support subscription pre-approval; No checking of tokens, if server does not do so (XEP-0401)	partial	4.9
XEP-0380: Explicit Message Encryption	complete	5.1
XEP-0384: OMEMO Encryption	complete	4.8
XEP-0388: Extensible SASL Profile	complete	6.0
XEP-0392: Consistent Color Generation	complete	5.1
XEP-0398: User Avatar to vCard-Based Avatars Conversion Used for MUC avatars	complete	6.0
XEP-0401: Ad-hoc Account Invitation Generation	complete	6.0
XEP-0402: PEP Native Bookmarks	complete	5.4
XEP-0410: MUC Self-Ping (Schrödinger's Chat)	complete	5.0
XEP-0423: XMPP Compliance Suites 2020 Check this XEP to see what's missing	partial
XEP-0424: Message Retraction	complete	6.3
XEP-0425: Moderated Message Retraction	complete	6.3
XEP-0440: SASL Channel-Binding Type Capability	complete	6.0
XEP-0441: Message Archive Management Preferences Only to automatically turn on archiving if possible (setting: always)	complete	4.8
XEP-0445: Pre-Authenticated In-Band Registration	complete	5.2
XEP-0454: OMEMO Media sharing No support for embedded thumbnails	partial	5.0
XEP-0474: SASL SCRAM Downgrade Protection	complete	6.0
XEP-0480: SASL Upgrade Tasks	complete	6.0
XEP-0486: MUC Avatars	complete	5.0
XEP-0490: Message Displayed Synchronization	complete	6.3

Planned XEPs

XEP	Status
XEP-0158: CAPTCHA Forms	planned
XEP-0374: OpenPGP for XMPP Instant Messaging	planned
XEP-0386: Bind 2 XEP-0386: Bind 2.0	planned
XEP-0420: Stanza Content Encryption	planned
XEP-0158: CAPTCHA Forms	planned

diff --git a/site/multi-auto_4983799081706151337.svg b/site/multi-auto_4983799081706151337.svg index e995536..d443f54 100644 --- a/site/multi-auto_4983799081706151337.svg +++ b/site/multi-auto_4983799081706151337.svg @@ -1,4 +1,4 @@ - @@ -36,13 +36,13 @@ Basque 99% @@ -59,13 +59,13 @@ Chinese (Simplified Han script) 100% @@ -82,13 +82,13 @@ Chinese (Traditional Han script) 100% @@ -105,13 +105,13 @@ Chinese (Traditional Han script, Hong Kong) 7% @@ -128,13 +128,13 @@ Czech 32% @@ -151,13 +151,13 @@ Danish 1% @@ -174,13 +174,13 @@ Dutch 42% @@ -197,13 +197,13 @@ English 100% @@ -220,21 +220,21 @@ Finnish 1% + id="percent155">3% @@ -243,13 +243,13 @@ French 80% @@ -266,13 +266,13 @@ German 100% @@ -289,13 +289,13 @@ Greek 15% @@ -312,13 +312,13 @@ Hebrew 1% @@ -335,13 +335,13 @@ Hindi 1% @@ -358,13 +358,13 @@ Indonesian 14% @@ -381,13 +381,13 @@ Italian 100% @@ -404,13 +404,13 @@ Japanese 86% @@ -427,13 +427,13 @@ Korean 6% @@ -450,13 +450,13 @@ Nepali 1% @@ -473,13 +473,13 @@ Norwegian Bokmål 20% @@ -496,13 +496,13 @@ Persian 1% @@ -519,13 +519,13 @@ Polish 54% @@ -542,13 +542,13 @@ Portuguese (Brazil) 2% @@ -565,13 +565,13 @@ Portuguese (Portugal) 6% @@ -588,13 +588,13 @@ Punjabi 2% @@ -611,13 +611,13 @@ Romanian 33% @@ -634,13 +634,13 @@ Russian 75% @@ -657,13 +657,13 @@ Spanish 100% @@ -680,13 +680,13 @@ Spanish (Argentina) 100% @@ -703,13 +703,13 @@ Spanish (Latin America) 100% @@ -726,13 +726,13 @@ Swedish 5% @@ -749,13 +749,13 @@ Tamil 9% @@ -772,13 +772,13 @@ Turkish 100% @@ -795,13 +795,13 @@ Ukrainian 54% @@ -818,13 +818,13 @@ Vietnamese 1% diff --git a/site/post/00005-push-on-ios/index.html b/site/post/00005-push-on-ios/index.html index 1a7aee4..ecc3e0a 100644 --- a/site/post/00005-push-on-ios/index.html +++ b/site/post/00005-push-on-ios/index.html @@ -8,7 +8,7 @@ I also talked about that topic in my talk “Modern XMPP - A story based on Monal” linked on the About page over here. For convenience I’d like to summarize some parts of that wiki entry in this blog-post, too. UPDATE: This post describes the way Monal implements push as well as the pitfalls of implementing it in another way. I tried to make this clearer in the text now.">

Push on iOS

04.02.2023 · 5 min · Thilo Molitor RSS | Suggest Changes

I recently wrote a summary about push on iOS in the xmpp.org wiki.
See over here for all the technical details and links to the documentation. -I also talked about that topic in my talk “Modern XMPP - A story based on Monal” linked on the About page over here.
For convenience I’d like to summarize some parts of that wiki entry in this blog-post, too.

UPDATE: This post describes the way Monal implements push as well as the pitfalls of implementing it in another way. I tried to make this clearer in the text now.

Background knowledge: Push on iOS

On iOS there are several push modes having different properties. All modes, except VoiIP pushes, have in common, that they only provide 30 seconds of background time.

VoIP pushes: MUST always make the device ring via Apple’s CallKit framework. You can’t use these pushes to silently retrieve messages or other XMPP stanzas in the background.
Low priority pushes: These pushes don’t show any user-visible notification, but they can be dropped or arbitrarily delayed by Apple. They grant 30 seconds of background time.
High priority pushes: These MUST show a user-visible notification. They grant 30 seconds of background time.
- But: Since iOS 13.3, apps having the com.apple.developer.usernotifications.filtering entitlement are allowed to suppress the user-visible notification. To cite Apple:
  This entitlement is intended for certain types of apps — such as messaging apps or location sharing apps — that use notification service extensions to receive push notifications without delivering notifications to the user.

Monal

Monal is using this entitlement to wake up background processing without sending any message data through Apple’s servers (not even ecrypted data). +I also talked about that topic in my talk “Modern XMPP - A story based on Monal” linked on the About page over here.
For convenience I’d like to summarize some parts of that wiki entry in this blog-post, too.

UPDATE: This post describes the way Monal implements push as well as the pitfalls of implementing it in another way. I tried to make this clearer in the text now.

Background knowledge: Push on iOS

On iOS there are several push modes having different properties. All modes, except VoiIP pushes, have in common, that they only provide 30 seconds of background time.

VoIP pushes: MUST always make the device ring via Apple’s CallKit framework. You can’t use these pushes to silently retrieve messages or other XMPP stanzas in the background.
Low priority pushes: These pushes don’t show any user-visible notification, but they can be dropped or arbitrarily delayed by Apple. They grant 30 seconds of background time.
High priority pushes: These MUST show a user-visible notification. They grant 30 seconds of background time.
- But: Since iOS 13.3, apps having the com.apple.developer.usernotifications.filtering entitlement are allowed to suppress the user-visible notification. To cite Apple:
  This entitlement is intended for certain types of apps — such as messaging apps or location sharing apps — that use notification service extensions to receive push notifications without delivering notifications to the user.

Monal

Monal is using this entitlement to wake up background processing without sending any message data through Apple’s servers (not even ecrypted data). When iOS grants the app it’s 30 seconds background time because of the incoming push, Monal then connects to the XMPP server over the network to retrieve the actual message and display a notification to the user, if needed.

Signal does exactly the same: It uses push only to wake up the app and then fetches the messages using a dedicated network connection: Example in Signal’s code

This way Monal avoids all of the pitfalls depicted below!

Diving deeper: Some more details about iOS push and XMPP

The following explanations and thoughts are a bit more technical and require some understanding of the XMPP protocol and it’s inner workings.

Push server implementations and iOS time limits

Pushes of all types (see above) can only wake up the iOS app for 30 seconds. But in most cases that’s more than enough to connect to the xmpp server and retrieve pending stanzas (if using the entitlement mentioned above and XEP-0198, it is even possible to get pushes for iq stanzas etc., thus behaving like being permanently connected while still sleeping most of the time because of CSI). Even if the 30 seconds don’t suffice, the client can disconnect and both, Prosody and eJabberd, will send another push if there are still unacked stanzas in the XEP-0198 queue. This will give the app another 30 seconds. Even longer catchups lasting for > 5 minutes can be done completely in the background this way (observed in the wild with Monal stable).

This means that even with the 30 second time limit in place, it usually is possible to do a longer lasting catchup completely in the background, effectively extending the time limit to several minutes. diff --git a/site/post/index.xml b/site/post/index.xml index 879ed87..b9a1041 100644 --- a/site/post/index.xml +++ b/site/post/index.xml @@ -1,4 +1,4 @@ -Posts on Monalhttps://monal-im.github.io/monal-im.org/site/post/Recent content in Posts on Monal

Funding

Tue, 18 Jun 2024 00:00:00 +0000

Categories on Monal

Impressum

Support

Features#

Planned features#

Implemented XEPs#

Planned XEPs#

Background knowledge: Push on iOS#

Monal#

Background knowledge: Push on iOS#

Monal#

Diving deeper: Some more details about iOS push and XMPP#

Push server implementations and iOS time limits#

Funding

Features

Planned features

Implemented XEPs

Planned XEPs

Background knowledge: Push on iOS

Monal

Background knowledge: Push on iOS

Monal

Diving deeper: Some more details about iOS push and XMPP

Push server implementations and iOS time limits