Bien démarrer avec DeckPuls

1. Démarrage

Créer un compte

1. Ouvrez la page Créer un compte.
2. Saisissez votre adresse email professionnelle et un mot de passe d'au moins 10 caractères (12 ou plus recommandés).
3. Acceptez les conditions générales d'utilisation après avoir pris connaissance de la politique de confidentialité, puis validez.

Une organisation est créée à votre nom et vous en êtes le propriétaire. L'essai gratuit démarre : 30 jours, 2 écrans, sans carte bancaire.

Valider votre adresse email

Un email de validation vous est envoyé immédiatement. Cliquez sur le lien qu'il contient pour activer votre compte : tant que l'adresse n'est pas validée, la connexion au dashboard est refusée.

• Rien reçu ? Vérifiez vos courriers indésirables, puis demandez un nouvel envoi depuis la page Renvoyer l'email de validation.
• Le lien a une durée de validité limitée : s'il a expiré, demandez-en un nouveau de la même façon.
• Un compte qui n'est pas validé dans les 7 jours est supprimé automatiquement. Il suffit alors de vous réinscrire.

Première connexion au dashboard

1. Connectez-vous sur dashboard.deckpuls.com avec votre email et votre mot de passe. En cas d'oubli, utilisez « Mot de passe oublié » sur la page de connexion.
2. Dans les réglages de l'organisation, vérifiez son nom et son fuseau horaire : il sert à interpréter les dates et créneaux de vos campagnes.
3. Dans les réglages de votre compte, activez la double authentification. C'est fortement recommandé pour le compte propriétaire.
4. Appairez votre premier écran (section suivante), puis invitez votre équipe si besoin.

Votre compte, votre mot de passe, la double authentification, le SSO, les utilisateurs et tous les réglages se gèrent dans le dashboard.

2. Appairer un écran

L'appairage relie un player à votre organisation. L'écran n'a besoin que d'un accès à internet en sortie : aucun port à ouvrir, aucune adresse IP fixe.

1. Lancez le player sur l'appareil (voir Installer un player). Il affiche un code à 6 chiffres et un QR code.
2. Dans le dashboard, ouvrez la page des écrans et choisissez d'appairer un écran. Saisissez le code, ou scannez le QR code avec votre téléphone ou votre tablette connecté au dashboard.
3. Donnez un nom à l'écran (par exemple « Vitrine Lyon » ou « Accueil RDC »), choisissez éventuellement son site et ses groupes, puis validez.
4. L'écran passe en lecture en quelques secondes. Sans contenu attribué, il affiche un écran d'attente : choisissez un contenu par défaut.

Retirer ou remplacer un écran. Supprimer un écran dans le dashboard le désappaire : son jeton d'accès est révoqué et le player revient à l'écran d'appairage. Pour remplacer un matériel, désappairez l'ancien puis appairez le nouveau.

3. Installer un player

Tous les players partagent le même fonctionnement : appairage par code, lecture de la programmation, envoi des preuves de diffusion et des informations de supervision. Ils gardent leurs contenus et leur programmation pour continuer à diffuser jusqu'à 7 jours sans connexion, et se mettent à jour automatiquement.

Navigateur web

Convient à un PC, un Mac, un mini PC ou tout appareil relié à un écran et équipé d'un navigateur récent (Chrome, Edge, Firefox ou Safari).

1. Ouvrez https://player.deckpuls.com.
2. Passez en plein écran (touche F11 sous Windows et Linux). Pour un poste dédié, lancez le navigateur en mode kiosque, par exemple : chrome --kiosk https://player.deckpuls.com.
3. Appairez l'écran avec le code affiché.
4. Désactivez la mise en veille de l'ordinateur et de l'écran, et lancez le navigateur au démarrage de la session.

L'appairage est mémorisé dans le navigateur : n'utilisez pas la navigation privée et n'effacez pas les données du site player.deckpuls.com, sinon l'écran devra être appairé à nouveau.

Mini PC DeckPuls Box

