winzik/apps/winzik/README.md
David Nurdin 2f29be62b0 WinZik README: 0.10.1
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 20:48:10 +01:00

19 KiB

WinZik

Le 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 dans le 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.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

bin/jumphp test winzik            # 60 tests (modèle + tests qui jouent l'application) + smoke test
bin/jumphp run winzik             # la fenêtre
bin/jumphp build winzik           # la version navigateur
apps/winzik/tools/site/shots.sh   # les images du site (site/images) et assets/thumbnail.png
bin/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 version

  1. 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.