Open ChirpStack : j'en avais marre d'ajouter mes devices un par un, alors j'ai fait l'outil

Hello la GTB ! 👋

Bon. On va parler d’un truc qui m’a cassé les roustons pendant des mois : ajouter des devices dans ChirpStack.

Parce que ChirpStack, c’est top, hein. C’est libre, c’est solide, ça tourne sur un Raspberry comme sur un gros serveur. Mais son interface web a été pensée pour ajouter un capteur. Un seul. Tu cliques sur « Add device », tu tapes le nom, tu colles le DevEUI, tu choisis le profil, tu valides, tu vas dans l’onglet des clés, tu colles l’AppKey, tu valides. Et tu recommences.

Pour 5 capteurs, ça passe. Pour 300 sondes de température dans un bâtiment tertiaire, tu finis la journée avec une tendinite et trois DevEUI inversés que tu ne retrouveras jamais. 🫠

Phase 1 : « je vais faire un petit script »

Comme tout bon intégrateur un peu flemmard (c’est une qualité), je me suis tourné vers l’API. Un petit script Python qui lit le fichier Excel du fournisseur et crée les devices, c’est torché en une heure.

Sauf que.

Au bout de deux LNS, j’avais :

• un script d’import, puis un deuxième parce que le fournisseur avait changé l’ordre des colonnes ;
• un script pour migrer des devices d’une application à une autre (spoiler : ChirpStack n’a pas de bouton pour ça, il faut supprimer et recréer, en priant pour ne rien perdre au passage) ;
• un script pour retagger tout un étage ;
• un script pour trouver les capteurs muets depuis trois jours ;
• et un dossier scripts_chirpstack_v2_final_OK_vraiment/ que plus personne n’osait ouvrir.

Et je ne te parle pas d’Excel, qui mange gentiment les zéros de tête de tes DevEUI, ou les passe en notation scientifique, dès que la colonne est au format nombre. Merci Excel. 🙃

Phase 2 : « bon, Claude, à toi »

À un moment, j’en ai eu ras le bol de recoller des bouts de code à droite à gauche. Alors j’ai branché notre ami Claude là-dessus. Je lui ai décrit tout ce qui me saoulait, les cas tordus rencontrés en vrai sur chantier, et ce que j’aurais voulu avoir dès le départ.

Résultat : il m’a pondu l’outil que j’aurais rêvé d’avoir. ChirpStack, mais pensé pour le volume et l’exploitation.

Ce que ça fait

En vrac, parce que la liste est longue :

• Import en masse depuis un CSV, un Excel ou un simple copier-coller depuis ton tableur. Les colonnes sont reconnues toutes seules, tout est vérifié avant l’envoi, les doublons sont mis à jour au lieu de planter, et tu peux annuler l’import.
• Migration d’une application à une autre : fiche, tags, clés et session sont copiés, et si la recréation foire, le device est remis à sa place. Plus de sueurs froides.
• Actions groupées : tu filtres, tu sélectionnes (Maj + clic pour une plage, comme dans l’explorateur), puis tu tagges, changes le Device Profile, exportes ou supprimes. Avec une sauvegarde JSON avant suppression, au cas où.
• Santé du parc en un coup d’œil : capteurs silencieux, jamais vus, piles faibles, gateways hors ligne.
• Historique des mesures : plusieurs capteurs sur le même graphe, zoom, stats, export CSV et PNG. Pratique pour un retex ou pour clouer le bec à un client qui dit que « la salle est froide ».
• Et le détail qui sauve des vies : il détecte les DevEUI massacrés par Excel. ❤️

Comment ça marche

Pas de Docker, pas de serveur, pas de compte. Tu télécharges un seul fichier (Windows, macOS ou Linux, et même ARM pour ton Raspberry), tu double-cliques, ton navigateur s’ouvre et tu colles ta clé API ChirpStack. C’est tout.

Ta clé reste sur ton poste, rien ne part ailleurs, pas de télémétrie. L’outil fait juste un petit relais local entre ton navigateur et ton ChirpStack, en gRPC-web, le protocole qu’utilise l’interface officielle. Donc si ton interface ChirpStack s’ouvre, l’outil marche, même derrière un reverse proxy.

Petit conseil quand même : les actions en masse modifient vraiment ton ChirpStack. Fais ton premier essai sur une application de test, hein. 😅

Tu veux tester ?

Tu n’as pas de ChirpStack sous la main ? Pas grave : y a une démo en ligne avec un parc fictif de 247 devices, qui tourne entièrement dans ton navigateur. Tu peux tout casser, même supprimer, tout revient au rechargement.

👉 La page de l’outil, avec la démo

👉 Le code et les téléchargements sur GitHub

C’est gratuit, open source (MIT) et compatible ChirpStack v4. Si tu trouves un bug ou s’il te manque une fonction, ouvre une issue sur GitHub ou laisse un commentaire juste en dessous. Et si ça te fait gagner une après-midi de clics, dis-le aussi, ça fait plaisir. 😉

À plus la GTB !