La DeckPuls Box est un mini PC sous Linux équipé de l'agent DeckPuls. Elle pilote un à trois écrans : chaque sortie vidéo devient un écran DeckPuls indépendant, avec son propre contenu, sa programmation et sa supervision.

1. Branchez les écrans sur les sorties vidéo, le réseau (câble Ethernet conseillé) puis l'alimentation. Le boîtier démarre directement sur DeckPuls.
2. Rattachez le boîtier à votre organisation, au choix :
   • Sortie par sortie : chaque sortie libre affiche un code d'appairage, à saisir comme pour tout autre player. La commande « Identifier » affiche le nom de chaque sortie sur son écran pour s'y retrouver.
   • Code du boîtier : au premier démarrage d'un boîtier sans clé d'enrôlement, un code s'affiche sur la première sortie. Saisissez-le dans la page des boîtiers du dashboard, puis attribuez chaque sortie à un nouvel écran ou à un écran existant.
   • En série : créez une clé d'enrôlement dans le dashboard (site et groupe par défaut, nombre d'utilisations, date d'expiration). Placez-la dans le fichier /etc/deckpuls-box/config.json ("enrollment_key": "dpe_…") ou dans un fichier deckpuls.json sur une clé USB branchée au premier démarrage. Les boîtiers s'enrôlent seuls.
3. Facultatif : configurez le pilotage des téléviseurs par HDMI-CEC (allumage et mise en veille selon le planning d'allumage de chaque écran) et un redémarrage nocturne.

Installer l'agent sur votre propre mini PC. Installez Debian 13 (conseillé, ou Debian 12, ou Ubuntu 24.04 Server) en installation minimale, sans environnement de bureau. Branchez les écrans, puis lancez en root (su -) :

wget -qO- https://deckpuls.com/box/install.sh | bash

Le script télécharge l'agent depuis deckpuls.com, vérifie son empreinte, installe le nécessaire (serveur d'affichage, Google Chrome, décodage vidéo, pilotage HDMI-CEC) et démarre l'agent. Un code d'appairage s'affiche alors sur le premier écran : saisissez-le dans le dashboard (Écrans › Boîtiers). Pour une installation en série avec une clé d'enrôlement : wget -qO- https://deckpuls.com/box/install.sh | bash -s -- --key dpe_…. Relancer la même commande met l'agent à jour.

Dans le BIOS du mini PC, réglez « Restore on AC Power Loss » sur « Power On » pour qu'il redémarre seul après une coupure de courant.

Android et Android TV

Pour les boîtiers TV, téléviseurs, tablettes et écrans professionnels sous Android ou Android TV.

1. Téléchargez l'application DeckPuls Player (fichier APK) : [À COMPLÉTER : adresse de téléchargement de l'APK Android].
2. Autorisez l'installation d'applications de sources inconnues pour le navigateur ou le gestionnaire de fichiers utilisé (dans les paramètres de sécurité de l'appareil ; l'emplacement varie selon le modèle).
3. Installez puis ouvrez l'application : elle affiche le code d'appairage. Sur Android TV, elle se pilote à la télécommande.
4. Selon l'appareil, réglez le lancement automatique au démarrage et le mode kiosque.

