﻿Polivoks — émulation du synthétiseur Polivoks : installation et utilisation
===========================================================================

Formats :
- Windows x64 : Polivoks.vst3 (pour votre DAW) et Polivoks.exe (application autonome).
- macOS 10.15 ou ultérieur, Apple Silicon et Intel : Polivoks.component (Audio Unit pour
  Logic Pro, GarageBand, MainStage), Polivoks.vst3 (Ableton Live, Bitwig, Reaper, Cubase et
  autres DAW) et Polivoks.app (application autonome).


INSTALLATION — WINDOWS
----------------------
1. Copiez l’intégralité du dossier Polivoks.vst3 dans
   C:\Program Files\Common Files\VST3\
2. Ableton Live : Options -> Settings (Preferences dans les anciennes versions) -> Plug-Ins :
   activez « Use VST3 Plug-In System Folders » et cliquez sur « Rescan ».
3. Le plugin apparaît dans le navigateur sous Plug-Ins -> VST3 (éventuellement dans le dossier
   Ivan Abrosimov). Faites-le glisser sur une piste MIDI.

Sans DAW : Polivoks.exe est une application autonome avec clavier à l’écran.
Options -> Audio/MIDI Settings : choisissez votre interface audio et votre clavier MIDI.

Windows peut afficher un avertissement SmartScreen pour Polivoks.exe, car le programme n’est pas
signé. Cliquez sur « Informations complémentaires » (More info) -> « Exécuter quand même »
(Run anyway).


INSTALLATION — macOS
--------------------
1. Copiez les fichiers :
     Polivoks.component -> ~/Library/Audio/Plug-Ins/Components/
     Polivoks.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
   (Le dossier ~/Library est masqué : dans le Finder, choisissez Aller -> Aller au dossier…
   (Go -> Go to Folder…) et saisissez le chemin.)
2. Le plugin n’est pas encore signé avec un certificat Apple, c’est pourquoi macOS bloque les
   fichiers téléchargés sur Internet. Exécutez une seule fois ces commandes dans le Terminal :
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/Components/Polivoks.component
     xattr -dr com.apple.quarantine ~/Library/Audio/Plug-Ins/VST3/Polivoks.vst3
     xattr -dr com.apple.quarantine /path/to/Polivoks.app
3. Logic Pro : Logic Pro -> Settings -> Plug-in Manager. Trouvez Ivan Abrosimov -> Polivoks ;
   s’il n’a pas passé la validation, cliquez sur « Reset & Rescan Selection ».
   Le plugin se trouve dans AU Instruments -> Ivan Abrosimov -> Polivoks.
4. Ableton Live et les autres DAW sur Mac utilisent Polivoks.vst3 : activez le VST3 dans les
   réglages des plug-ins de la DAW et relancez l’analyse.


EMPLACEMENT DE VOS DONNÉES
--------------------------
- Vos presets (*.polivoks) :
    Windows : Documents\Polivoks\Presets
    macOS :   ~/Library/Audio/Presets/Ivan Abrosimov/Polivoks
- Notes (ratings.xml), assignations MIDI Learn par défaut (midi-map.xml), langue et indicateur
  de premier lancement (settings.xml) :
    Windows : %APPDATA%\Polivoks
    macOS :   ~/Library/Application Support/Polivoks


COMMANDES
---------
- Tous les boutons sont disposés comme sur la façade d’origine. Un double-clic ramène un bouton à
  sa valeur par défaut.
- Un guide détaillé de chaque commande est intégré au plugin : engrenage en haut à droite ->
  onglet GUIDE (dans les 13 langues).
- Interrupteur TENUE (en bas à droite, dans la section de l’amplificateur ; « ВКЛ. » sur
  l’original) : en haut (ON) — les notes jouées continuent de sonner après le relâchement des
  touches ; un nouvel accord joué après avoir relâché toutes les touches remplace celui qui est
  tenu ; à l’activation, la dernière note jouée sonne (si rien n’a encore été joué — silence
  jusqu’à la première note). En bas (OFF) — mode normal.
- Interrupteur SORTIE : ON — le son passe, OFF — le plugin est muet.
- La molette de modulation (CC1) ou une pédale d’expression (CC11) sert de pédale de coupure,
  comme sur l’original.
- Le pitch bend et la pédale de sustain fonctionnent, bien que l’original n’ait ni l’un ni
  l’autre.
- Entrée externe : le plugin dispose d’une entrée audio, mais l’envoi d’audio vers l’entrée d’un
  instrument dépend de votre DAW (pas encore vérifié dans Ableton). Le niveau d’entrée se règle
  avec le bouton EXTERNE ; combiné à TENUE (jouez une seule note), le filtre fonctionne comme un
  effet.

Barre supérieure (absente de l’original)
De gauche à droite : BIBLIOTHÈQUE, ◀ nom du preset ▶, note, ENREGISTRER, SOUTENIR L’AUTEUR ;
à droite — TEMPO et l’engrenage.

Clavier en bas
- Toute la plage MIDI (C-1…G9), 4 octaves à l’écran. Faites défiler avec les flèches aux
  extrémités, la molette de la souris ou un geste sur le pavé tactile. Cliquez sur une touche
  avec la souris pour jouer une note.


LANGUE DE L’INTERFACE
---------------------
- 13 langues : anglais, chinois, hindi, espagnol, arabe, français, bengali, portugais,
  indonésien, ourdou, russe, allemand, japonais.
- Choisissez-la dans la fenêtre « À propos » ou dans les réglages (engrenage -> onglet GUIDE ->
  LANGUE DE L’INTERFACE). Sont traduits : les inscriptions du panneau, la barre supérieure, la
  bibliothèque, les réglages, les noms des presets d’usine, le guide, ainsi que les noms et les
  valeurs des paramètres affichés par votre DAW. Le logo « ПОЛИВОКС » reste tel que sur
  l’original.
