KO
apps/winzik / README.md · commit 6576d6f
# WinZikLe lecteur audio skinnable **WinZik** (dit aussi *Winster*), écrit en Visual Basic 6 sous Windows 98 entre 2000 et 2002(version 0.9.86), recréé en PHP avec JumPHP : une application graphique (`kind: gui`) qui tourne sur le bureau et dansle navigateur. Page : https://jumphp.net/winzik## Ce qui a été repris du code de 2001| 2001 (VB6) | Ici ||---|---|| Form1 : la fenêtre principale (main.bmp) | `src/Gui/MainWindow.php` (mêmes coordonnées, twips / 15) || Form2 : la playlist (mainpl.bmp, 23 lignes) | `src/Gui/PlaylistWindow.php` || Form4 : le mode compact (mainp.bmp) | `src/Gui/CompactWindow.php` || Form5 : la barre de paroles | `src/Gui/LyricsBar.php` || Form7 : le menu du clic droit | `src/Gui/PopupMenu.php`, `Desktop::menuItems()` || Aimantation des fenêtres (nbcot), playlist collée (attachehaut), icône près de l'horloge | `src/Gui/Desktop.php` || Form3 + Form13 + Recherche.cls : ajout de fichiers, recherche récursive | `src/Form/FilesForm.php` || Form6 + GetTitre/PutTitre... : tag ID3v1, 80 genres | `src/Form/TagForm.php`, `src/Model/Id3Tag.php` || Form9 : le viewer de skins, INFO.txt | `src/Form/SkinForm.php`, `src/Model/Skin.php` || Form11 : le joystick | `src/Form/ControlsForm.php` (manette), `Desktop::joystick()` || Form17 : options, rep2 (répertoire des paroles) | `src/Form/OptionsForm.php` || Form20 + Download() : paroles depuis winster.free.fr | `src/Form/LyricsForm.php`, `src/Core/LyricsDownload.php` (via archive.org) || Form14 : mode Lock | `src/Form/LockForm.php`, `src/Scene/LockScene.php` || Form18 : À propos | `src/Scene/AboutScene.php` || Form15/16 : écran de chargement | `src/Scene/SplashScene.php` || Form8 : MediaPlayer | `src/Audio/Player.php` (SDL_mixer ; durée lue dans les en-têtes : `src/Model/AudioInfo.php`) || .LYR, .FLS, WinZik<utilisateur>.cfg | `src/Model/Lyrics.php`, `src/Model/Playlist.php`, `var/winzik.json` || EDT (éditeur de skins, REF.NUN) | `src/Form/SkinEditorForm.php`, `src/Gui/PixelEditor.php`, `src/Model/SkinDocument.php`, `src/Model/SkinParts.php` (un éditeur de pixels intégré remplace Photoshop) || PLUGS (Clavier, LED) et SDK.txt | `src/Form/PluginsForm.php` : Plugins Clavier = les raccourcis, Plugins LED = les voyants Num/Maj/Défil dessinés || (introuvable dans les archives) l'éditeur de paroles | `src/Form/LyricsEditorForm.php` : les lignes « tapées » pendant la lecture || Form17 de WinZik.exe 0.9.85 (winster.free.fr), absente des sources de 2002 | `src/Form/OptionsForm.php` : options d'esthétisme et de fonctionnement, barre des tâches, skin au démarrage || le jingle du premier démarrage (introuvable) | `assets/sfx/winzik.ogg`, refait par `tools/sounds/jingle.sh` (espeak-ng + sox) |Abandonné (n'existe plus) : lecteur de CD audio MCI, priorité du processus, plugins Winsock, navigateur IE intégré(remplacé par un lien vers le site archivé), changement de résolution, fenêtre vidéo.## Ressources- `assets/skins/` : les skins d'origine « Chaine Hifi », « the SKIN », « Skin de base » (installateurs 0.9.85/0.9.86) et « WINZIK » (dossiers EDT), en PNG avec leur INFO.txt ; « Ampli 2000 (façon Winamp) » et « Classique (façon Winamp 2) », dessinés par `tools/skins/ampli2000.py` et `tools/skins/classique.py` (pixels originaux, sans logo ni image d'un autre logiciel).- `assets/music/` : trois morceaux de démonstration composés pour cette version (`winzik.mp3` avec son tag ID3 et ses paroles `winzik.lyr`).- `assets/fonts/` : Lato (OFL) et DejaVu Sans Mono Bold (licence Bitstream Vera, `DejaVu-LICENSE.txt`).## Commandes```bashbin/jumphp test winzik            # 60 tests (modèle + tests qui jouent l'application) + smoke testbin/jumphp run winzik             # la fenêtrebin/jumphp build winzik           # la version navigateurapps/winzik/tools/site/shots.sh   # les images du site (site/images) et assets/thumbnail.pngbin/jumphp export:standalone winzik --linux --windows   # un exécutable complet par système (dist/standalone/)bin/jumphp installer winzik --standalone --linux --windows   # les installateurs (jumphp2installer), WinZik dedans```## Nouveautés de la 0.9.87- **Égaliseur** (touche `E`, clic droit > Egaliseur) : ON / AUTO (réglage gardé par morceau), préampli, 10 bandes, 17 préréglages, courbe.  Seul le préampli agit sur le son : la liaison SDL_mixer de JumPHP n'a pas d'effet (Mix_RegisterEffect) pour filtrer les bandes.- **Marketplace** de skins et de paroles (`https://jumphp.net/api/apps/winzik/shared`) : installer, partager, paroles téléchargées toutes seules.- **Version bureau en vraies fenêtres** (`src/Native/`, voir AGENTS.md) : splash seul, lecteur, playlist, égaliseur, menu, paroles en bas  de l'écran par-dessus la barre des tâches. Vérification réelle : `tools/native/check.sh`.- **Mise à jour automatique** de la version installée : `update.json` signé (ECDSA) dans `installer/`, vérifié avec `config/update.pub`.- Les fenêtres se déplacent aussi en attrapant un bouton (un clic reste un clic).## Publier une nouvelle version1. Monter `version` dans `config/project.yaml` et `WinZik::VERSION`.2. `apps/winzik/tools/release.sh "les notes"` : exécutables, `update.json` signé, installateurs, release `v<version>` sur   git.jumphp.net, puis `installer/update.json` commité (les WinZik installés le lisent et se mettent à jour).   La clé de signature est `~/.jumphp/keys/winzik-update.pem` : **à sauvegarder**, sans elle plus aucune mise à jour possible.## Nouveautés de la 0.9.88- **YouTube** (touche `Y`, clic droit) : recherche, puis MP3 dans `Musique/WinZik` ou MP4 dans `Vidéos/WinZik`, ajoutés à la playlist.  yt-dlp et ffmpeg viennent de l'ordinateur ou se téléchargent tout seuls en tâche de fond (`var/bin`), yt-dlp se met à jour chaque semaine.- **Lecteur vidéo** : un MP4 de la playlist s'ouvre dans la fenêtre « WINZIK VIDEO », ses images suivent le son (ffmpeg les prépare).- **Zoom** 150 à 40 % (clic droit > Zoom, Ctrl + molette) ; la **molette** règle le volume, la balance ou la position sous le pointeur.- **Playlist** : ancrée sous le lecteur par défaut, aimant entre toutes les fenêtres, redimensionnable par ses deux points du bas.- **Charger** (touche `L` ou `+`) : la fenêtre de fichiers du système (des fichiers, un dossier entier, plusieurs dossiers). Paroles : touche `K`.- **Paroles en plein écran** (2e bouton de la barre, Échap pour revenir), comme le `Command2` de 2001.- **Version bureau** : réduire dans la zone de notification, mini barre posée sur la barre de titre de la fenêtre active, « Toujours  au-dessus », curseur de déplacement, animations de déroulement, fermeture propre (une fenêtre fermée par le système).- **5 nouveaux skins** (aussi sur la marketplace) : Néon 84, Bois & Laiton, Givre, Phosphore, Carbone (`tools/skins/*.py`).- Splash fidèle à 2001 : l'image seule, sans cadre (son cadre était « transparent » : BitBlt SRCAND du bureau).## Nouveautés de la 0.9.89- **Visualiseur** (partie ouverte du lecteur, ouverte par défaut) : le vrai spectre du son (FFT des échantillons décodés par  ffmpeg), une barre par bande, les sommets qui retombent. Son emplacement : `VIS.txt` du skin (`x y w h`).- **Égaliseur réel** : ffmpeg rend le morceau à travers les 10 bandes et le préampli, le lecteur bascule dessus sans couper.- **Paroles par Whisper** (clic droit > Menu > Créer les paroles) : faster-whisper (installé par WinZik la première fois,  quelques secondes par morceau) ou whisper.cpp, puis corrigées par Claude Code (`claude -p`) s'il est installé ; un .LYR.- **Vidéo** : démarrage rapide (son en WAV, préparé dès le téléchargement), habillée par le skin, double clic = plein écran  avec barre d'avancement (Échap pour revenir).- **YouTube** : file de téléchargements avec une barre par morceau et le total ; yt-dlp de WinZik toujours le plus récent  (mis à jour à chaque démarrage puis chaque jour) ; la recherche ne reste plus bloquée.- **Bureau** : une seule instance (la deuxième réveille la première), menu au-dessus des fenêtres, mini barre toujours  au-dessus et décalable (Options), toutes les fenêtres reviennent ensemble, deux fois moins de processeur (pas de vsync par  fenêtre, 30 images par seconde, fenêtre du moteur réduite).- **Skins** : Givre par défaut, badges nets (MP3, WAV, MID, CD, VID : `tools/skins/badges.py`), petits textes en police  pixel (`tools/skins/pixelfont.py`).## Nouveautés de la 0.9.90- **Paroles synchronisées de LRCLIB** (lrclib.net, base libre) : cherchées toutes seules pour chaque morceau qui n'en a pas  (après la marketplace), ou par clic droit > Menu > Paroles synchronisées ; le LRC devient un .LYR. Marche aussi dans le navigateur.- **Égaliseur habillé par le skin** (bande de titre, couleurs, curseurs, bouton fermer), comme la fenêtre vidéo.- Une vidéo lancée avant que ffmpeg soit prêt attend au lieu d'être déclarée illisible.- Marketplace : les 8 skins remplacés par leurs versions avec visualiseur et badges nets (mêmes identifiants).## 0.9.91- Les vidéos préparées par la 0.9.88 (son en MP3) se rejouent : leur son est refait en WAV, leurs images gardées.- Paroles en plein écran : le bouton de la barre a ses flèches dans le bon sens (▲ dérouler, ▼ replier), la barre ne fuit plus  le pointeur près de ses boutons ; aussi la touche `F` et clic droit > Menu > Paroles en plein écran.- Bureau : **une seule application** pour le système (le lecteur dans la barre des tâches ; playlist, égaliseur, vidéo,  mini barre et paroles en fenêtres outils de WinZik, sans entrée à elles ; le menu en vrai menu surgissant), l'icône de  WinZik sur toutes ; les **paroles toujours au-dessus**.## Nouveautés de la 0.9.92- **Mise à jour pendant le splash** : la version installée cherche sa mise à jour au démarrage, la télécharge (avec sa progression) et  redémarre aussitôt sur la nouvelle.- **Playlist** : « Artiste - Titre » (tags) et durée à droite par défaut, chemin complet en option (mini boutons TAGS / CHEMIN du pied),  largeur réglable (points du bas), ordre changé par glisser-déposer, attachée au lecteur par défaut, badge VID qui ouvre la vidéo.- **Recherche** : YouTube, YouTube Music, SoundCloud, Dailymotion, Bilibili, Niconico, Google Vidéos, Deezer (le son vient de YouTube),  liens Spotify / Deezer ; par pages ; Entrée cherche, Entrée dans les résultats télécharge ; indicateurs de chargement.- **Paroles** : bouton « + » de la barre (Whisper + Claude, Internet par Claude, LRCLIB, marketplace, éditeur) ; Claude Code trouve sur  Internet où sont les paroles synchronisées (LRCLIB, .lrc), WinZik les prend à la source ; Whisper et Internet dans l'éditeur.- **Tags ID3v2** (titre, artiste, commentaire long des MP3 de YouTube) ; un tag modifié dans WinZik reste prioritaire.- **Bureau** : icône toujours dans la zone de notification, démarrage avec l'ordinateur (sans lancer la musique), dialogues à leur  taille, menu et sous-menu sans fond gris, menus fermés par Alt+Tab, toutes les fenêtres au premier plan ensemble, une seule  application dans la barre des tâches, paroles toujours au-dessus, décalage de la mini barre réglé en direct.## Nouveautés de la 0.9.93- **Clics fiables** : la version bureau lit chaque évènement de la souris dans son ordre (moteur 0.5.84, `mouse-event`) au lieu de  l'état de la souris à chaque image ; plus de clic perdu. Curseur « main » sur les boutons.- **Fenêtres** : la playlist attachée au lecteur déplace l'ensemble quand on la tire (le menu « Playlist attachée au lecteur » la  détache) ; l'aimant agit aussi quand on la redimensionne (bords du lecteur, des autres fenêtres, de l'écran).- **Playlist** : fiche au survol (2 s immobile sur une ligne : pochette ID3 ou Deezer, artiste, album, date de sortie, genre, durée,  débit ; elle part dès que la souris bouge) ; bouton DOSSIERS : la liste rangée par artiste puis album, dépliable ; les gros  dossiers sont lus par petits morceaux (WinZik ne fige plus).- **Visualiseur** : un clic change de mode (barres, feu, sinusoïde, cascade, miroir, pluie).- **Volume** : un clic sur l'étiquette Volume passe au volume du système (pactl / amixer, Windows) et revient ; le curseur bleu  signale le volume du système.- **Paroles** : boutons -0.5s / +0.5s sur la barre (le fichier de paroles est enregistré décalé) ; avec plusieurs écrans, un  bouton montre la barre sur tous les écrans ; elle suit l'écran du lecteur et couvre la barre des tâches.- **Spotify / Deezer** : un lien de titre, d'album ou de playlist (pages publiques) ajoute ses morceaux, pris sur YouTube ; la  recherche Spotify demande vos propres identifiants (gratuits, developer.spotify.com), dans les Options.- Démarrage : une seule instance (plus de double démarrage), zoom 80 % au premier lancement, Hasard actif par défaut, plusieurs  écrans gérés.## Nouveautés de la 0.9.94- **Clics** : le premier clic sur WinZik venant d'un autre programme n'est plus perdu (SDL jetait sous X11 le clic qui donne le  focus : `SDL_MOUSE_FOCUS_CLICKTHROUGH`, aussi dans le moteur 0.5.85) ; plus de faux double clic. Mesuré sous Xfce (xfwm4) :  14 clics sur 14 au lieu de 0 à 3. `WINZIK_TRACE=1` écrit la durée des images et chaque clic sur la sortie d'erreur.- **Playlist attachée** : toujours collée sous le lecteur (x et y suivis à chaque image) ; seul le menu la détache.- **Processus auxiliaires** (`src/Work/`, repris du pool de l'IDE de JumPHP) : d'autres processus PHP lisent les tags, durées et  pochettes ; l'interface ne les attend plus. L'exécutable installé se relance lui-même pour eux (`JUMPHP_WORKER_SCRIPT`).## Nouveautés de la 0.9.95- La mise à jour au démarrage montre sa progression (elle restait à 0 % : l'exécutable n'a pas curl). `FileDownload` passe par  une socket PHP non bloquante (TLS, redirections) : les téléchargements de yt-dlp, ffmpeg et Whisper marchent aussi dans la  version installée. La progression se voit à partir de la mise à jour suivante (c'est la version installée qui télécharge).## Nouveautés de la 0.9.96- **Écrans** : sous X11 les écrans viennent de xrandr (ce que chaque écran montre) ; SDL donnait la taille de la dalle d'un écran  mis à l'échelle (2560x1600 pour 1707x1067 affichés), et WinZik débordait. Ils sont relus toutes les 3 s (portable branché ou  non). Sous Windows, le zoom (125 %, 150 %...) est déjà dans les tailles que SDL donne.- **Chaque fenêtre entière dans son écran**, à chaque image : le lecteur et sa playlist en un bloc (la playlist raccourcit s'il  est trop haut), jamais à cheval sur deux écrans ; une fenêtre ramenée se met à côté du lecteur, pas dessus.- **Splash** : ~40 % de la largeur de l'écran de la souris, centré dessus.- **Options** : « Réinitialiser les options et redémarrer » (deux clics) efface la configuration (winzik.json, options du moteur)  et relance WinZik ; les paroles et outils téléchargés restent.- Essais : `WINZIK_SCREENS="x,y,w,h;..."` impose les écrans (Xvfb n'en a pas de vrais).## Nouveautés de la 0.9.97- **Redémarrage après une mise à jour, tout seul** : le nouveau WinZik héritait du descripteur verrouillé de l'ancien  (var/winzik.lock), attendait son propre verrou, puis s'arrêtait (« fenêtre pas dessinée, puis plus rien »).  `App\Core\Relaunch` attend la fin de l'ancien avant de lancer le nouveau ; le verrou porte le pid de son WinZik, et un verrou  tenu alors que ce WinZik est terminé (hérité par le nouveau, ffmpeg, un processus auxiliaire) est repris. Tests réels :  `tests/RelaunchTest.php` (l'ancienne façon reste bloquée, la nouvelle démarre). Essai : `WINZIK_RESTART_AFTER=N`.- **La musique de la dernière fois attend la mise à jour** : elle ne démarre qu'une fois connu qu'aucune mise à jour n'arrive ;  jamais si une mise à jour s'installe ; un clic de l'utilisateur (lecture, pause, stop...) annule cette reprise.## Nouveautés de la 0.10.0 (moteur 0.5.86)- **Icône de la zone de notification toujours visible** : certains panneaux Xfce n'ont plus l'ancienne zone ; l'icône classique y  restait accrochée à rien. Après 3 s sans être prise, elle devient un AppIndicator (moteur `SystemTray`).- **Plus de fenêtre vide** : la fenêtre du moteur naît cachée (`window_hidden`) ; un second WinZik qui s'arrête ne montre rien.- **Relancer WinZik** le ramène au premier plan, hors de la zone de notification / mini barre, sur l'écran de la souris.- **Souris** : la remontée de toutes les fenêtres à l'activation n'a plus lieu sur un clic (elle volait le focus pendant  l'appui : SDL lâchait la souris d'un glisser rapide) ; un redimensionnement suit la souris 20 fois par seconde.- **Netteté** : l'échelle tombe sur des demis (zoom 50, 75, 100, 125, 150, 200 %), images et textes posés au pixel entier,  les images x1,5 / x2,5 agrandies x3 / x5 puis exactement divisées par deux.- **Options** : deux colonnes, molettes sans fin pour la mini barre (appuyer et glisser : elle bouge tout de suite), bouton  « Obtenir mes identifiants… » pour Spotify ; « Réinitialiser les options et redémarrer ».- **Paroles** : menu « + » sous la barre quand elle est en haut, la barre redescend quand on repasse dessus ; en plein écran  la balle karaoké saute de syllabe en syllabe (`App\Model\Karaoke` : syllabes du français, temps de la ligne partagé, LRC  enrichi `<mm:ss.xx>` utilisé tel quel) ; K change l'animation (balle, étoile, note, soulignement, aucune).- **Point rouge** entre volume et balance : il bat sur les basses (40-160 Hz), seuil appris pour chaque morceau.- A propos en plein écran système (la barre des tâches dessous) ; bandeau « LISTE DE LECTURE » jamais étiré ; champs d'une  ligne qui ne débordent plus (éditeur de tags), listes déroulantes à la largeur de leurs éléments.## Nouveautés de la 0.10.1 (moteur 0.5.87)- **Icône** : un indicateur D-Bus (StatusNotifierItem) sans menu (`SystemTray ownMenu`) ; clic ou double clic = WinZik ;  clic droit = le menu de WinZik au point cliqué (vers la gauche près du bord droit, vers le haut en bas), avec « Afficher les  paroles (barre en bas) » et « Paroles en plein écran » (WinZik rangé : les paroles seules). Ce menu se ferme seul si la souris  n'y vient pas en 4 s.- **Paroles plein écran** : l'heure à gauche de K / taille / Q, les lignes défilent en douceur, la balle compte ~0,3 s par  syllabe (sans s'étirer sur une pause), Échap sort du plein écran (les touches arrivent au bureau dans la version bureau).- **Mini barre** : la dernière fenêtre active d'un autre programme est toujours suivie : elle s'y pose dès le clic ; elle est  hors du gestionnaire de fenêtres (toujours au-dessus) ; la molette de la souris règle ses molettes (Maj : par 10).- **Menus** de WinZik ouverts du bon côté de leur écran ; guide Spotify sélectionnable (redirect `http://127.0.0.1:8888/callback`)  avec boutons pour ouvrir le site et copier l'adresse.