= The DLNA Media Controller plugin for Vera =
This plugin is a DLNA Control Point. It can control any DLNA Media Renderer, browse media on any DLNA Media Server and connect a Media Server to a compatible Media Renderer to render media

== Installation == #Installation
=== What you need === #Whatyouneed
 * Vera with UI5, UI6 or UI7 (UI6 was not tested)
 * At least one DLNA media server and one DLNA Media renderer
 * The UPnP event proxy plugin
 * The DLNA Media Controller plugin

=== How To (installation from the MiOS Marketplace) === #HowTo
It is the recommended method for installing the plugin.

 * Install the UPnP event proxy plugin from the MiOS Marketplace.

 * Install the DLNA Media Controller plugin from the MiOS Marketplace.

 * When installation is done (after the creation of a new device and a reload of the lua engine), refresh your Web browser cache (Ctrl+F5 in most of the browsers) before starting the setup step 

=== How To (manual installation) === #HowToManual
It is the installation method required if you don't have access to the MiOS marketplace.

 * Download the plugin files using the Zip Archive link at the bottom of this page: http://code.mios.com/trac/mios_dlna-cntroller/browser/tags/1.2

 * Upload the plugin files:
   * Unzip the ZIP archive
   * Use WinSCP ( http://winscp.net/eng/index.php ) to upload certain files:
     * DLNA.png go into ''/www/cmh/skins/default/icons/''
   * In '''APPS''' section, open '''Develop Apps''' >> '''Luup Files''' and upload the following files, check the '''Restart Luup after upload''' checkbox and click '''GO'''
     * D_DLNAMediaController1.json
     * D_DLNAMediaController1.xml
     * I_DLNAMediaController1.xml
     * J_DLNAMediaController1.js
     * L_DLNATTS.lua
     * L_DLNAUPnPUtility.lua
     * S_DLNAAVTransport1.xml
     * S_DLNAMediaController1.xml
     * S_DLNARenderingControl1.xml

=== Create a device === #CreateDevice
If you installed the plugin from the MiOS Marketplace, one device is automatically created. But if you have several media renderers and you want to drive more than one with the Vera, you have to add additional devices in the Vera, one for each media renderer you want to control.

 * Open '''APPS''' section; open '''Develop Apps''' >> '''Create Device'''.
   * In the '''!Upnp Device Filename''' input box enter ''D_DLNAMediaController1.xml''.
   * In the '''Description''' input box enter a name for the panel device.
   * In the '''Parent device''' list box select ''No parent''.
   * Click '''Create device'''.
 * Close the popup window that informs you about the creation of a new device, then push the '''Reload''' button.
 * When reload is done, refresh your Web browser cache (Ctrl+F5 in most of the browsers)

If you installed the plugin from the Marketplace and you are running UI7, an easier way to create an additional device is the following:

 * Open '''Apps''' menu; open '''My apps''' sub-menu.
 * Push the '''Details''' button in front of your DLNA Media Controller plugin.
 * Push the '''Create another''' button.
 * Wait for the automatic reload, then refresh your Web browser cache (Ctrl+F5 in most of the browsers)

=== Select your media renderer === #SelectMediaRenderer
This step will allow to link a Vera device to a physical media renderer.
Note it can be used too to assign the Vera device to a different media renderer.
Please note that you must avoid having several Vera devices linked to the same media renderer.

 * Find your new device in the UI,
 * Click on its wrench button,
 * Open the '''Settings''' tab,
 * Push the '''Discover''' button and wait for few seconds until the selection box is filled and the '''Select''' button is enabled again,
 * Select your media renderer in the selection box and then push the '''Select''' button,
 * If the automatic discovery is not working (the selection box remains empty), you can enter the URL of your renderer XML description file in the field '''New URL''' and then push the '''Select''' button,
 * Wait for few seconds for a complete initialiazation

Automatic discovery (UPnP discovery) could require an additional network setup of your Vera Lite, consisting in an update of the routing table of your Vera. Do it only if necessary. You can install and uninstall this patch using the plugin UI:

 * Find your new device in the UI,
 * Click on its wrench button,
 * Open the '''Settings''' tab,
 * Push the '''Install''' button to install the patch or '''Uninstall''' button to uninstall the patch.
 * Wait for the automatic reload.

For technical explanation of what is done by this patch, please read this message: http://forum.micasaverde.com/index.php/topic,16905.msg132502.html#msg132502