Go to file
Florian Schmaus 7fd300888e
Merge pull request #504 from JonathanLennox/StanzaBuilder-remove-extension
Add removeExtension methods to StanzaBuilder.
2021-10-25 16:58:49 +02:00
.github [README] Switch "build status" badge from Travis to Github Actions 2021-01-12 09:08:34 +01:00
config [checkstyle] Bump to 8.27 2020-05-23 23:36:58 +02:00
documentation Add support for XEP-0420: Stanza Content Encryption 2020-07-23 11:02:28 +02:00
resources Smack 4.4.3 2021-07-06 14:33:15 +02:00
smack-android gradle: use compileClasspath instead of compileOnly 2020-03-07 20:13:05 +01:00
smack-android-extensions gradle: add Android jar to smack-android-extensions compile classpath 2020-03-07 20:13:05 +01:00
smack-bosh Add missing stream namespace to xml declaration 2021-10-21 09:14:52 +02:00
smack-core Add removeExtension methods to StanzaBuilder. 2021-10-25 14:50:45 +00:00
smack-debug SMACK-908: Don't use components to count tabs in Debugger 2021-07-08 15:34:16 +02:00
smack-debug-slf4j [core] Deprecate AbstractConnectionListener 2020-05-13 22:14:43 +02:00
smack-experimental [carbons] Remove erroneous assert statement in connectionClosed() 2021-09-27 14:14:01 +02:00
smack-extensions Accept an empty string as the label value 2021-10-20 10:12:29 +01:00
smack-im Add more QNAME fields to extension element classes 2021-04-18 17:23:34 +02:00
smack-integration-test [sinttest] Add code comment and empty line 2021-03-18 21:32:37 +01:00
smack-java8 Rename smack-java7 to smack-java8 2020-09-23 17:50:11 +02:00
smack-java8-full Add Smack.getNoticeStream() and 'License' section to README 2020-11-09 08:46:57 +01:00
smack-jingle-old Do not call XmlPullParser.getName() when the event is unknown 2021-07-06 13:37:57 +02:00
smack-legacy [core] Pass down the XML environment in IQChildElementXmlStringBuilder 2021-10-19 11:29:23 +02:00
smack-omemo Do not call XmlPullParser.getName() when the event is unknown 2021-07-06 13:37:57 +02:00
smack-omemo-signal [checkstyle] Tighten JavadocMethod checkstyle rule 2020-05-23 22:43:29 +02:00
smack-omemo-signal-integration-test SmackReactor/NIO, Java8/Android19, Pretty print XML, FSM connections 2019-02-05 13:18:03 +01:00
smack-openpgp Do not call XmlPullParser.getName() when the event is unknown 2021-07-06 13:37:57 +02:00
smack-repl Add org.jivesoftware.smack.Smack with getVersion() and ensureInitialized() 2020-11-09 08:46:57 +01:00
smack-resolver-dnsjava resolver-dnsjava: bump to dnsjava 3.0 series 2020-04-12 22:21:30 +02:00
smack-resolver-javax Introduce Smack's Modular Connection Architecture 2020-04-04 13:03:31 +02:00
smack-resolver-minidns Introduce Smack's Modular Connection Architecture 2020-04-04 13:03:31 +02:00
smack-resolver-minidns-dox Introduce test fixtures 2020-04-11 22:05:36 +02:00
smack-sasl-javax [sasl] Avoid mechanisms that need a password when none is available 2021-03-25 15:01:15 +01:00
smack-sasl-provided [sasl] Avoid mechanisms that need a password when none is available 2021-03-25 15:01:15 +01:00
smack-streammanagement Create smack-streammanagement project and move o.j.smack.sm code there 2020-08-15 14:03:57 +02:00
smack-tcp [tcp] Add code comment why we need to set "running = false" here 2021-03-14 17:51:33 +01:00
smack-xmlparser Make Smack jars OSGi bundles 2021-10-17 15:57:48 +02:00
smack-xmlparser-stax Make Smack jars OSGi bundles 2021-10-17 15:57:48 +02:00
smack-xmlparser-xpp3 Make Smack jars OSGi bundles 2021-10-17 15:57:48 +02:00
.gitignore Add local.properties to gitignore 2019-06-30 16:00:31 +02:00
.mailmap Add .mailmap 2020-11-05 12:52:17 +01:00
LICENSE Add Appendix to LICENSE 2017-04-24 15:12:27 +02:00
NOTICE Add NOTICE file 2020-11-05 12:54:54 +01:00
README.md [README] Fix typo; s/NOICE/NOTICE/ 2021-03-25 15:00:07 +01:00
build.gradle [build] Remove OSS Sonatype Snapshot repository 2021-10-20 19:02:19 +02:00
repl Bump Ammonite REPL to 1.3.2 2018-10-27 15:41:17 +02:00
settings.gradle Rename smack-java7 to smack-java8 2020-09-23 17:50:11 +02:00
version Smack 4.4.4-SNAPSHOT 2021-07-06 14:51:00 +02:00

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.

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 allows 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 are 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 open source, professionally and spare-time, paid and unpaid, contributors. 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. We 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 in order 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 (freenode, IRC) and open_chat@conference.igniterealtime.org (XMPP MUC room). 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.