DAFT PUNK - patch VCV Rack / Cardinal
==========================================

À garder ensemble, dans ce même dossier (ne pas séparer) :
  - Daft Punk.vcv
  - assets\ (samples + VST)
  - Launch Cardinal.bat                  (Windows)
  - Launch Cardinal (macOS).command
  - Launch Cardinal (Linux).sh
  - ce fichier

COMPATIBILITÉ - CARDINAL OU VCV RACK EN AUTONOME
--------------------------------------------------
Ce patch est conçu et testé pour Cardinal (CardinalNative), la version
autonome de VCV Rack qui embarque sa propre collection de modules et
son propre moteur d'hébergement VST basé sur Carla. Cardinal est la
façon recommandée, et la seule pleinement testée, d'ouvrir ce patch.

Il peut aussi s'ouvrir dans VCV Rack en version autonome si vous
l'avez déjà installé, mais attendez-vous à ce que certains modules
apparaissent comme manquants ou non fonctionnels dans ce cas - en
particulier tout ce que Cardinal embarque en interne plutôt que
d'installer comme un plugin classique de la VCV Library, ou tout ce
qui dépend du moteur Carla intégré à Cardinal (comme les modules
"Ildaeil" utilisés ici). Nous ne pouvons pas garantir une liste exacte
de ce qui serait affecté dans VCV Rack en autonome : si vous essayez
cette voie, considérez-la comme un essai sans garantie plutôt qu'un
usage pleinement supporté.

1) OUVRIR LE PATCH
------------------
De préférence, double-cliquez sur le script de lancement correspondant à
votre système d'exploitation plutôt que sur le fichier .vcv directement :
  - Windows : "Launch Cardinal.bat"
  - macOS   : "Launch Cardinal (macOS).command"
  - Linux   : "Launch Cardinal (Linux).sh"

Le script place le bon dossier de travail avant de lancer Cardinal, ce qui
permet aux chemins relatifs des échantillons de se charger automatiquement
(testé et confirmé sous Windows), et il configure aussi la recherche des
VST (voir point 3).

macOS / Linux uniquement : il peut être nécessaire de rendre le script
exécutable avant de pouvoir double-cliquer dessus. Dans un terminal :
  chmod +x "Launch Cardinal (macOS).command"
ou
  chmod +x "Launch Cardinal (Linux).sh"
(ce droit d'exécution se perd lors du partage depuis une machine Windows).

Si Cardinal s'ouvre sans le patch, ouvrez-le manuellement via
Fichier > Ouvrir (le dossier de travail restera correct malgré tout).

Aucune installation séparée de Carla n'est nécessaire — Cardinal inclut
déjà le moteur d'hébergement de plugins dont il a besoin.

REMARQUE - plugins VST sous macOS / Linux : GMulti et GClip (les 2
plugins VST utilisés par les modules "Ildaeil", voir point 3) sont
fournis pour Windows, macOS et Linux (voir "assets\vst\<votre système>\").
Lorsque vous lancez via le script de lancement fourni, les bons
binaires pour votre système sont trouvés automatiquement et les 2
modules Ildaeil doivent se charger exactement comme sous Windows. Si
vous voyez malgré tout "plugin introuvable", consultez le point 3 pour
les options de configuration manuelle. Le reste du patch, y compris les
5 échantillons du Groovebox, fonctionne également à l'identique sur
tous les systèmes.

2) SI LES 5 ÉCHANTILLONS DU MODULE "GROOVEBOX" NE SE CHARGENT PAS
------------------------------------------------------------------
C'est possible, sans que ce soit une erreur : ce module ne sait pas
retrouver un fichier automatiquement par rapport à l'emplacement du
patch. Il suffit de les recharger une fois, manuellement :

  Pour chacun des 5 emplacements concernés :
  - Double-cliquez sur le nom du fichier affiché sur la piste
    (ou : clic droit sur le nom du fichier > "Load Sample")
  - Naviguez jusqu'au dossier "assets\samples\"
  - Sélectionnez le fichier correspondant :
      808-Kicks09.wav
      808-Snare24.wav
      808-Clap10.wav
      808-HiHats17.wav
      Kick 1.wav

Une fois rechargés, Cardinal se souvient du nouvel emplacement pour les
prochaines ouvertures de ce patch sur cette machine.

3) LES 2 PLUGINS VST (GMulti, GClip - modules "Ildaeil")
-----------------------------------------------------------
Ces 2 plugins sont fournis pour les 3 systèmes :
  - Windows : assets\vst\Windows\  (GMulti.dll, GClip.dll)
  - macOS   : assets\vst\Mac\      (bundles GMulti.vst, GClip.vst)
  - Linux   : assets\vst\Linux\    (GMulti.so, GClip.so)

