Aller au contenu principal

Intégration IPP Printers pour Gladys Assistant

Intégration IPP Printers pour Gladys Assistant

Niveaux d'encre/toner et état de vos imprimantes réseau via IPP (AirPrint). Local, sans cloud.

Voir sur GitHubToutes les intégrations externes

Cette intégration surveille vos imprimantes réseau via le protocole standard IPP (Internet Printing Protocol) — celui qu'utilise AirPrint. Elle fonctionne entièrement en local : pas de compte, pas de cloud, pas de clé d'API.

Ce que vous obtenez​

Un appareil Gladys par imprimante, avec :

  • un capteur par cartouche d'encre ou de toner (niveau en %), avec historique — de quoi tracer la consommation dans le temps et déclencher des scènes (« encre noire sous 10 % → notification ») ;
  • l'état de l'imprimante : idle (prête), printing (impression en cours), stopped (arrêtée), avec la raison quand l'imprimante la fournit (stopped (media-empty) = plus de papier). L'état est surveillé en continu (échantillonné toutes les 15 s) et mis à jour dès qu'il change, indépendamment de l'intervalle réglé pour les niveaux : une impression ne dure que quelques secondes.

Si votre imprimante affiche en permanence idle, c'est le plus souvent normal : c'est l'état d'une imprimante allumée qui n'a rien à faire. Il ne change que pendant une impression ou en cas de problème (plus de papier, bourrage). Le bouton « Tester une imprimante » vous montre en direct ce que la vôtre annonce à un instant donné.

Compatibilité​

Toute imprimante réseau compatible AirPrint / IPP Everywhere (l'immense majorité des imprimantes vendues depuis ~2012 : HP, Epson, Canon, Brother, Lexmark…). L'imprimante doit être sur le même réseau que Gladys, avec IPP activé (il l'est par défaut ; certains menus l'appellent « AirPrint »).

Certaines imprimantes n'annoncent pas leurs niveaux d'encre via IPP : dans ce cas l'appareil n'expose que son état.

Configuration​

  1. Installez l'intégration : les imprimantes annonçant IPP en mDNS sont découvertes automatiquement et apparaissent dans l'onglet Découverte.
  2. Si une imprimante n'est pas trouvée (mDNS bloqué, autre sous-réseau…), ajoutez-la dans Imprimantes (liste manuelle) : une IP (192.168.1.20), un nom d'hôte (imprimante.local) ou une URI complète (ipp://192.168.1.20/ipp/print), séparés par des virgules.
  3. Ajustez au besoin l'intervalle de rafraîchissement (900 s par défaut — les niveaux d'encre évoluent lentement). Il ne concerne que les niveaux : l'état est surveillé en continu (toutes les 15 s).
  4. Choisissez au besoin la langue des noms des capteurs : par défaut ce sont les noms bruts annoncés par l'imprimante (souvent en anglais, du type « black cartridge ») ; en sélectionnant Français, les cartouches reconnues deviennent « Encre noire », « Toner cyan »… Le réglage s'applique aux appareils nouvellement ajoutés — pour un appareil existant, renommez ses fonctionnalités depuis sa page, ou supprimez-le puis re-ajoutez-le (l'historique des anciennes fonctionnalités est alors perdu).
  5. Ajoutez les appareils découverts depuis l'onglet Découverte.

Conseil : attribuez une IP fixe (réservation DHCP) aux imprimantes dont l'identifiant unique (UUID) n'est pas annoncé — l'intégration se rabat alors sur le nom d'hôte pour les identifier.

Actions​

  • Tester une imprimante — saisissez une IP, un nom d'hôte ou une URI ipp:// : l'intégration l'interroge en direct et affiche le modèle, l'état et les niveaux détectés. Le moyen le plus rapide de vérifier une adresse avant de l'ajouter à la liste manuelle.

Dépannage​

  • L'imprimante n'est pas découverte : vérifiez qu'elle répond en IPP avec l'action « Tester une imprimante ». Si le test échoue, vérifiez que le port 631 est ouvert et qu'IPP/AirPrint est activé dans les réglages de l'imprimante.
  • Pas de niveaux d'encre : l'imprimante ne publie pas les attributs marker-levels via IPP. C'est une limite du firmware, pas de l'intégration.
  • Une seule cartouche affiche « inconnu » (souvent le noir, sur HP) : si cette cartouche est rechargée ou compatible, c'est voulu par HP — le firmware refuse d'estimer le niveau des cartouches non authentiques (il affiche « ? » jusque sur l'écran de l'imprimante). La valeur n'existe nulle part ; avec une cartouche d'origine, le niveau réapparaît tout seul. Le bouton « Tester une imprimante » montre la valeur brute renvoyée (« inconnu (-2) »).
  • L'imprimante répond mais en erreur (HTTP 500, HTTP 426) : fréquent sur les firmwares minimalistes (Epson EcoTank notamment). L'intégration essaie automatiquement plusieurs variantes de requête (IPP 1.1 puis 2.0, avec puis sans liste d'attributs) et bascule d'elle-même en IPP chiffré (ipps://) quand l'imprimante l'exige (HTTP 426). Si tout échoue, le bouton « Tester une imprimante » affiche l'erreur exacte — collez-la sur le forum.
  • Chemin IPP non standard : par défaut l'intégration essaie /ipp/print, /ipp puis /. Si votre imprimante utilise un autre chemin (certaines files CUPS par exemple), saisissez l'URI complète : ipp://hôte:631/le/chemin.
  • Les logs de l'intégration (UI Gladys ou docker logs, avec LOG_LEVEL=debug pour le détail) tracent chaque requête et chaque imprimante ignorée.

Paramètres de configuration​

Voici les paramètres demandés par IPP Printers dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
FonctionnementsectionNonLes imprimantes annonçant IPP (toute imprimante compatible AirPrint) sont découvertes automatiquement sur votre réseau. Vous pouvez aussi les déclarer manuellement ci-dessous — utile quand le mDNS ne les atteint pas. Chaque imprimante expose un capteur par cartouche d'encre ou de toner, plus son état.
Imprimantes (liste manuelle)stringNonOptionnel. IP, noms d'hôte ou URI ipp://, séparés par des virgules — ex. 192.168.1.20, imprimante.local, ipp://192.168.1.30/ipp/print.
Noms des capteursselectNonS'applique aux appareils nouvellement ajoutés. Les imprimantes annoncent leurs consommables dans leur propre langue (souvent l'anglais) : gardez-les tels quels, ou traduisez les cartouches reconnues.
Rafraîchissement des niveaux (s)numberNonFréquence d'enregistrement des niveaux d'encre/toner, en secondes. Ils évoluent lentement : 900 s (15 min) suffisent largement. L'état de l'imprimante est surveillé en continu (échantillonné toutes les 15 s) et mis à jour dès qu'il change.

Comment installer IPP Printers dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : IPP Printers apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-ipp:1.0.5), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-ipp.

IPP Printers nécessite Gladys >=4.62.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

IPP Printers est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le