Le redémarrage de l'appareil à distance n'est possible que si l'application est configurée comme application d'appareil dédié (propriétaire de l'appareil).

Écrans Samsung (Tizen)

Sur les écrans professionnels Samsung équipés de la fonction URL Launcher :

1. Ouvrez le menu de l'écran avec la télécommande, puis l'option qui choisit la source de lecture (selon les modèles : menu Système ou Assistance, « Lecture via »), et sélectionnez URL Launcher.
2. Dans les paramètres d'URL Launcher, installez l'application web à l'adresse : https://player.deckpuls.com/?platform=tizen
3. Lancez URL Launcher : le player affiche le code d'appairage.
4. Vérifiez que l'écran redémarre sur URL Launcher après une coupure de courant.

Écrans LG (webOS)

Sur les écrans professionnels LG webOS Signage, l'application DeckPuls s'installe par le mode serveur SI :

1. Ouvrez les réglages de l'écran avec la télécommande, puis les paramètres du serveur SI (selon les modèles, dans le menu Général ou en mode installateur).
2. Activez le mode serveur SI et renseignez : [À COMPLÉTER : adresse, port et identifiant d'application du serveur SI DeckPuls pour LG webOS].
3. Redémarrez l'écran : il télécharge l'application DeckPuls puis affiche le code d'appairage.

iPad et Apple TV

1. Installez l'application DeckPuls Player depuis l'App Store sur l'iPad ou l'Apple TV : [À COMPLÉTER : liens App Store de l'application DeckPuls Player (iPad et Apple TV)].
2. Ouvrez l'application : elle affiche le code d'appairage.
3. Sur iPad, réglez le verrouillage automatique sur « Jamais » (Réglages → Luminosité et affichage) et activez l'Accès guidé (Réglages → Accessibilité) pour garder l'iPad sur l'application.
4. Sur Apple TV, réglez la suspension sur « Jamais » (Réglages → Général → Suspendre après).

4. Contenus

Médias

La médiathèque accepte les images, les vidéos, les PDF et les présentations PowerPoint, jusqu'à 2 Go par fichier. Un envoi interrompu reprend là où il s'est arrêté.

• Les vidéos sont analysées et, si leur format n'est pas lisible par tous les players, converties en MP4 (H.264), jusqu'en 4K.
• Les PDF et les PowerPoint sont convertis en une image par page.
• L'orientation des photos est corrigée automatiquement et une vignette est créée.

Classez vos médias en dossiers, ajoutez des étiquettes et, si besoin, une date d'expiration : passé cette date, le média est retiré automatiquement des playlists. Depuis chaque média, vous voyez les playlists et mises en page qui l'utilisent.

Validation des médias. Si l'organisation l'exige, les médias envoyés par les éditeurs restent en attente jusqu'à leur validation par un gestionnaire ou le propriétaire.

Modules

Les modules sont des contenus dynamiques, mis à jour automatiquement. Les champs secrets (jetons, adresses d'agenda privées) sont enregistrés mais ne sont jamais réaffichés.

Modules personnalisés

Pour un affichage sur mesure, créez un module personnalisé : envoyez une archive .zip contenant votre module HTML (une page index.html et ses ressources). Les paramètres JSON saisis dans le dashboard lui sont transmis, ce qui permet de réutiliser un même module avec des réglages différents.

Playlists

Une playlist enchaîne des médias et des modules. Pour chaque élément, réglez la durée et la transition, ou désactivez-le temporairement sans le retirer. Sans durée précisée :

• image : 10 secondes ;
• vidéo : sa durée ;
• module : 15 secondes ;
• PDF ou PowerPoint : 10 secondes par page.

Une playlist peut être dupliquée pour créer rapidement une variante.

Mises en page multi-zones

Une mise en page découpe l'écran en zones : par exemple une vidéo, la météo, une horloge et un bandeau défilant. Partez d'une grille prête ou dessinez vos zones (position et taille en pourcentage, superposition). Chaque zone diffuse une playlist, cadrée en entier ou en remplissage. Une zone peut aussi être déclarée locale : son contenu est alors choisi par chaque site (voir décrochage local).

5. Campagnes et programmation

Contenu par défaut

Chaque écran a un contenu par défaut, playlist ou mise en page, diffusé en dehors des campagnes. Il se règle écran par écran ou pour plusieurs écrans à la fois.

Campagnes datées

Une campagne diffuse une playlist ou une mise en page selon des règles :

Cibles

Tous les écrans, ou une sélection d'écrans, de groupes, de sites ou d'étiquettes. Les écrans ajoutés plus tard à un groupe ciblé sont pris en compte automatiquement.

Période, jours et créneaux

Dates de début et de fin, jours de la semaine et plages horaires (par exemple du lundi au vendredi, de 11 h 30 à 14 h).

Priorité

Quand plusieurs campagnes se chevauchent, la plus prioritaire l'emporte.

Mode

Remplacer : la campagne prend la place du contenu par défaut. Insérer : elle s'intercale régulièrement dans le contenu en cours, selon la fréquence choisie.

Conditions

La campagne peut ne s'afficher que si une condition est remplie : selon la météo ou selon un agenda.

Statut

Active, en pause ou brouillon.

Le calendrier montre les campagnes jour par jour, et chaque campagne liste les écrans qu'elle touche. Une campagne peut être dupliquée.

Ce que l'écran affiche

Le player décide lui-même, chaque minute et à chaque changement, de ce qu'il affiche. Il continue donc à suivre la programmation même hors ligne. L'ordre est le suivant :

1. un message d'urgence en cours ;
2. sinon, la campagne en mode « remplacer » la plus prioritaire ;
3. sinon, le contenu par défaut de l'écran ;
4. les campagnes en mode « insérer » s'intercalent dans ce qui est diffusé.

Message d'urgence

Un message d'urgence s'affiche immédiatement par-dessus tout autre contenu, sur tous les écrans ou sur une sélection. Choisissez le style (information, avertissement ou danger) et, si besoin, une heure de fin. Il reste affiché jusqu'à cette heure ou jusqu'à son annulation. Il est réservé aux gestionnaires et au propriétaire.

6. Réseaux multi-sites

Organiser le parc

• Sites : un magasin, une agence, un bâtiment.
• Groupes : un ensemble d'écrans à piloter ensemble (« vitrines », « écrans caisse », « région Ouest »). Un écran peut appartenir à plusieurs groupes.
• Étiquettes : des repères libres pour filtrer et cibler.

Les actions groupées appliquent en une fois un contenu par défaut, des étiquettes, des groupes, un site ou une commande à une sélection d'écrans.

Décrochage local

Le siège conçoit une mise en page commune et y prévoit une zone locale. Chaque site choisit la playlist de cette zone (promotions du magasin, informations de l'agence) sans toucher au reste de l'écran. Associé à la restriction par groupes, chaque responsable de site n'agit que sur ses écrans.

Supervision et commandes à distance

• Un écran est en ligne s'il a donné signe de vie depuis moins de 2 minutes.
• Pour chaque écran : contenu en cours de diffusion, captures d'écran, version du player, charge, mémoire, stockage, température quand l'appareil la fournit, et journal des événements.
• Commandes : recharger, prendre une capture, identifier, vider le cache, allumer, éteindre, régler le volume, redémarrer (selon ce que permet l'appareil).
• Planning d'allumage : jours et heures d'allumage et d'extinction de chaque écran.

Alertes

Recevez une alerte par email ou par webhook quand un écran est hors ligne au-delà du délai choisi, quand la charge, la température ou l'occupation du disque sont trop élevées, puis quand l'écran revient en ligne. Une plage silencieuse évite les notifications la nuit.

Espace revendeur et marque blanche

Un revendeur crée et gère les organisations de ses clients (limite d'écrans, invitation du propriétaire), puis intervient dans chacune d'elles depuis son propre compte. La marque blanche remplace le nom, le logo et la couleur de DeckPuls par les vôtres, avec un domaine personnalisé. Pour ouvrir un espace revendeur, contactez-nous.

7. Preuve de diffusion, statistiques et rapports

Chaque player enregistre ce qu'il diffuse (contenu, campagne, zone, heure de début et durée), même hors ligne, et l'envoie dès que la connexion le permet. Vous obtenez :

• une vue d'ensemble : écrans en ligne, disponibilité, nombre et durée des diffusions, médias et campagnes les plus diffusés ;
• le détail des diffusions par jour, média, module, campagne ou écran ;
• la disponibilité du parc par jour ou par écran ;
• des exports CSV des diffusions, des rapports PDF ou CSV par campagne et de disponibilité ;
• des rapports programmés envoyés par email chaque semaine ou chaque mois.

Les preuves de diffusion sont conservées 400 jours.

8. Équipes et rôles

Rôles

Inviter des utilisateurs

Le propriétaire invite un utilisateur par email en choisissant son rôle et, si besoin, ses groupes d'écrans. L'invité crée son mot de passe depuis le lien reçu. Une invitation peut être renvoyée ou annulée, et un utilisateur désactivé ou retiré à tout moment.

Restriction par groupes d'écrans

Un utilisateur limité à certains groupes ne voit et ne pilote que les écrans de ces groupes, et ses campagnes ne peuvent cibler que ces écrans ou ces groupes.

Double authentification

Activez-la dans les réglages de votre compte : scannez le QR code avec une application d'authentification (Google Authenticator, Microsoft Authenticator, FreeOTP…), puis saisissez le code à 6 chiffres affiché. Le propriétaire peut l'imposer à toute l'organisation : un utilisateur qui ne l'a pas encore activée n'accède alors qu'à son compte, le temps de la configurer.

Authentification unique (SSO)

Le propriétaire peut connecter l'organisation à son fournisseur d'identité OpenID Connect (Microsoft Entra ID, Google Workspace, Okta…) : émetteur, identifiant et secret client, domaines email concernés. Les utilisateurs de ces domaines sont redirigés vers leur fournisseur à la connexion. La création automatique des comptes, avec un rôle par défaut, est possible.

Journal d'audit

Les actions sensibles (droits et utilisateurs, clés, suppressions, appairages, commandes, validation des médias) sont enregistrées avec leur auteur et leur date, filtrables par action, utilisateur et période. Le journal est conservé 400 jours.

9. API et webhooks

Accès à l'API

L'API publique donne accès aux mêmes fonctions que le dashboard. Sa documentation interactive est en ligne : https://api.deckpuls.com/api/v1/docs.

• Adresse de base : https://api.deckpuls.com/api/v1
• Authentification : une clé d'API créée par le propriétaire dans le dashboard, affichée une seule fois, à transmettre dans l'en-tête X-API-Key. Une clé « lecture » a les droits d'un lecteur, une clé « écriture » ceux d'un gestionnaire.
• Format : JSON, dates en UTC au format ISO 8601. Les listes sont paginées (?page=1&page_size=50, 100 au plus).
• Erreurs : {"detail": "message"}, avec les codes HTTP habituels (400, 401, 403, 404, 409, 413, 422, 429 en cas de trop nombreuses requêtes).

Lister les écrans hors ligne :

curl -H "X-API-Key: dpk_votre_cle" \
  "https://api.deckpuls.com/api/v1/screens?status=offline"

Recharger un écran :

curl -X POST -H "X-API-Key: dpk_votre_cle" -H "Content-Type: application/json" \
  -d '{"command": "reload"}' \
  "https://api.deckpuls.com/api/v1/screens/ID_ECRAN/commands"

Gardez vos clés secrètes : ne les placez jamais dans une page web ou une application publique. Supprimez une clé dès qu'elle n'est plus utilisée.

Webhooks

Un webhook envoie un événement (une alerte, par exemple) à l'adresse de votre choix. Créez-le dans le dashboard en choisissant l'adresse et les événements ; son secret n'est affiché qu'à la création. Chaque envoi est une requête POST en JSON :

{"event": "…", "occurred_at": "2026-10-22T08:00:00Z", "org_id": 123, "data": {…}}

L'en-tête X-DeckPuls-Signature: sha256=… contient la signature HMAC-SHA256 du corps brut de la requête, calculée avec le secret. Vérifiez-la avant de traiter l'événement, et répondez rapidement par un code 2xx. En cas d'échec, l'envoi est retenté jusqu'à 6 fois. Le dashboard permet d'envoyer un test et de consulter l'historique des envois.

Vérification en PHP :

$body = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $body, $secret);
if (!hash_equals($expected, $_SERVER['HTTP_X_DECKPULS_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}

Vérification en Python :

import hashlib, hmac

def signature_valide(body: bytes, header: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header or "")

10. Questions fréquentes