From 7c3e3da8d1d233b7ff79800a5b554fbe58aedb83 Mon Sep 17 00:00:00 2001
From: Spencer McIntyre <zeroSteiner@gmail.com>
Date: Mon, 22 Oct 2018 20:50:41 -0400
Subject: [PATCH] Add documentation for the play_youtube module

---
 .../modules/post/multi/manage/play_youtube.md | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 documentation/modules/post/multi/manage/play_youtube.md

diff --git a/documentation/modules/post/multi/manage/play_youtube.md b/documentation/modules/post/multi/manage/play_youtube.md
new file mode 100644
index 0000000000..16c5800a63
--- /dev/null
+++ b/documentation/modules/post/multi/manage/play_youtube.md
@@ -0,0 +1,26 @@
+`play_youtube` allows you to open and start playing a YouTube video on a
+compromised host.
+
+## Important Options
+
+**EMBED**
+
+Whether or not to use the `/embed` YouTube URL. The embeded version provides a
+clean interface and will start playing in fullscreen but is not compatible with
+all YouTube videos, for example Rick Astley - Never Gonna Give You Up (VID:
+[`dQw4w9WgXcQ`][1]) is not compatible.
+
+While the non-embeded version has greater compatibility, there is a chance that
+an advertisement may be played before the video. It is recommended to use the
+embeded version when the video is compatible.
+
+**VID**
+
+The video's identifier on YouTube. This is the `v` parameter of the URL.
+
+## See Also
+
+* Meterpreter's `uictl` command in the `stdapi` extension for enabling and
+  disabling the mouse and keyboard.
+
+[1]: https://www.youtube.com/watch?v=dQw4w9WgXcQ