- Certaines DAW ne relisent les noms des paramètres qu’après le rechargement du plugin ou du
  projet.


À PROPOS DU PLUGIN ET SOUTIEN À L’AUTEUR
----------------------------------------
- Au premier lancement de chaque format (VST3 dans une DAW, AU dans Logic, application autonome),
  la fenêtre « À propos » s’affiche (en anglais par défaut ; choisissez la langue dans la liste
  en haut de la fenêtre). Fermez-la avec « Continuer » — elle ne s’affichera plus.
- Pour la rouvrir, cliquez sur SOUTENIR L’AUTEUR dans la barre supérieure : vous y trouverez les
  dons et les contacts.
- Les conditions d’utilisation se trouvent dans le dossier License (un fichier dans votre
  langue).


PRESETS
-------
- BIBLIOTHÈQUE (ou un clic sur le nom du preset) ouvre la liste. Cliquez sur une ligne pour
  charger le preset.
  Filtres à gauche : TOUS / USINE / UTILISATEUR, NOTE MINIMALE (1–5 étoiles), recherche par nom
  et par description. Les flèches ◀ ▶ parcourent les presets en respectant ces filtres.
- Note : cliquez sur une étoile pour noter, cliquez à nouveau sur la même étoile pour effacer la
  note.
  Vous pouvez noter dans la liste et dans la barre supérieure. Les notes sont communes à toutes
  les instances du plugin sur cet ordinateur.
- ENREGISTRER sauvegarde le son actuel comme preset personnel. Si le nom est déjà pris, le preset
  est écrasé (un avertissement vous en informe). Supprimez vos presets dans la bibliothèque :
  SUPPRIMER, puis SUPPRIMER ?.
- Vos presets se trouvent dans le dossier des presets (voir « Emplacement de vos données » ;
  bouton OUVRIR LE DOSSIER DES PRESETS dans la bibliothèque). Vous pouvez les copier d’un
  ordinateur à l’autre.
- Un astérisque et MODIFIÉ à côté du nom signifient que le son diffère du preset enregistré.
- Les presets n’enregistrent ni le tempo ni l’interrupteur SORTIE.


TEMPO
-----
- PROJET — le tempo et la grille viennent de votre DAW. MANUEL — réglez le tempo dans le champ à
  droite : faites glisser vers le haut/bas (maintenez Shift pour un réglage fin), utilisez la
  molette de la souris ou double-cliquez et saisissez un nombre (30–300 BPM).
- L’application autonome n’a pas de projet ; elle ne dispose donc que du champ de tempo manuel.
- Si la DAW ne transmet pas de tempo, le plugin utilise son propre tempo.

Synchronisation au tempo
- Modulateur : le bouton SYNCHRO TEMPO sous le bouton VITESSE. Lorsqu’il est allumé, le bouton
  VITESSE devient DIVISION : de 4 mesures à 1/32, valeurs pointées (.) et triolets (T) compris.
  Le tempo actuel et sa source sont affichés à droite. En mode PROJET, pendant la lecture, la
  phase du modulateur suit la grille du projet ; à l’arrêt, le modulateur continue de tourner au
  même tempo.
- Boucles d’enveloppe : l’interrupteur MODE ENV. du filtre et de l’amplificateur a trois
  positions — Une fois / Boucle / TEMPO. En position TEMPO, l’enveloppe redémarre à chaque
  division de la grille (bouton DIVISION juste à côté) tant qu’une touche est enfoncée ou que
  TENUE est activé.


ENGRENAGE EN HAUT À DROITE
--------------------------
Un panneau s’ouvre sur le côté droit de la fenêtre (la fenêtre s’élargit). Onglets :
- GUIDE — s’ouvre en premier : choix de la langue et guide détaillé de tous les paramètres dans
  la langue choisie (la table des matières est cliquable). La langue s’applique à tout le plugin.
- MIDI — MIDI Learn (ci-dessous).

MIDI Learn (engrenage -> onglet MIDI)
De nombreuses DAW (par exemple Ableton avec Push) assignent elles-mêmes les paramètres à un
contrôleur — vous n’avez alors pas besoin de MIDI Learn. Il est utile là où votre DAW ne le fait
pas.
1. Engrenage -> onglet MIDI -> ACTIVER MIDI LEARN — les boutons s’allument.
2. Cliquez sur un bouton ou un interrupteur — il est sélectionné.
3. Tournez un bouton de votre contrôleur — l’assignation est faite et le numéro de CC s’affiche
   sur le bouton.
- Dans ce mode, un clic droit sur une commande assignée supprime son assignation ; la liste à
  droite comporte une croix pour chaque assignation.
- Pour quitter ce mode : QUITTER sur le bandeau au-dessus du panneau, le bouton dans les
  réglages, ou Esc.
- Les assignations sont enregistrées avec le projet. ENREGISTRER COMME ASSIGNATIONS PAR DÉFAUT —
  les nouvelles instances du plugin démarrent avec celles-ci (fichier midi-map.xml, voir
  « Emplacement de vos données »).
- Le contrôleur doit parvenir à la piste MIDI du plugin (dans Ableton : l’entrée de la piste est
  votre contrôleur, Monitor sur In, ou sur Auto avec l’enregistrement armé). Si le même
  contrôleur est assigné dans le MIDI Map d’Ableton (Ctrl+M sous Windows, Cmd+M sur Mac), Ableton
  le capte avant le plugin.
- Un CC assigné ne contrôle que le paramètre : si vous assignez CC1 (molette de modulation) ou
  CC64 (sustain), leur fonction habituelle est désactivée pour ce plugin.
