SilentWeb — Documentation

Aperçu rapide

SilentWeb est une extension Firefox/Chrome open-source qui affiche des sous-titres enrichis, génère des transcriptions locales et déclenche des alertes visuelles. Tout le traitement reste sur votre machine pour préserver la vie privée et fonctionner hors ligne.

Dépôt GitHub
Code source, issues et releases. Releases
Paquets zip prêts à charger. Roadmap & Vision
Priorités, jalons et ambitions. Locales
Statut des traductions et priorités. Licence MIT
Conditions d’utilisation du projet.

Installer SilentWeb

Prérequis

Firefox 109+ ou Chrome 114+ pour charger l’extension.
Pour construire depuis la source : Node.js ≥ 20 et pnpm ≥ 9.

Depuis une release (utilisateur)

Téléchargez silentweb-*.zip depuis la page Releases.
Décompressez le fichier pour obtenir le dossier SilentWeb.
Firefox : about:debugging#/runtime/this-firefox → Charger un module complémentaire temporaire → sélectionnez manifest.json.
Chrome/Edge : chrome://extensions → activer le mode développeur → Charger l’extension non empaquetée → dossier SilentWeb.

Depuis la source (contribution)

git clone https://github.com/OpenDeafTech/SilentWeb.git
cd SilentWeb
pnpm install
pnpm run build

Le dossier dist/ contient le bundle MV3 à charger via about:debugging ou chrome://extensions.

Utiliser en 30 secondes

Ouvrez une page avec audio/vidéo ou visioconférence.
Cliquez sur l’icône SilentWeb pour afficher l’overlay.
Appuyez sur Activer les sous-titres pour lancer la transcription en direct.
Masquez/affichez l’overlay avec Toggle overlay.
Si rien ne s’affiche, vérifiez le volume du site ou l’onglet actif.

Tutoriel complet (10 minutes)

1. Préparer l’ordi (1 min)

Installez ou mettez à jour Firefox (109+) ou Chrome (114+).
Option développeur activée sur la page des extensions.

2. Installer l’extension (3 min)

Téléchargez silentweb-*.zip sur la page Releases et décompressez.
Firefox : about:debugging#/runtime/this-firefox → Charger un module complémentaire temporaire → choisir manifest.json.
Chrome/Edge : chrome://extensions → mode développeur → Charger l’extension non empaquetée → dossier SilentWeb.

3. Première utilisation (2 min)

Ouvrez YouTube, un stream ou une visio.
Cliquez sur l’icône SilentWeb pour faire apparaître la barre sombre en haut.
Cliquez sur Activer les sous-titres et lisez le texte qui s’affiche en temps réel.

4. Ajuster l’affichage (2 min)

Dans les options, choisissez le thème, la taille et la couleur des sous-titres.
Utilisez Toggle overlay pour masquer la barre sans couper la capture.
Définissez un raccourci clavier si vous changez souvent d’onglet.

5. Activer les alertes (1 min)

Ajoutez des mots-clés (ex. « alarme », « meeting »). SilentWeb affichera une alerte visuelle quand ils sont détectés.
Réglez le niveau de volume déclencheur si vous surveillez des notifications sonores.

6. Dépanner vite (1 min)

Rien ne s’affiche ? Vérifiez que l’onglet joue de l’audio et que le son n’est pas coupé.
Overlay bloqué ? Rechargez la page (Ctrl/Cmd + R).
Encore un souci ? Ouvrez une issue avec la page concernée et les étapes.

Fonctionnalités principales

Transcription locale en temps réel (audio + OCR selon le contexte).
Sous-titres enrichis : thèmes, tailles et couleurs configurables.
Alertes visuelles déclenchées par mots-clés, volume ou événements réseau.
Panneau d’options pour profils, langues, raccourcis et apparence.
Localisation multi-langues via _locales/ et scripts d’automatisation.

Régler l’overlay et les sous-titres

Affichage

Choisissez thème clair/sombre, couleur du texte et arrière-plan.
Ajustez la taille des sous-titres et l’espacement entre les lignes.
Positionnez l’overlay en haut ou en bas et réglez son opacité.

Comportement

Activer ou non l’auto-démarrage des sous-titres sur chaque nouvel onglet.
Limiter la longueur des sous-titres ou le débit pour préserver la lisibilité.
Nettoyer ponctuation et espaces via la normalisation intégrée.