Vous n'avez rien à télécharger ni à installer séparément : Carla (le
moteur intégré à Cardinal qui héberge ces VST) recherche les plugins
par leur nom de fichier dans certains dossiers connus, et le script de
lancement pointe déjà vers le bon dossier pour votre système.

Si vous lancez via le script de lancement correspondant à votre système
("Launch Cardinal.bat", "Launch Cardinal (macOS).command" ou "Launch
Cardinal (Linux).sh") : rien à faire, le script définit automatiquement
la variable d'environnement VST_PATH sur le dossier
"assets\vst\<système>\" correspondant avant de démarrer Cardinal.

Si vous ouvrez Cardinal autrement (sans passer par le script de
lancement), faites l'une des choses suivantes, selon votre système :

  WINDOWS
    Option A (la plus simple) :
      Copiez les 2 fichiers .dll de "assets\vst\Windows\" vers :
        C:\Program Files\Common Files\VST2\
      (peut nécessiter les droits administrateur)

    Option B (sans droits admin, plus fiable) :
      Définissez vous-même une variable d'environnement VST_PATH
      pointant vers le dossier "assets\vst\Windows\" avant de lancer
      Cardinal.

  macOS
    Option A (la plus simple) :
      Copiez les 2 bundles .vst de "assets/vst/Mac/" vers l'un de ces
      dossiers :
        ~/Library/Audio/Plug-Ins/VST/      (utilisateur courant
                                             uniquement)
      ou
        /Library/Audio/Plug-Ins/VST/       (tous les utilisateurs, peut
                                             nécessiter les droits
                                             administrateur)

    Option B (sans droits admin, plus fiable) :
      Définissez vous-même une variable d'environnement VST_PATH
      pointant vers le dossier "assets/vst/Mac/" avant de lancer
      Cardinal.

  LINUX
    Option A (la plus simple, mais les chemins varient selon la
    distribution) :
      Copiez les 2 fichiers .so de "assets/vst/Linux/" vers l'un de ces
      dossiers :
        ~/.vst/                             (utilisateur courant
                                              uniquement)
      ou
        /usr/lib/lxvst/  ou  /usr/lib/vst/  (tous les utilisateurs,
                                              selon la distribution -
                                              peut nécessiter les
                                              droits root)
      Remarque : contrairement à Windows/macOS, il n'existe pas de
      dossier VST2 standard unique sous Linux ; le chemin système exact
      dépend de votre distribution et de ses conventions de packaging.
      Si l'option A ne fonctionne pas, préférez l'option B ci-dessous.

    Option B (sans droits admin/root, plus fiable) :
      Définissez vous-même une variable d'environnement VST_PATH
      pointant vers le dossier "assets/vst/Linux/" avant de lancer
      Cardinal.

Réinstaller les plugins depuis zéro : ces plugins sont déjà fournis
dans "assets\vst\<votre système>\" - inutile de les retélécharger. Mais
si vous avez un jour besoin de les récupérer indépendamment (par
exemple une version plus récente, ou un système/format différent de
celui fourni ici), ce sont des téléchargements gratuits proposés par
l'éditeur, GVST :
  - GMulti : https://gvst.uk/Downloads/GMulti/Select
  - GClip  : https://gvst.uk/Downloads/GClip/Select
Voir assets\vst\GVSTLicense.txt pour la licence des plugins GVST.

Si Cardinal affiche malgré tout le module Ildaeil comme "plugin
introuvable", rouvrez son navigateur de plugins intégré et
resélectionnez GMulti / GClip manuellement (les réglages sauvegardés
dans le patch seront réappliqués automatiquement une fois le bon
binaire retrouvé).
