apps/winzik
/ BRIEF.md · commit 6576d6f
# WinZikRecréer en application JumPHP (PHP) le lecteur audio WinZik / Winster que l'auteur (David NURDIN) a écrit en Visual Basic 6 en 2000-2002 (v0.9.86), à partir de son code source complet relu en entier. Fonctions d'origine à reproduire :- Fenêtre principale skinnée 258x128 (main.bmp du skin « Chaine Hifi ») : titre défilant (« --- artiste --- titre --- »), compteur heures/minutes/secondes, kbps, barre de position cliquable/glissable, curseurs volume (0-100 %) et balance (-100..+100 %), boutons précédent / play / pause / stop / suivant, playlist, paroles, hasard (shuffle), compact, fermer, info (tags), réduire.- Playlist (mainpl.bmp) : 23 lignes visibles, ascenseur skinné, icônes de type (mp3/wav/mid/cd) et indicateur « paroles disponibles », morceau actif en couleur, molette, double clic pour jouer, boutons + (ajouter des fichiers), - , supprimer la sélection (mode édition), sauver/charger une liste .FLS ([FLS] puis une ligne par fichier), passage auto au suivant en fin de morceau, hasard.- Ajout de fichiers : un navigateur de dossiers/fichiers + « ajouter le répertoire » avec option sous-répertoires (recherche récursive avec compteurs MP3/WAV/MID).- Paroles synchronisées : format .LYR ([LYR] puis alternance « [ secondes ] » / ligne de texte), cherchées à côté du fichier puis dans un répertoire secondaire de paroles ; fenêtre bandeau de paroles en bas d'écran qui suit la position ; téléchargement des paroles sur le net (l'ancien site winster.free.fr/LYR/<ARTISTE>/<ARTISTE> - <TITRE>.LYR).- Éditeur de tags ID3v1 (titre, artiste, album, commentaire, année, genre parmi les 80 genres) avec écriture dans le fichier.- Choix de skin (dossiers avec INFO.txt [INF], nom, couleurs du texte, compteur, bargraphes, couleur active et 23 couleurs de lignes de playlist).- Mode compact (petite barre 112x12 mainp.bmp avec 7 boutons + titre défilant).- Mode Lock : écran noir plein écran protégé par mot de passe, titre défilant et paroles qui traversent l'écran.- Configuration des touches/manette : associer chaque bouton/axe à une action (son +/-, suivant, précédent, hasard, play/pause, paroles, compact, balance +/-).- Écran « À propos » : lettres W-i-n-Z-i-K tirées au hasard qui se figent, puis générique défilant (crédits d'origine).- Sauvegarde de la configuration (position, volume, balance, playlist, morceau actif, hasard, skin, répertoire des paroles) au lieu du WinZik<utilisateur>.cfg.Les éléments liés à Windows (lecteur de CD audio MCI, priorité processus, icône de la barre des tâches, plugins Winsock, navigateur IE intégré, changement de résolution) sont adaptés ou remplacés par l'équivalent moderne. Les graphismes du skin d'origine (BMP/GIF de l'auteur) et les paroles .LYR d'origine sont réutilisés.## An application with windows and forms (JumPHP\Gui)This project is an **application**, not a game: windows with buttons, lists, fields, drawn by PHP (no HTML),the same on the desktop, in the browser and on phones. Follow `AGENTS.md` section 17 and `docs/gui.md`; example:`games/hello-gui`. A window = `forms/<Name>.form.yaml` (its widgets: what the JumPHP IDE's visual editor writes) +`src/Form/<Name>.php` (its code). Test each feature as you write it (`GameTestCase`: click, type, check what theform shows), check the screens with `bin/jumphp shot winzik`.---## The JumPHP playgroundThis project was made on the JumPHP playground: the application's page is https://jumphp.net/winzik (in its "Applications").- The application is `apps/winzik/`. Read `AGENTS.md` (the JumPHP contract) first; replace the skeleton with the application described above; tests for each feature, as you write them; screenshots you look at.- **Publishing**: every push to `main` is online within a minute (Git webhook). The MCP tool `sync_project` (server `jumphp`) publishes at once and returns the errors.- **Its home page**: `apps/winzik/site/` (AGENTS.md section 13, with the application's real screenshots) and `apps/winzik/assets/thumbnail.png`.- When it is done: MCP `update_project` with `listed: true` shows it in the playground's applications.