Audio & OCR

Choisir la langue par défaut pour la transcription.
Désactiver l’OCR si vous ne l’utilisez pas pour économiser des ressources.
Adapter la sensibilité de détection de voix ou de sons forts.

Raccourcis et commandes rapides

Définissez un raccourci clavier pour afficher/masquer l’overlay (ex. Ctrl/Cmd + Maj + S).
Créez un second raccourci pour lancer ou arrêter la transcription en un geste.
Depuis la barre d’options, le bouton « Reset » vide l’écran et réinitialise l’overlay.
Les paramètres et raccourcis sont stockés localement et persistent après redémarrage.

Vie privée et performances

Traitement local uniquement : SilentWeb ne transmet pas l’audio ni les transcriptions vers un serveur.
Permissions limitées : accès aux onglets où l’extension est active et aux APIs requises par le manifest MV3.
Performances : transcription temps réel. Fermez les onglets très lourds si vous observez un ralentissement.
Optimisation : désactivez l’OCR et réduisez la fréquence d’échantillonnage dans les options pour les machines modestes.
Cache local : réglages et profils sont stockés dans le navigateur et peuvent être réinitialisés depuis la page d’options.

Contribuer et tester

Commencez par lire le guide Contributing pour le style, la revue et le flux de travail.

Qualité locale

pnpm run lint
pnpm test (Vitest)
pnpm run test:e2e (Playwright)

Locales

pnpm run validate:locales
pnpm run locales:pipeline → CSV à traduire
pnpm run locales:update

Packaging

pnpm run release pour build + QA + artefact web-ext
Sortie dans web-ext-artifacts/

Signalez les bugs via une issue GitHub avec étapes de reproduction et logs.

Traduire

Consultez le Translation Playbook pour le ton et les tests.
Priorisez les langues via le Tableau des locales.
Pipeline : pnpm run locales:pipeline → traduire le CSV → pnpm run locales:lint → pnpm run locales:update.

Architecture et design

Architecture
Modules, flux de données et choix techniques. Arborescence
Organisation du dépôt et repères clés. Design UI
Intentions d’interface et règles d’accessibilité.

Sécurité et qualité

Pratiques et modèles dans security-templates.md.
Tests automatisés : Vitest (unité), Playwright (E2E), audits locaux via pnpm audit --prod.
CI locale : pnpm run ci:test pour lancer validations locales + couverture.

Support et diagnostic

Décrivez la page visitée, le navigateur, la version SilentWeb et les étapes exactes de reproduction.
Capturez la console (F12 → Console) et joignez les messages d’erreur.
Testez dans une fenêtre privée pour écarter les conflits d’autres extensions.
En cas de crash du service worker, désactiver/réactiver l’extension ou recharger l’onglet suffit souvent.
Ouvrez une issue GitHub ou commentez une PR pour discuter d’un correctif.

Ressources annexes

Guides : Guide très simple (pas-à-pas non technique) et Getting started (profil dev).
Organisation : Roadmap et Vision.
Licence : SilentWeb est distribué sous licence MIT.

Questions fréquentes

Puis-je utiliser SilentWeb sur d’autres navigateurs ?: Oui. Support officiel Firefox (109+) et Chrome (114+) avec le même bundle MV3 (dist/).
Les données audio quittent-elles mon ordinateur ?: Non. Le traitement est exécuté côté client. SilentWeb ne transmet pas d’audio ou de transcription à un serveur tiers.
Comment signaler un bug ?: Ouvrez une issue GitHub avec les étapes de reproduction, les logs de la console et votre version du navigateur.
Pourquoi la transcription est lente ?: Fermez les onglets gourmands, réduisez la fréquence d’échantillonnage audio, désactivez l’OCR, puis relancez l’overlay.
Les sous-titres se chevauchent avec la vidéo.: Déplacez l’overlay (haut/bas) et ajustez l’opacité dans les réglages d’affichage.
Mes raccourcis ne fonctionnent pas.: Vérifiez qu’aucune autre extension n’utilise les mêmes touches et reconfigurez-les dans la page d’options.
Où sont stockées mes données ?: Les préférences et profils restent dans le stockage local du navigateur. Aucune donnée n’est envoyée en ligne.