From 8a173e8240e65166f46aa8d3ad0effb3ca96281c Mon Sep 17 00:00:00 2001
From: Chris Caron <lead2gold@gmail.com>
Date: Thu, 21 Mar 2019 21:26:52 -0400
Subject: [PATCH] Created Notify_xmpp (markdown)

---
 Notify_xmpp.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 Notify_xmpp.md

diff --git a/Notify_xmpp.md b/Notify_xmpp.md
new file mode 100644
index 0000000..0594464
--- /dev/null
+++ b/Notify_xmpp.md
@@ -0,0 +1,41 @@
+## XMPP Notifications
+* **Source**: https://xmpp.org/
+* **Icon Support**: No
+* **Message Format**: Text
+* **Message Limit**: 32768 Characters per message
+
+XMPP Support requires **sleekxmpp** to work:
+```bash
+pip install sleekxmpp
+```
+
+### Syntax
+Valid syntaxes are as follows:
+* **xmpp**://**{password}**@**{hostname}**:**{port}**
+* **xmpps**://**{userid}**:**{password}**@**{hostname}**
+* **xmpps**://**{password}**@**{hostname}**:**{port}**?**jid={jid}**
+* **xmpps**://**{password}**@**{hostname}**?**jid={jid}**
+* **xmpps**://**{password}**@**{hostname}**/{jid1}/{jid2}/{jidN}/...
+
+Secure connections should be referenced using **xmpps://** where as insecure connections should be referenced via **xmpp://**.
+
+### Parameter Breakdown
+| Variable    | Required | Description
+| ----------- | -------- | -----------
+| hostname    | Yes      | The server Emby is listening on.
+| port        | No       | The port the XMPP server is listening on By default the port is **5222** for **xmpp://** and **5223** for the secure **xmpps://** references.
+| userid      | Yes      | The account login used to build the JID with if one isn't specified.
+| password    | yes      | The password associated with the XMPP Server.
+| jid         | no       | The JID account to associate/authenticate with the XMPP Server. This is automatically detected/built from the {userid} and {hostname} if it isn't specified.
+| xep         | no       | The XEP specifications to include.  By default **xep_0030** (Service Discovery) and **xep_0199** (XMPP Ping) if nothing is specified.
+| to          | no       | The JID to notify
+
+#### Example
+Send a XMPP notification to our server listening on port 5223:
+```bash
+# Assuming the xmpp {hostname} is localhost
+# Assuming the jid is user@localhost
+#  - constructed using {hostname} and {userid}
+# Assuming the xmpp {password} is abc123
+apprise xmpp://user:abc123@localhost
+```