powered by Jive Software

Chat markers support in smack (xep-0333)



I am working on a xmpp client application for android. the ios version will have support for chat markers through xmpp framework (xmpp framework implements xep-0333)

it would be great if the android version had the same feature.

I was wondering if there was any plan to support chat markers in smack. otherwise, any hint on how to implement it ?

thank you for your help.


Hi there,

At this moment Smack has support for this extension in experimental but I couldn’t finde snippet of code, examples or javadoc to understand how to use it, I tried reading the source code but I couldn’t understand how to use it.

I create a question about this in SO hoping find some help.
@Paul_Schaub do you know how to do it? or do know someone that can give me a hand with this?


The code is very basic, but should nevertheless be easy to use.

Basically you use the ChatMarkersManager to announce support to the server and contacts.

In order to signal that you for example displayed a message, you have to send another message which contains a DisplayedExtension with the ID of the displayed message.

In order to determine if a contact displayed a message, you have to keep listening for messages that contain a DisplayedExtension.

Other events like Acknowledgement of messages are done analogue.

As I said, that’s a little bit of manual work, but definitely doable. If you come up with an automated, more convenient solution, please feel free to contribute back to Smack :slight_smile:


Thank you for that @Paul_Schaub ,

It seems like I will contribute to Smack because what I found:
I tried what you said and it works only for sending ChatMarkersElements.MarkableExtension in a Message.
It only works with that cuz I didn’t wanna touch low layers of Smack and I tried with IncomingChatMessageListener and OutgoingChatMessageListener. What I found is that inside of ChatManager when a new stanza of type message arrives, it checks if it has body, if the message has no body, the stanza is ignored by ChatManager and never reach the newIncomingMessage() from IncomingChatMessageListener.

This is the code I’m talking about in ChatManager:

connection.addSyncStanzaListener(new StanzaListener() {
            public void processStanza(Stanza stanza) {
                final Message message = (Message) stanza;
                if (!shouldAcceptMessage(message)) {

                final Jid from = message.getFrom();
                final EntityFullJid fullFrom = from.asEntityFullJidOrThrow();
                final EntityBareJid bareFrom = fullFrom.asEntityBareJid();
                final Chat chat = chatWith(bareFrom);
                chat.lockedResource = fullFrom;

                asyncButOrdered.performAsyncButOrdered(chat, new Runnable() {
                    public void run() {
                        for (IncomingChatMessageListener listener : incomingListeners) {
                            listener.newIncomingMessage(bareFrom, message, chat);


And that is a problem in my case because xep-0333 says:

When the recipient sends a Chat Marker, it SHOULD ensure that the message stanza contains only the Chat Marker child element and optionally (when appropriate) a thread child element. Naturally, intermediate entities might add other extension elements to the message when routing or delivering the receipt message, e.g., a delay…

So, I’m thinking in add something very similar to ChatStateManager and its interface ChatStateListener.

What do you thing about this?


That sounds perfectly reasonable to me :slight_smile:


Ok, I developed what I said but I’m not sure if it meets what it needs to be part of the library :sweat_smile: and I have some questions. Should I create a PR or just post the code in stackoverflow question @Paul_Schaub.

This is the current code


I think it can’t hurt to open a PR :wink: The worst thing that might happen is, that the PR is not accepted, but my first impression (looked briefly over the code) is positive :slight_smile:


ok! I will do it today


hi @Paul_Schaub,
can you take a look https://github.com/igniterealtime/Smack/pull/256 and tell me what do you think? :slight_smile:


I really like it. There are some minor things I’d change, but all in all its nice :slight_smile:


I have updated the PR, can you take a look at it? @Paul_Schaub. Thx


I’m fine with your PR, but I don’t have the last word in this :smiley:. Better ask @Flow :slight_smile:.


Now that we have a merge, I think we can mark as resolved this post right?


I don’t know, the unit test coverage is basically not existent.

I also had to remove some flawed methods in https://github.com/igniterealtime/Smack/commit/0fa6fb946c3fda93ccec3bd01f810025306248b3. Smack should provide an easy to use high level API. What I had expected are convinience methods that are passed a Message, which would check if the message is markable, and if so, sends the displayed and acknowledged marker. Note that I deliberately omitted the received chat marker, as those could probably be send automatically by Smack.

I think this is far from finished.


Ok, I’m going to work on missing methods as you explain.