﻿<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<addon id="script.advanced.wol"
       name="Advanced Wake On Lan"
       version="1.2.16"
       provider-name="mandark, tmtisfree">
  <requires>
        <import addon="xbmc.python" version="3.00.0" />
  </requires>
  <extension point="xbmc.python.script"
             library="default.py" />
  <extension point="xbmc.service"
             library="autostart.py" />
  <extension point="xbmc.addon.metadata">
    <summary lang="en">Wake up a sleeping device (e.g. NAS, Server, etc.) using Wake-On-Lan</summary>
    <summary lang="fr">Réveil un appareil (par ex. NAS, serveur, etc.) avec Wake-On-Lan (WOL)</summary>
    <description lang="en">Sends a WOL magic packet to a remote device using its ethernet MAC address and displays a notification if and when the device is available.
------------------------
The Addon can be launched manually from the Programs-section of XBMC (and thus added to your favourites, etc.), and can also be configured in the addon-settings to autostart with XBMC, thus waking up your remote device when XBMC starts.
There is also a setting that will also send a wake-up signal, if XBMC comes out from standby/sleep/suspend.
------------------------
When autostarted with XBMC you can also set the addon to update the video- and/or music-libraries automatically after a successful wake-up.
You can also set up a delay for the library scans. This is needed, if the filesystem needs some further time to get ready after a successful wake-up.
------------------------
Additionally another command (e.g. activate a specific window) can be handed to the script as a parameter. It then launches that command either immediately or not until the remote device is available. Behaviour can be set by a second parameter:
  - False: launch immediately (default)
  - True: wait for remote device

As an example, you could add the following entry to your favourites.xml:
  &quot;RunScript(&amp;quot;script.advanced.wol&amp;quot;,ActivateWindow(MyVideoLibrary),True)&quot;
This would attempt to wake the remote device configured in the &quot;Advanced Wake On Lan&quot;-Settings, wait until it is awake, and only then launch the XBMC-Video-Library.

This feature is especially useful, if you want to launch your remote device, when entering a specific menu-item in XBMC.
------------------------
You can also pass the Host/IP and MAC-Address of the rmote device to the script as the third parameter, bypassing the config in the addon-settings. E.g.:
  &quot;RunScript(&amp;quot;script.advanced.wol&amp;quot;,,,my-server@50:E5:49:B5:61:34)&quot;

This is useful, if you have more then one remote device you want to wake independently.
------------------------
In the advanced settings you can also set the addon to continue sending WOL packets with a configurable delay.
This is useful, when the remote device or NAS is kept awake, as long as WOL-packets are received.
Normally the continuous WOL-packets will also continue after XBMC has returned from standby/sleep/suspend, but there is an option to turn this behaviour off.
------------------------
If for any reason the check of a successful wake-up via ping is not possible or fails on your system, please note the following:
  - XBMC must be run as Administrator on Windows / with root rights on Linux for ping-based host-up checks to work.
  - If this is not possible or it still fails, you can disable ping-based host-up checks in the advanced addon-settings.
    This allows you to set a fixed timespan, after which the addon just assumes, that the remote host is awake (to display success-notifies, launch other commands, etc.).
    </description>
    <description lang="fr">Envoie un paquet magique WOL à un serveur distant en utilisant son adresse MAC Ethernet et affiche une notification si et quand l'appareil est disponible.
------------------------
Cette extension peut être lancée manuellement depuis la section Programmes de Kodi (et donc depuis les favoris, etc.) mais peut être aussi configurée dans ses paramètres pour démarrer automatiquement avec Kodi : l'appareil distant sera alors réveillé au démarrage de Kodi.
Il existe aussi un paramètre qui envoie un signal de réveil si l'appareil est suspendu/en veillle/en veille profonde.
------------------------
Quand elle est lancée au démarrage de Kodi, il est aussi possible de mettre à jour automatiquement les bibliothèques vidéo et de musique après un réveil réussi.
Un délai peut être défini avant l'analyse des bibliothèques. Ceci est nécessaire si le système de fichiers a besoin de plus de temps pour être prêt après un réveil réussi.
------------------------
De plus une autre commande (par ex. activer une fenêtre spécifique) peut être ajoutée au script comme paramètre. Il charge alors cette commande soit immediatement soit juste après la disponibilité de l'appareil. Le comportement peut être défini par un second paramètre :
  - False : se lance immédiatement (prédéfini)
  - True : attend l'appareil distant

Par exemple, ajouter l'entrée suivante au fichier favourites.xml :
  &quot;RunScript(&amp;quot;script.advanced.wol&amp;quot;,ActivateWindow(MyVideoLibrary),True)&quot;
Cette entrée va essayer de réveiller l'appareil distant configuré dans les paramètres de &quot;Advanced Wake On Lan&quot;, attendre son réveil effectif et seulement alors lancer la bibliothèque vidéo de Kodi.

Cette fonctionnalité est utile si l'utilisateur veut réveiller un appareil en sélectionnant un menu spécifique de Kodi.
------------------------
Il est aussi possible de passer le nom d'hôte et les adresses IP/MAC de l'appareil distant au script en troisième paramètre pour contourner la configuration dans ses paramètres. Par ex. :
  &quot;RunScript(&amp;quot;script.advanced.wol&amp;quot;,,,my-server@50:E5:49:B5:61:34)&quot;

Ceci est utile s'il existe plus d'un appareil à réveiller.
------------------------
Dans les paramètres avancés il est aussi possible de définir si l'extension doit continuer à envoyer des paquets WOL avec un délai (configurable).
Ceci est utile pour garder réveillé l'appareil distant ou le NAS, tant qu'il reçoit des paquets WOL.
L'envoi continu de paquets WOL continuera aussi normalement après que Kodi soit revenu de veille, mais ceci peut être désactivé.
------------------------
Si pour quelque raison la vérification d'un réveil réussi n'est pas possible ou a échoué sur le système, merci de noter que :
  - Kodi doit être exécuté en mode Administrateur sur Windows / Root sur Linux pour que les vérifications de contact de l'hôte fonctionnent.
  - Si ce n'est pas possible ou que cela ne fonctionne pas, désactiver la vérification de contact de l'hôte par ping dans les paramètres avancés de l'extension.
    Ceci permet de fixer un délai après lequel l'extension supposera que l'appareil est réveillé (pour afficher la notification de réussite, lancer d'autres commandes, etc.).
    </description>
    <disclaimer lang="en">Uses XBMC-builtin-command &quot;WakeOnLan&quot; to send the wakeup-packet, and the GNU-licensed &quot;python-ping&quot;-script to determine the status of the server. Please see the file &quot;ping.py&quot; for infos on the latter one.</disclaimer>
    <disclaimer lang="fr">Utilise la commande interne de Kodi &quot;WakeOnLan&quot; pour envoyer les paquets de réveil, et le script &quot;python-ping&quot; sous license GNU pour déterminer l'état du serveur. Merci de lire le fichier &quot;ping.py&quot; pour plus d'infos sur ce dernier.</disclaimer>
    <platform>all</platform>
  </extension>
</addon>
