Skip to content

Repository files navigation

SidWizPlus — portage macOS (CLI uniquement)

Portage macOS, en ligne de commande uniquement, de SidWizPlus de mon ami Maxim de SMS Power, lui-même basé sur SidWiz.

L'outil rend une vidéo d'oscilloscope à partir d'un fichier VGM/VGZ : chaque canal de la puce sonore est isolé, tracé sur sa propre courbe, et le tout est encodé en MP4 avec la musique.

Capture d’écran 2026-08-30 à 11 18 18

Installation

unzip SidWizPlus-macOS-CLI-v1.0-source.zip
cd SidWizPlus-macOS-CLI
chmod +x install-dependencies-macos.sh build-macos.sh
./install-dependencies-macos.sh
./build-macos.sh

install-dependencies-macos.sh installe CMake, FFmpeg (full, avec x/h264) et le SDK .NET via Homebrew. build-macos.sh compile le séparateur VGM natif puis le moteur vidéo C#, et dépose le binaire dans dist/sidwizplus.

Utilisation

Un seul morceau :

dist/sidwizplus --vgm musique.vgm --background fond.png -o video.mp4

Un album complet, avec une image et un titre par morceau :

dist/sidwizplus --playlist album.txt --fade-ms 0 --crossfade 3 --fade-in 2 --fade-out 5 -o album.mp4

Cette commande génère album.mp4, et à côté album.chapters.txt contenant l'horodatage et le titre de chaque morceau, prêt à coller dans la description d'une vidéo YouTube.

dist/sidwizplus --help pour le détail des options.

Le fichier playlist

Une entrée par ligne, au format vgm | image | titre. L'image et le titre sont facultatifs, # commente une ligne, et les chemins sont relatifs au fichier playlist. Dans le titre, \n produit un retour à la ligne.

# album.txt
act1.vgm | act1.png | YOKAI – Act 1\nSega Master System – SN76489
act2.vgm | act2.png | YOKAI – Act 2\nSega Master System – SN76489
boss.vgm | boss.png | YOKAI – Boss\nSega Master System – SN76489

Les morceaux sont rendus séparément puis assemblés en une seule vidéo, avec un fondu enchaîné sur l'image et sur le son à chaque transition.

Quelques options utiles

Option Effet
--crossfade N durée du fondu enchaîné entre morceaux, en secondes
--fade-in N ouverture depuis le noir, image seule
--fade-out N fermeture vers le noir, image et musique
--fade-ms N fondu de fin de boucle du séparateur VGM, à mettre à 0 avec --crossfade
--title TEXTE remplace le bandeau lu dans le tag GD3
--width, --height, --fps format de sortie, 1280×720 à 60 i/s par défaut
--columns N nombre de colonnes de courbes
--keep-wavs conserve les WAV séparés au lieu de les supprimer

Le titre de chapitre retenu est la première ligne de --title, ou du champ titre de la playlist. YouTube n'affiche les chapitres qu'à partir de trois entrées espacées d'au moins dix secondes ; le programme prévient si ce n'est pas le cas.

Licences

Le moteur vidéo C# est un port de SidWizPlus, sous licence MIT. tools/vgmsplit-cli dérive de qvgmsplit, sous licence GPL-3.0, et embarque libvgm avec ses propres licences. Il reste un programme séparé, appelé par SidWizPlus via un processus externe.

Voir NOTICE.md et le dossier licenses/.

About

Portage macos de SidWizPlus

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages