Mercury-IMs fork of Smack
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Paul Schaub 2077a5dc96 Fix NPE for recevied messages with missing public key 6 months ago
.github [ci] Re-enable coveralls 5 months ago
config [checkstyle] Bump to 8.27 1 year ago
documentation [doc] Initial IDE config guide 4 months ago
gradle/wrapper Add gradle wrapper to fix gradle build errors of composite build 1 month ago
resources Smack 4.4.3 4 months ago
smack-android [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-android-extensions [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-bosh [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-core [core] Fix spelling errors in code comment within PacketParserUtils 2 months ago
smack-debug SMACK-908: Don't use components to count tabs in Debugger 4 months ago
smack-debug-slf4j [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-experimental [mam] Support multiple versions of MAM 2 months ago
smack-extensions Merge branch '4.4' 2 months ago
smack-im Call XMPPConnection.sendIqRequestAndWaitForResponse(IQ) where possible 5 months ago
smack-integration-test [sinttest] Add "compatibility mode" setting 2 months ago
smack-java8 [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-java8-full [core] Introduce Builder.failOnUnknownStates() and unit tests 4 months ago
smack-jingle-old Do not call XmlPullParser.getName() when the event is unknown 4 months ago
smack-legacy Do not call XmlPullParser.getName() when the event is unknown 4 months ago
smack-omemo Do not call XmlPullParser.getName() when the event is unknown 4 months ago
smack-omemo-signal [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-omemo-signal-integration-test [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-openpgp Fix NPE for recevied messages with missing public key 1 month ago
smack-repl [repl] Bump Scala to 2.13.6 and Ammonite to 2.4.0 4 months ago
smack-resolver-dnsjava [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-resolver-javax [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-resolver-minidns [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-resolver-minidns-dox [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-sasl-javax [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-sasl-provided [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-streammanagement Make ExtensionElement marker interface wrt. QNAME field 6 months ago
smack-tcp [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-websocket [websocket] Fix getStreamFromOpenElement() 7 months ago
smack-websocket-java11 [websocket-java11] Add test 5 months ago
smack-websocket-okhttp Add smack-websocket-java11 8 months ago
smack-xmlparser [xmlparser] Add SmackXmlParser.newXmlParser(InputStream) 6 months ago
smack-xmlparser-stax [gradle] Do not use deprecated 'compile' directive 6 months ago
smack-xmlparser-xpp3 Introduce test fixtures 2 years ago
.gitignore Add local.properties to gitignore 2 years ago
.mailmap Add .mailmap 12 months ago
LICENSE Add Appendix to LICENSE 5 years ago
NOTICE Add NOTICE file 12 months ago
README.md [README] Update README.md 6 months ago
build.gradle Bump Bouncycastle to 1.69 2 months ago
gradlew Add gradle wrapper to fix gradle build errors of composite build 1 month ago
gradlew.bat Add gradle wrapper to fix gradle build errors of composite build 1 month ago
repl Bump Ammonite REPL to 1.3.2 3 years ago
settings.gradle Add smack-websocket-java11 8 months ago
version Smack 4.4.4-SNAPSHOT 4 months ago

README.md

Smack

Build Status Coverage Status Project Stats Link to XMPP chat smack@conference.igniterealtime.org

About

Smack is an open-source, highly modular, easy to use, XMPP client library written in Java for Java SE compatible JVMs and Android.

Being a pure Java library, it can be embedded into your applications to create anything from a full XMPP instant messaging client to simple XMPP integrations such as sending notification messages and presence-enabling devices. Smack and XMPP allow you to easily exchange data in various ways e.g., fire-and-forget, publish-subscribe, between human and non-human endpoints (M2M, IoT, …).

More information is provided by the Overview.

Getting started

Start with having a look at the Documentation and the Javadoc.

Instructions on how to use Smack in your Java or Android project are provided in the Smack Readme and Upgrade Guide.

License

Most of Smack is governed by the Apache License 2.0 (SPDX License Identifier: Apache 2.0). This license requires that the contents of a NOTICE text file are shown "…within a display generated by the Derivative Works, if and wherever such third-party notices normally appear.".

Smack comes which such a NOTICE file. Moreover, since smack-core is licensed under the Apache License 2.0, the conditions apply to every project using Smack. The content of Smack's NOTICE file can conveniently be retrieved using Smack.getNoticeStream().

Some subprojects of Smack are governed by other licenses. Please refer to the individual subprojects.

Professional Services

Smack is a collaborative effort of many people. Some are paid, e.g., by their employer or a third party, for their contributions. But many contribute in their spare time for free. While we try to provide the best possible XMPP library for Android and Java SE-compatible execution environments by following state-of-the-art software engineering practices, the API may not always perfectly fit your requirements. Hence welcome contributions and encourage discussion about how Smack can be further improved. We also provide paid services ranging from XMPP/Smack related consulting to designing and developing features to accommodate your needs. Please contact Florian Schmaus for further information.

Bug Reporting

Only a few users have access for filling bugs in the tracker. New users should:

  1. Read "How to ask for help or report an issue"
  2. Create a discourse account (you can also sign up with your Google account).
  3. Login to the forum account
  4. Press "New Topic" in your toolbar and choose the 'Smack Support' sub-category.

Please search for your issues in the bug tracker before reporting.

Donate

If you find Smack useful and feel like donating, then you can use one of the following systems:

  • Donate via Bitcoin: 1LiU78z3498wu3jwRPKbvovKAHjTcpVbuK

Contact

The developers hang around in smack@conference.igniterealtime.org. You may use this link to join the room via inverse.chat. Remember that it may take some time (~hours) to get a response.

You can also reach us via the Smack Support Forum if you have questions or need support, or the Smack Developers Forum if you want to discuss Smack development.

Contributing

If you want to start developing for Smack and eventually contribute code back, then please have a look at the Guidelines for Smack Developers and Contributors. The guidelines also contain development quickstart instructions.

Resources

Ignite Realtime

Ignite Realtime is an Open Source community composed of end-users and developers around the world who are interested in applying innovative, open-standards-based RealTime Collaboration to their businesses and organizations. We're aimed at disrupting proprietary, non-open standards-based systems and invite you to participate in what's already one of the biggest and most active Open Source communities.

Smack - an Ignite Realtime community project.