From a232c7f43032b0966d217b74137b1b918e38ce28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20P=C3=A9rez?= <rodripf@gmail.com>
Date: Wed, 26 Jun 2019 01:16:02 -0300
Subject: [PATCH] vlc-telnet component documentation added (#9558)

* vlc-telnet component documentation added

* Updated the documentation to the last changes on the PR

* Update source/_components/vlc-telnet.markdown

Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com>

* Update source/_components/vlc-telnet.markdown

Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com>

* Update source/_components/vlc-telnet.markdown

Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com>

* Update source/_components/vlc-telnet.markdown

Co-Authored-By: Klaas Schoute <klaas_schoute@hotmail.com>

* Accepted suggestions by @klaasnicolaas

* Configuration example and firewall recomendation
---
 source/_components/vlc-telnet.markdown | 71 ++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 source/_components/vlc-telnet.markdown

diff --git a/source/_components/vlc-telnet.markdown b/source/_components/vlc-telnet.markdown
new file mode 100644
index 00000000000..51f3ffd520f
--- /dev/null
+++ b/source/_components/vlc-telnet.markdown
@@ -0,0 +1,71 @@
+---
+layout: page
+title: "VLC Telnet"
+description: "Instructions on how to integrate VLC media player into Home Assistant using the telnet interface."
+date: 2019-06-02 23:58
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: videolan.png
+ha_category:
+  - Media Player
+ha_release: 0.95
+ha_iot_class: Local Polling
+---
+
+The `vlc-telnet` platform allows you to control a [VLC media player](http://www.videolan.org/vlc/index.html) using the built in telnet interface.
+
+To add a VLC media player to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: vlc-telnet
+    host: IP_ADDRESS
+    password: PASSWORD
+```
+
+{% configuration %}
+name:
+  default: VLC-TELNET
+  description: The name to use in the frontend.
+  required: false
+  type: string
+pasword:
+  description: The password to control the VLC through the telnet interface.
+  required: true
+  type: string
+host:
+  description: The hostname or IP address where the VLC Player is running.
+  required: true
+  type: string
+port:
+  default: 4212
+  description: The port number where the VLC Player is running.
+  required: false
+  type: integer
+{% endconfiguration %}
+
+Only the "music" media type is supported for now.
+
+This service will control any instance of VLC player on the network with the telnet interface activated. 
+To activate the telnet interface on your VLC Player please read the [official VLC documentation](https://wiki.videolan.org/Documentation:Modules/telnet/). Also remember to add a firewall rule allowing inbound connections for the port used in the device running VLC.
+
+## {% linkable_title Full configuration %}
+
+A full configuration for VLC could look like the one below:
+
+```yaml
+# Example configuration.yaml entry
+media_player:
+  - platform: vlc-telnet
+    name: Remote Player
+    host: 192.168.1.48
+    port: 4212
+    password: your-secure-password
+```
+
+##### {% linkable_title Additional configuration for Rasperry Pi %}
+
+You can run a VLC Media Player inside your Hassio installation using the [hassio-local-vlc add-on](https://github.com/rodripf/hassio-local-vlc). Using it you can play files on the local network, Internet or files and playlist locally saved to the /share folder of your Hassio installation.