Documentation

Raccorder une caméra ou un dossier à Noviscan

Pour qui : la personne qui administre Noviscan et veut lui donner des images à surveiller. Suppose acquis : Noviscan est installé et vous y êtes connecté avec un compte administrateur. Vaut à partir de la version : 0.1.3

Cette page vous mène de l'écran vide jusqu'à une source qui alimente Noviscan en images. Elle couvre les caméras du catalogue et les autres types de source (dossier local, SFTP, FTP, flux RTSP générique).

Avant de commencer

Trois conditions sont vérifiées par le logiciel lui-même. Si l'une manque, il vous le dira — mais autant le savoir avant :

  • Vous êtes administrateur. Le bouton Ajouter une source n'apparaît pas aux autres comptes, et le serveur refuse l'ajout même si la demande lui parvient autrement.
  • Votre licence n'a pas atteint son plafond de sources. Au-delà, l'ajout est refusé au moment de l'enregistrement, pas au moment de la saisie.
  • L'accès Internet est activé si votre caméra passe par un service en ligne (Ezviz, Google Nest). Sans lui, ces types restent grisés dans la liste, avec la mention « Certains types de source sont grisés : ils ont besoin d'un accès Internet, actuellement désactivé. » Les sources purement locales — dossier, SFTP, FTP, RTSP — n'en ont pas besoin.

Rassemblez aussi ce qui dépend de votre matériel : l'adresse IP locale de la caméra, ses identifiants, et le chemin de flux propre au modèle. Le guide du catalogue vous les nomme un par un quand votre modèle y figure.

Ajouter une caméra du catalogue

C'est le chemin le plus court, et le seul qui vous évite de chercher le chemin de flux de votre modèle.

  1. Dans la barre latérale, cliquez Sources — la page qui s'ouvre s'intitule Sources et maintenance. Puis Ajouter une source.
  2. Le catalogue s'ouvre sur Choisir une caméra. Tapez votre marque, votre modèle ou votre fournisseur dans le champ de recherche.
  3. Chaque vignette porte un état : Prise en charge, Flux local ou Non intégrable. Une vignette Non intégrable affiche pourquoi et ne se sélectionne pas.
  4. Choisissez votre modèle. Le formulaire s'ouvre pré-rempli avec ce que le catalogue connaît du modèle : type de source, port et chemin de flux.
  5. Si votre modèle a un Guide de configuration, il est replié en haut du formulaire. Dépliez-le : il donne Avant de commencer, Étapes et En cas de problème pour ce modèle précis, et la date à laquelle ses sources ont été vérifiées.
  6. Complétez ce que le catalogue ne peut pas deviner — l'adresse IP de votre caméra, son identifiant et son mot de passe.

Tous les modèles du catalogue n'ont pas de guide. Quand il manque, le formulaire reste pré-rempli : ce sont les valeurs par défaut du modèle qui vous font gagner le plus de temps, pas le guide.

Ajouter un autre type de source

En bas du catalogue, Autre type de source ouvre le même formulaire sans pré-remplissage. Choisissez alors le Type de source :

Type Ce qu'il lit Ce qu'il faut fournir
Dossier local des fichiers déjà sur cette machine le chemin du dossier
SFTP / FTP des fichiers sur un autre serveur l'hôte, les identifiants, le chemin distant
Caméra IP (RTSP) un flux vidéo en direct l'adresse de la caméra et le chemin du flux
Caméra Freebox (flux live) le flux live d'une caméra Freebox l'adresse IP de la caméra
Freebox — enregistrements caméra les enregistrements de la Freebox l'adresse de la Freebox
Caméra Ezviz (clips cloud) les clips du cloud Ezviz le numéro de série et le compte Ezviz
Caméra Google Nest (SDM) les événements Nest un projet Device Access et ses identifiants OAuth (voir ci-dessous)

Ce qu'est un « projet Device Access », pour les seules caméras Nest. Google n'ouvre pas ses caméras à un logiciel tiers sans que vous l'y autorisiez nommément : il faut créer chez lui un projet qui vous désigne comme propriétaire des caméras, puis y déclarer Noviscan. Cela se fait une fois, chez Google, sur sa console Device Access ; vous en ressortez avec les valeurs que le formulaire vous demandera, et aucune ne se devine :

Champ du formulaire D'où il vient
ID du projet Device Access la console Device Access, à la création du projet
ID client OAuth les identifiants OAuth déclarés pour ce projet
Secret client OAuth affiché une seule fois à la création du client — notez-le
Abonnement Pub/Sub l'abonnement aux événements créé pour ce projet
URI de redirection OAuth déjà rempli, ne le changez que si Google vous l'impose

Sans ce projet, cette source ne peut pas être ajoutée : commencez par là. Si un de ces champs manque, Noviscan vous le dira au moment de l'autorisation plutôt qu'à l'enregistrement.

Pour une caméra IP (RTSP), deux champs sont obligatoires : l'adresse IP / hôte et le chemin du flux, qui dépend du modèle. Le port RTSP vaut 554 par défaut. Vous ne saisissez jamais l'URL complète : Noviscan l'assemble à partir de ces champs.

