Promodo

Extension VS Code de travail et pauses. Installation sans npm : dans Extensions, menu … → Installer à partir de VSIX, choisissez promodo-1.0.1.vsix, puis rechargez VS Code.

Utilisation

Les boutons apparaissent dans la barre d’état de VS Code : Travail, Pause, Arrêt, et une roue de paramètres. Travail démarre une session. Pause suspend la phase actuelle ; Reprise la continue. Pour lancer une vraie pause minutée, cliquez sur le compteur puis choisissez Pause courte ou Pause longue. Arrêt enregistre le temps partiel et remet le compteur et les cycles à zéro. À la fin d’une phase, une sonnerie retentit et la phase suivante est préparée. Par défaut, son démarrage reste manuel. Le menu se trouve aussi dans la palette de commandes : Promodo : Contrôles, ou Cmd+Alt+P / Ctrl+Alt+P.

Configuration

Cliquez sur la roue, ou cherchez Promodo dans les réglages VS Code. Toutes les durées, le nombre de cycles, les démarrages automatiques, les sons par événement, leur volume et style, les notifications, le compteur, l’emplacement, les secondes, la persistance et l’historique sont configurables. Les raccourcis se personnalisent dans les raccourcis clavier de VS Code. Les nouvelles durées s’appliquent à la prochaine phase. Une phase déjà démarrée garde sa durée. Historique : commande Promodo : Historique. Export JSON et effacement avec confirmation disponibles. Les données restent dans le stockage local VS Code ; aucune télémétrie ni requête réseau.

Audio

Trois sons originaux WAV intégrés : bell, soft, digital. Le volume 0–100 est appliqué aux fichiers pour fonctionner également avec SoundPlayer Windows. macOS : afplay intégré. Windows : Windows PowerShell et SoundPlayer. Linux : paplay, aplay ou ffplay requis (un seul suffit). Une notification explique un échec de lecture. Tester le son permet de vérifier la sortie audio, même si les alertes sont désactivées. L’extension fonctionne dans VS Code de bureau, pas vscode.dev. Elle s’exécute sur la machine locale lors des sessions SSH. Pas d’icône dans la barre des tâches Windows ou la barre de menus macOS : les commandes sont dans la barre d’état VS Code. Chaque fenêtre VS Code a son propre chronomètre. Utilisez une seule fenêtre pour éviter les sessions ou écritures d’historique concurrentes. Après rechargement, une session restaurée est suspendue : le temps pendant la fermeture n’est pas compté. Une mise en veille avec VS Code ouvert compte comme du temps écoulé.

Développement

Node.js 20+ pour le développement. Python 3 uniquement pour l’empaquetage local hors ligne. Projet JavaScript sans dépendances npm. Ouvrez ce dossier dans VS Code, appuyez sur F5.

• npm test : tests du moteur de temps.
• npm run check : vérification syntaxique.
• npm run package : génère le VSIX avec l’outil officiel vsce.
• npm run package:offline : génère un VSIX local avec Python, pour installation manuelle. Pour le Marketplace, remplacez publisher par votre identifiant réel, puis utilisez les outils officiels vsce avec votre compte. Le publisher inclus n’est pas une identité vérifiée.

Vérification manuelle

1. Installer le VSIX et vérifier la présence des boutons.
2. Régler travail/pause à 0.1 minute, lancer Travail et vérifier la sonnerie après 6 secondes.
3. Suspendre, attendre, reprendre : le temps reste conservé.
4. Tester les trois sons et plusieurs volumes.
5. Activer les transitions automatiques, vérifier les cycles et la pause longue.
6. Recharger pendant le travail : la session est restaurée suspendue.
7. Consulter, exporter puis effacer l’historique. Les tests automatisés couvrent le moteur. Le son et l’interface doivent être vérifiés sur votre système.