Table des matières
Au premier enregistrement de votre équipement, un tableau d’informations apparaît sur la droite de la page équipement.
Ce tableau est mis à jour à chaque enregistrement de l’équipement.
Les commandes de base (action)
Reboot/Eteindre
Ces deux commandes peuvent paraître inutiles, parce qu’au prochain démarrage, il faudra re-jailbreaker l’appareil.
Mais elles peuvent sauver en cas de gros blocage.
Prendre une photo (Activator)
Depuis la commande perso Camera :
Sélectionnez la méthode désirée.
Sur la page équipement, sélectionnez le ou les commandes action listées pour l’envoi de la photo. La liste dépend des commandes actives de votre Jeedom. Les plugins pris en compte actuellement sont Mail, Telegram, Slack.
- Méthode 0 : uniquement iOS < 10 (utilise le tweak camshot)
- Méthode 1 : ouvre libactivator.camera.invoke-shutter
- Méthode 2 : ouvre libactivator.shortcut:com.apple.camera:Prendre une photo
- Méthode 3 : ouvre uiopen « camera:// »
- Méthode 4 : ouvre com.apple.camera
Puis sauvegardez.
Ouvrez une page d’accueil personnalisée (Activator)
Peut être utilisé depuis un déclenchement programmé ou provoqué sur Jeedom.
Exemple : ouvrir le Dashboard de Jeedom à l’ouverture de la porte d’entrée, ouvrir une page design de Jeedom tous les jours de la semaine à l’heure de partir au travail…
- Sur l’appareil, ouvrir Safari et allez sur la page désirée (Dashboard/Design de Jeedom…),
cliquez sur le bouton partager, puis « Sur l’écran d’accueil », enfin « Ajouter », - Appuyez sur le bouton Safari du Dashboard (3 sur l’image ci-dessous)
Depuis plusieurs version d’Activator, les web-app ne sont plus accessibles.
Utilisez votre appareil comme caméra de surveillance (Activator/SimulateTouch)
Utilisez votre appareil comme caméra de surveillance.
Nécessite une Application de l’App Store (Periscope HD, IP Camera Lite, LiveReporter ou Karakuri Camera).
Nécessite un lecteur de flux RTSP ou Snapshot JPG (Plugin Camera, Synology, VLC…).
Attention, l’application doit rester ouverte pour que le flux soit envoyé.
- (Periscode HD) – Filme dès l’ouverture de l’application. (envoi un flux RTSP)
- (IP Camera Lite) – Une fois l’app ouverte, cliquez sur « Turn on IP Camera Server » pour filmer.
stouch touch 10 500
(envoi un flux RTSP) - (LiveReporter) – Filme dès l’ouverture de l’application. (envoi un flux RTSP)
- (Karakuri Camera) – Filme dès l’ouverture et présente une image jpg à l’adresse : http://@IP/preview.jpg à chaque GET http://@IP/preview.json. Fichier de configuration accessible dans le plugin Caméra.
- compatible avec le plugin Camera qui permet ces actions :
- activer la caméra frontale,
- activer la caméra dorsale,
- activer/désactiver l’affichage vidéo sur l’appareil (écran noir),
- activer/désactiver le son,
- régler les fps des snapshot,
- régler le niveau audio,
- régler la qualité d’encodage jpeg,
- régler l’intervalle de temps entre les images,
- et qui permet de récupérer ces informations :
- Date heure,
- dimension des jpeg,
- pourcentage de différences entre les jpeg,
- mémoire utilisée,
- batterie restante.
- compatible avec le plugin Camera qui permet ces actions :
Text To Speech (iOS 9/10/11/12/13)
Faites parler Thomas, Amélie ou n’importe quel voix en envoyant un message texte (sauf Siri).
Depuis le Dashboard ou un scénario, saisissez le texte que vous souhaitez faire lire à votre appareil (limite de 5 secondes de lecture).
Depuis Jeedom (scenario, script, autre plugin…), vous pouvez utiliser l’action message pour faire parler votre appareil.
Prise en compte des arguments comme ci-dessous (à mettre dans le champ) :
-r 0.53 -V 1 -p 1.1 -v Amélie "Bonjour. Je m'appelle Amélie."
-r 0.53 -V 2 -p 1.1 -v Thomas "Bonjour. Moi, c'est Thomas premium
-v Kyoko Yamete Kudasai Sensei
-v Kyoko "Yamete Kudasai Sensei"
-r 0.2 -V 3 -v Kyoko Yamete Kudasai Sensei
-r 0.2 -V 3 -v Kyoko "Yamete Kudasai Sensei"
-r 0.1 -V 0.4 -p 1 -v Kyoko Yamete Kudasai Sensei
-r 0.1 -V 0.4 -p 1 -v Kyoko "Yamete Kudasai Sensei"
La fonction est compatible avec le plugin Homeptalk pour le diffuser sur son enceinte Airplay.
Màj 12/2020 : Un menu déroulant affiche la liste des langues et voix disponibles sur votre appareil est présent sur le dashboard, et sur la page équipement.
La commande est envoyée via le compte mobile afin d’avoir tous les bons droits pour la librairie TextToSpeech d’Apple.
Plus d’info sur la commande : Say
SMS (9/10/11/12/13)
Envoyez un SMS depuis votre iPhone uniquement via Jeedom.
Prérequis : avoir un iPhone (iPad, AppleWatch non fonctionnels), avoir une carte SIM active sur l’iPhone.
Aucun historique n’apparaît sur l’iPhone.
Plus d’info sur la commande : SMSme
GPS (9/10/11/12/13)
Récupérez les coordonnées GPS de l’appareil grâce à l’outil gpsloc.
Autorisez la localisation pour l’App « Localiser mon iPhone » sur votre appareil.
Plus d’info sur la commande : GPSLoc
Notification et Bulletin (9/10/11/12/13) (à vérifier)
Envoyez une notification personnalisée ou un bulletin sur son appareil.
Sur Jeedom :
Notification sur l’appareil :
Bulletin sur l’appareil :
Plus d’info sur la commande : Publication
Plus d’info sur la commande : Bulletin
Liste des App
Cette commande affiche dans un menu déroulant la liste actuelle des applications installées sur l’appareil.
On peut alors la sélectionner puis enregistrer l’équipement, afin de pouvoir exécuter la commande de lancement de cette App.
Màj 12/2020 : cette commande a été supprimée pour une nouvelle gestion par modal.
Play
Cette commande permet de lire un fichier audio qui se trouve sur l’appareil dans le dossier /var/$user/jailed/songs/.
- Pour envoyer le fichier audio dans ce répertoire :
- Sous Linux ou Mac OS, saisissez la commande :
scp chemin_de_ton_fichier_audio root@ip_de_l_ipad:/var/root/jailed/songs/
- Sur l’appareil, installez une App serveur de fichier (iFile par exemple). Ouvrez la page web de l’appareil depuis le pc http://ip_de_l_ipad puis chercher l’emplacement /var/root/jailed/songs/ et envoyez-y les fichiers audio voulus.
- Sur Jeedom, dans le dossier /var/www/html/plugins/Jailbreak/ressources/audio/ placez les fichiers audio à envoyer, puis depuis le plugin Jailbreak, menu Installation, cliquez sur Envoyer les scripts (inutile de les « lancer », juste envoyer).
- Sous Linux ou Mac OS, saisissez la commande :
Comment utiliser cette commande :
- Sur le Dashboard, une liste déroulante apparaît, et affiche tous les fichiers contenus sur l’appareil dans /var/root/jailed/songs/.
En choisissant un titre de cette liste et en faisant Play, on démarre directement la lecture.
- Depuis l’onglet Commandes de base, il faut en revanche sauvegarder après avoir sélectionné le titre de la liste pour pouvoir démarrer la lecture. Il s’agit en fait du titre par défaut que l’on choisit.
- En passant par un scénario, la liste apparaît comme ceci :
Playurl
Même principe que la commande Play, mais permet de lire un fichier audio depuis une adresse http ou https.
Lecture en direct sans téléchargement préalable du fichier.
Fonctionne également depuis un répertoire de Jeedom :
- Sur Jeedom, dans le dossier /var/www/html/plugins/Jailbreak/ressources/audio/ placez les fichiers audio à envoyer, puis saisissez http://192.168.X.X/plugins/Jailbreak/ressources/audio/fichier.mp3 dans la commande de PlayURL.
Stop
Elle sert à arrêter la lecture des commandes Play et Playurl.
Peut être inefficace avec Playurl.
Rafraîchir
Tout simplement, rafraîchit les informations dès l’action.
Le cron par défaut exécute cette action toutes les 5 minutes.
Les commandes de base (info)
Màj 12/2020 : Il est désormais possible de gérer l’intervalle de rafraîchissement des commandes info, en sélectionnant dans le menu déroulant de la commande. Certains intervalles sont groupés, car ils utilisent une seule commande ssh pour se mettre à jour.
Ampérage chargeur
Intensité maximale fournie par le chargeur.
Valeur à 0 si aucun chargeur n’est branché.
Exprimé en Ampère.
Capacité actuelle
Capacité actuelle de la batterie.
Exprimé en mAh.
Capacité initiale
Capacité initiale de la batterie, à l’achat.
Exprimé en mAh.
Capacité maximale
Capacité maximale de la batterie qu’elle peut encore restituer.
Exprimé en mAh.
Batterie
Pourcentage de batterie restant.
Exprimé en %.
Capacité batterie (en pourc.)
Pourcentage réel de batterie restant.
Valeur = (Capacité actuelle / Capacité maximale).
Exprimé en %.
Santé batterie (en pourc.)
Pourcentage de l’état de santé de la batterie.
Valeur = (Capacité maximale / Capacité d’origine).
Exprimé en %.
Temps estimé avant charge/décharge complète
Il s’agit du temps restant avant recharge ou décharge complète.
Valeur comprise entre 0h00min et ∞.
Consommation instantanée
Intensité consommée/restituée par l’appareil
La valeur peut-être positive ou négative.
Exprimé en mA.
Puissance chargeur
Puissance maximale fournie par le chargeur.
Valeur à 0 si aucun chargeur n’est branché.
Exprimé en Watt.
Liste des voix
Liste l’ensemble des voix disponibles pour la commande TTS.
Toutes les langues sont disponibles, mais il faut au préalable les télécharger depuis l’appareil.
Luminosité
Pourcentage de luminosité détecté par l’appareil.
L’écran doit être allumé pour obtenir une valeur, autrement la valeur sera 0.
Exprimé en %.
Modèle
Modèle de l’appareil et version iOS en cours d’exécution.
Statut cnx SSH Scénario
Statut de la connexion avec l’appareil..
1 = connexion établie ; 0 = en cas de non réponse.
Température CPU
Température relevée par les capteurs du core.
Si aucun capteur n’est présent, la température batterie sera affichée.
Exprimé en °C.
Branché
Indique si l’appareil est branché au secteur ou non.
1 = branché ; 0 = sur batterie.
Charge système 1min
Moyenne de la charge système sur 1 minute.
Charge système 5min
Moyenne de la charge système sur 5 minutes.
Charge système 15min
Moyenne de la charge système sur 15 minutes.
Coordonnées GPS
Retourne les coordonnées GPS de l’appareil à cet instant.
Exprimé en longitude,latitude (x,y).
CPU(s)
Nombre de CPU et la fréquence.
Cycles
Nombre de cycles effectués par la batterie.
Démarré depuis
Temps depuis le dernier démarrage.
Exprimé en jours, heures et minutes.
Distribution
Distribution, version et architecture de l’appareil.
Espace disque Total
Espace maximal sur le disque principal.
Exprimé en Go.
Espace disque Utilisé
Espace utilisé sur le disque principal.
Exprimé en Go.
Espace disque Utilisé (pourcentage)
Espace maximal sur le disque principal.
Exprimé en %.
Les commandes perso (action/info)
La commande perso permet de personnaliser soi-même une information/action en entrant la commande bash/ssh.
Par défaut, le plugin créé 2 commandes info perso (Info et Info1) et 2 commandes action perso (Perso et Perso1) qui sont vierges.
Commande Info : à partir des scripts existants
Le script current_page.sh
- donne le nom de la page actuelle ouverte sur l’équipement (springboard/lockscreen/application) dans le cas d’application, le vrai nom de l’application est recherché et affiché.
- commande à saisir dans le champ : bash jailed/current_page.sh
- arguments de la commande (ajouter en fin de ligne…) : aucun
- argument optionnel de la commande : -i en fin de commande pour rechercher sur iTunes le nom de l’app.
Exemples de commandes et la valeur de la commande sur Jeedom :
Commande | Résultat | Commentaire |
---|---|---|
bash jailed/current_page.sh | lockscreen | l’écran est verrouillé |
bash jailed/current_page.sh | springboard | il s’agit de l’écran d’accueil |
bash jailed/current_page.sh | Books | il s’agit de l’application Livres |
bash jailed/current_page.sh -i | Livres | il s’agit de l’application Livres |
Note
Pour fonctionner, il faut installer le tweak Activator.
Les commandes ssh
Si vous connaissez une commande permettant d’obtenir une information utile, n’hésitez pas à me le remonter.
Exemple de commandes et la valeur de la commande sur Jeedom
Commande Action : à partir des scripts existants
Le script activator_send.sh
- commande à saisir dans le champ : bash jailed/activator_send.sh XXX
- arguments de la commande (remplacer XXX par…) : un des paramètres listés ici : Paramètres => low-power/home/respring/sleep/location/rotation/avion/verrou/modesombre/moinsfort/plusfort/audio 100/lumiere 100/screenshot/photo/pluslumiere/moinslumiere
- argument optionnel de la commande : un chiffre de de 1 à 10 (répétition de la commande)
Les commandes manuelles
- Activator :
activator send listeners
, avec, à la place de listeners : une des lignes listées dans le champ texte de Menu Installation > Equipement > Activator Listeners.
Cela permet d’ouvrir toutes les applications disponibles sur l’équipement ou d’exécuter des actions (activer darkmode, couper bluetooth, couper wifi…) - FlipSwitch :
switch toggle XXX
, avec XXX : une des lignes listées dans la commande switch list.
Cela permet d’exécuter des actions du style (activer darkmode, couper bluetooth, couper wifi…) - SimulateTouch :
stouch touch 200 100
Cela permet de simuler un clic/pointer/swiper sur l’écran. - AutoTouch : …
Cela permet de configurer et d’enregistrer des gestes réalisés sur l’écran.
Raccourcis (iOS 12/13/14)
Possibilité de lancer ses raccourcis depuis Jeedom.
1) Sur l’application Raccourcis, récupérer le nom du raccourci créé/téléchargé.
2) Sur Jeedom, dans la commande perso, entrer uiopen "shortcuts://run-shortcut?name=XXX"
en remplaçant XXX par le nom du raccourci.
Si votre appareil est verrouillé, pensez à lancer la commande de déverrouillage avant celle-ci, commande unlock
Activator (compatible iOS 9/10/11/12/13)
- Soit en tapant directement la commande complète :
activator send abracadabra
- Soit en utilisant le script transféré précédemment depuis la page Installation :
bash jailed/activator_send.sh <paramètre> <répétition>
. Voici la liste des paramètres :- low-power|power (bascule le mode d’économie d’énergie),
- homebutton|home (appuie sur le bouton home),
- respring (lance un respring),
- sleep|veille (appuie sur le bouton verrouillage),
- location (bascule la localisation),
- rotation (bascule le verrouillage de rotation d’écran),
- airplane-mode|airplane|avion (bascule le mode avion),
- moinsfort|volumemoins (baisse le son),
- plusfort|volumeplus (augmente le son),
- screenshot (prend un imprim’ecran),
- souriez|photo (prend une photo avec le dernier objectif utilisé : exécuter 2 fois si hors de l’App photo),
- pluslumiere (augmente la luminosité),
- moinslumiere (baisse la luminosité),
- audio N (avec N entre 0 et 100 => fixe une valeur au volume),
- lumière N (avec N entre 0 et 100 => fixe une valeur à la luminosité),
- autolock|verrou (activer/désactiver le verrouillage automatique),
- darkmode|modesombre (activer/désactiver le mode sombre).
La paramètre répétition permet de répéter N fois la commande demandée.
Ex : bash jailed/activator_send.sh pluslumiere 5 => répète 5 fois la commande pluslumiere
Attention à la version installée de Activator.
Il peut y avoir un comportement très étrange avec Lock ou Unlock sur iOS 13 : Impossible de déverrouiller ou de verrouiller.
Par défaut sur cydia la dernière version stable est la 1.9.13 alors que la toute dernière version en date est la 1.9.13~rc6
Il faut forcer l’installation de la version 1.9.13 ~rc6 !
Si vous n’y arrivez pas via Cydia, il est possible d’entrer cette commande en ssh, ou via une commande action perso et de l’exécuter :
wget https://rpetri.ch/repo/debs/libactivator_1.9.13~rc6_iphoneos-arm.deb && dpkg -i libactivator_1.9.13~rc6_iphoneos-arm.deb && killall backboardd
Créer ses notifications personnalisées depuis l’appareil (Activator)
- Sur l’appareil, ouvrez l’app Activator,
sélectionnez « Partout »,
puis assignez-le à un évènement, (peut être réassigné une fois créé),
cliquez sur « Build »,
puis « Show message alert »,
entrez votre « Titre » et « Message personalisé » et « Enregistrer » puis « OK ». - Il faut maintenant identifier le message créé pour récupérer son ID.
- Méthode 1 : Connectez-vous en SSH à l’appareil et entrez dans l’invite de commande
activator listeners | grep message.show
.
Si un seul message s’affiche, récupérez son ID. Si plusieurs messages sont enregistrés :activator get LAMessageListeners
- Méthode 2 : Activez les logs Debug du plugin Jailbreak dans Jeedom.
Saisissez ce code dans le champ commande perso sur l’équipementactivator get LAMessageListeners
,
Sauvegarder, et Tester.
Dans les log générés, récupérez l’ID du/des messages à la fin de la ligne :[2020-01-01 12:00:00][DEBUG] : Sortie action perso :
Récupérez la chaine ID qui suit...message.show.XXX
- Méthode 1 : Connectez-vous en SSH à l’appareil et entrez dans l’invite de commande
- Mettez dans le champ commande perso :
activator send libactivator.message.show.XXX
en remplaçant XXX par l’ID récupéré.
Le plugin contient 2 commandes par défaut lors de la création d’un équipement. Il est possible d’en créer davantage en cliquant sur le bouton « Ajouter une commande perso ».
Ajouter une commande action perso App
Il est désormais possible d’ajouter autant de commandes action Application que l’on veut. C’est-à-dire une commande pour lancer une application à distance ou exécuter une action.
Dans la page de l’équipement, onglet Commandes perso, cliquez sur le bouton Ajouter une commande/action App.
Après chargement de cette fenêtre, 2 menus déroulants apparaissent. L’un liste toutes les applications de votre appareil, l’autre toutes les actions possibles.
Entrez un nom de commande, et sélectionnez soit une action soit une application et cliquez sur le bouton Ajouter la commande qui apparaît en-dessous.
Le modal se ferme et une commande apparaît une fin de liste de la page.
Pensez à enregistrer pour prendre en compte le changement.
Gestion des cron (menu Installation)
Ce sont des tâches directement sur l’appareil que l’on sélectionne.
C’est-à-dire qu’elles sont programmées sur l’appareil pour être exécutées à des intervalles définis.
Cron mise à jour des scripts
Cette tâche consiste à mettre à jour les scripts essentiels au fonctionnement des paquets et du plugin Jailbreak.
Elle va télécharger et mettre à jour en fonction des versions présentes depuis GitHub.
Exécutée 1 fois par jour.
Cron mise à jour des paquets/cmd
Cette tâche consiste à mettre à jour l’ensemble des paquets et outils de l’appareil.
Exécutée 1 fois par jour.
Cron commandes personnalisable
Cette tâche permet d’envoyer des informations listées selon des intervalles définis allant de 5 secondes à 4 minutes.
Particulièrement utile lorsqu’on veut remonter des informations immédiatement (consommation, sortie de veille…)
Attention aux intervalles rapprochés qui risquent de consommer la batterie de votre appareil.
Sélectionnez une ou plusieurs commandes dans la liste. Il s’agit des commandes de base du plugin et de quelques autres (consommation, Application en cours…). Remontez-moi les commandes que vous souhaitez que j’intègre.
Choisissez l’intervalle de temps et cliquez sur créer.
Le cron va être créé sur l’appareil et être exécuté. En rechargeant la page, son statut va passer à OK.
- Vous pouvez alors le stopper : cliquez sur le carré blanc sur fond rouge stop son exécution, il suffit de cliquer sur le triangle blanc sur fond vert pour le relancer (inutile de le recréer à zéro),
- récupérez les log : cliquez sur le bouton Log va télécharger les log et les présenter dans la page Configuration du plugin (_cron à la fin du nom),
- laissez Jeedom gérer la gestion automatique : si vous activez la fonction, le plugin Jailbreak va vérifier chaque jour que le cron est exécuté et le lancer dans le cas contraire.
Gestion des paquets (menu Paquets)
Depuis le plugin, cliquez sur le menu Paquets.
La page met quelques secondes à se charger. Cela dépend du nombre d’appareils que vous avez enregistrés et de leur réactivité.
Depuis cette page, vous pouvez voir la liste des paquets utilisés par le plugin Jailbreak.
On peut voir leur statut (installé ou non), leur état (bloqué, figé, en erreur…), si le plugin en a besoin, leur version, quelques informations sur la commande en question.
Par la colonne Action, on peut également :
- voir plus d’informations par un nouveau modal,
- supprimer, corriger les paquets.
Depuis cette nouvelle page, on peut voir toutes les informations du paquet, mais également bloquer la version.
Cette page est également ouverte quand on recherche un paquet manuellement :
Elle permet de vérifier l’existence d’un paquet, vérifier ses info, et l’installer manuellement.
Depuis la page principale du menu Paquets, on a aussi accès aux fichiers sources.list (sources des repo du gestionnaire de paquet APT).
Sur ce nouveau modal, on a accès aux différents fichiers sources.list présents sur l’appareil.
On peut alors les modifier, ajouter des repo, en supprimer.
Gestion des cron (menu Cron)
Depuis le plugin, cliquez sur le menu Cron.
Cette page, comme le menu Installation, affiche les cron exécutés sur l’appareil.
Elle permet une meilleure gestion des cron.
Elle affiche le nom du cron, son statut (lancé, en erreur ou arrêté).
Depuis la colonne Action, on peut également :
- voir plus d’informations par un nouveau modal,
- lancer, arrêter, supprimer (pas encore géré).
Ce modal d’informations de cron permet d’afficher les informations des 2 fichiers le gérant : le lanceur et le script exécutif.
On peut modifier ces fichiers.
Gestion des commandes SSH (menu Debug)
Depuis le plugin, cliquez sur le menu Debug.
Cette page permet de lancer des commandes par SSH sur l’appareil.
Des commandes préenregistrées se trouvent sur la barre menu de gauche.
Les commandes info de base sont également présentes ainsi que toutes les commandes info perso que vous avez enregistrées dans l’équipement.
ASTUCE pour exécuter la commande déverrouillage avant une commande
Dans les réglages de la commande que l’on veut lancer (ouvrir Safari, ouvrir une app), ajoutez une action avant exécution de la commande, et cherchez la commande de déverrouillage (unlock) puis sauvegardez.
Une réflexion sur « Documentation du plugin Jailbreak pour Jeedom »