Laissez le transport sur TCP (fiable, recommandé) tant que rien ne vous oblige à en changer.

Deux champs qui méritent une phrase

  • Alerter si aucun média après (heures) — laissez vide si vous ne savez pas. L'âge du dernier média se lit sur la carte de la source, écran Sources : cliquez la carte pour la déplier (réservé aux comptes administrateur et au-dessus). Vous choisirez ce seuil plus tard, sur des chiffres réels plutôt que sur une estimation.
  • Mots de passe et clés — ils sont chiffrés au repos sur ce poste si le chiffrement est activé (Paramètres → Avancé). Sinon, ils sont stockés en clair dans la configuration locale. Le formulaire vous le rappelle sous chaque champ concerné.

Si Noviscan vous demande de confirmer l'hôte

Pour une source SFTP ou FTP, Noviscan vérifie si l'hôte que vous avez saisi est hors de votre réseau local. Si c'est le cas, un avertissement s'affiche et la case Je confirme vouloir joindre ce serveur distant doit être cochée avant de pouvoir enregistrer. Ce n'est pas une formalité : elle existe pour que personne ne fasse sortir vos données vers un serveur qu'il n'avait pas l'intention de joindre.

Certaines adresses sont refusées quoi qu'il arrive — l'adresse de la machine elle-même, les adresses de service internes des hébergeurs. Le refus vient du serveur, pas du formulaire.

Tester, puis enregistrer

Tester la connexion interroge la source avec ce que vous venez de saisir, sans rien enregistrer. En cas de succès, Noviscan affiche « Connexion réussie. » Le bouton reste inactif tant qu'un champ obligatoire est vide.

Puis Ajouter la source. Noviscan l'analyse aussitôt et la prend en compte sans redémarrage.

⚠️ Une source ajoutée ne produit encore rien. Il reste un geste, et il est sur un autre écran : Tableau de bord → ▶ Démarrer. Tant que la surveillance est arrêtée, la source est enregistrée, joignable, et muette — c'est la cause la plus fréquente d'un « rien ne se passe » après un ajout réussi.

Comment vous savez que c'est fait : aucun message ne s'affiche. Le formulaire se referme et la source apparaît dans la liste. Si son type sait s'appairer, sa carte porte dès cet instant le badge Non authentifiée — c'est là que se lit ce qu'il reste à faire. Si elle demande une autorisation, sa carte s'ouvre d'elle-même sur Authentification de la source — et là, un message vient : « Authentification réussie — la source fonctionnera désormais sans nouvelle validation. »

Pour une source Freebox — enregistrements caméra, il n'y a pas de bouton de test à l'ajout : le bouton s'appelle Ajouter et authentifier, et la Freebox vous demandera de valider sur son écran.

À quoi vous voyez que c'est abouti, côté Noviscan : le bandeau vert « Authentification réussie — la source fonctionnera désormais sans nouvelle validation. » s'affiche, et le seul bouton restant devient Fermer. Ensuite, dans le formulaire de la source, la mention « Authentifiée — jeton d'autorisation enregistré. » remplace le bouton d'authentification.

⚠️ Deux badges distincts sur la carte, et ils ne disent pas la même chose. Connexion OK rend le dernier test réseau et n'apparaît qu'après un Tester ; Authentifiée / Non authentifiée rend l'autorisation enregistrée. Une source peut être joignable — donc verte au voyant — et ne rien rendre faute d'autorisation.

Les caméras qui demandent une autorisation

Pour une caméra Ezviz ou Google Nest, l'enregistrement ne suffit pas : le fournisseur doit vous reconnaître. La carte de la source s'ouvre alors d'elle-même sur Authentification de la source, et Noviscan vous pose les questions que le fournisseur lui transmet — un code reçu par courriel, une validation dans l'application du fabricant.

Répondez, puis Valider. Une fois l'authentification réussie, elle n'est pas redemandée : la source fonctionnera désormais sans nouvelle validation.

En cas de problème

  • Le bouton Ajouter une source n'apparaît pas. Votre compte n'est pas administrateur.
  • Le type de caméra voulu est grisé. Il a besoin d'Internet, actuellement désactivé. Le lien Activer l'accès Internet vous mène au réglage.
  • L'ajout est refusé alors que tout est rempli. Le plafond de sources de votre licence est peut-être atteint.
  • Le test échoue sur une caméra IP. Vérifiez d'abord le chemin du flux : il change d'un modèle à l'autre, et c'est l'erreur la plus courante. Le guide du catalogue donne le chemin exact quand votre modèle y figure.
  • Tout semble bon, mais aucune image n'arrive. Regardez le tableau de bord : s'il affiche Surveillance arrêtée, cliquez sur ▶ Démarrer. La surveillance ne démarre pas d'elle-même — et redémarrer Noviscan n'y change rien.

Vaut pour Noviscan 0.1.3. Les libellés cités sont ceux de l'application dans cette version ; s'ils diffèrent chez vous, votre version n'est pas celle-ci.