# Hi-Dump - FLAC vers WAV (bit-perfect) et MP3 (LAME)

*Guide Windows. Pour macOS, voir `LISEZ-MOI-macOS.md`.*

**© 2026 HiGRID - Tous droits réservés.**  
Hi-Dump, HiGRID, le logo, la mascotte et la charte graphique sont la propriété
exclusive de HiGRID - voir `MENTIONS-LEGALES.md`.

**Aucune installation. Un seul fichier : `Hi-Dump.exe`.**
Posez-le où vous voulez (Bureau, clé USB, `Documents`) et double-cliquez.

---

## 1. Premier lancement

1. Double-cliquez sur `Hi-Dump.exe`.
   Windows affichera peut-être **« Windows a protégé votre PC »** : c'est
   normal, le programme n'est pas signé numériquement (une signature coûte
   plusieurs centaines d'euros par an). Cliquez sur **Informations
   complémentaires** → **Exécuter quand même**. Une seule fois.

2. Si un bandeau orange annonce **« ffmpeg n'est pas installé »**, cliquez sur
   **INSTALLER FFMPEG**. L'application télécharge et installe seule le moteur
   audio dans votre profil utilisateur (1 à 3 minutes). Rien à configurer.
   Si vous avez déjà ffmpeg, le bouton **CHOISIR…** permet de le désigner.

3. Bouton **RACCOURCI BUREAU** : crée le raccourci Hi-Dump sur votre Bureau.

---

## 2. Utilisation

| Étape | Action |
|---|---|
| 1 | **SOURCE** → `PARCOURIR` : le dossier qui contient vos FLAC |
| 2 | **DESTINATION** : proposée automatiquement, modifiable |
| 3 | **FORMATS** : WAV + MP3, WAV seul ou MP3 seul |
| 4 | **QUALITÉ MP3** : V0 (~245 kbps), V2 (~190 kbps) ou 320k CBR |
| 5 | **LANCER LA CONVERSION** |

Les pastilles **?** à côté de *QUALITÉ MP3* et de *THREADS* expliquent en clair
ce que chaque réglage change - qualité, poids des fichiers, charge du PC.

L'arborescence de dossiers est reproduite à l'identique :

```
D:\Musique\FLAC\                     E:\Sortie\
└── Artiste\                         ├── WAV\Artiste\Album (2019)\01 - Titre.wav
    └── Album (2019)\        ───►    └── MP3\Artiste\Album (2019)\01 - Titre.mp3
        └── 01 - Titre.flac
```

`ARRÊTER` interrompt proprement - relancer reprend où vous en étiez.
`OUVRIR` ouvre le dossier de destination.

---

## 3. Skins

Trois habillages, sélecteur **SKIN** en haut à droite, mémorisé au prochain
lancement :

- **HIGRID** *(par défaut)* - charte du collectif : `#0B0B0B` `#EFEBE3`
  `#E11D17` `#8E0F0B` `#807A6F`, titres **Anton**, texte **Archivo**,
  étiquettes **Space Mono**.
- **CYBERPUNK** - néon cyan / magenta sur fond noir bleuté.
- **OFFGRID** - fond clair, pour travailler en plein jour.

À gauche du sélecteur de skin, le bouton **LANGUE FR / EN** bascule toute
l'interface - libellés, bulles d'aide, console, dialogues, fenêtre À propos.
Skin et langue sont mémorisés.

Les trois polices sont **embarquées dans l'exécutable** : elles s'affichent
correctement même si elles ne sont pas installées sur le PC.

---

## 3 bis. La barre de progression

La barre n'est pas une jauge : c'est **la liste de vos fichiers transcrite en
glyphes**. Chaque cellule est générée à partir du nom d'un morceau - même
dossier, même glyphe, à chaque lancement.

- au démarrage, une **séquence d'initiation** balaye la bande de gauche à
  droite ;
- les morceaux traités **s'allument**, ceux en attente restent en filigrane ;
- un curseur clignote sur la position courante ;
- juste en dessous défile le **nom du fichier en cours**, tronqué par le
  milieu pour que la fenêtre ne bouge jamais d'un pixel ;
- à droite, compteur, pourcentage et temps restant estimé.

Le tracé - hampes lourdes, encoches, points détachés, dents de peigne - est un
clin d'œil à l'alphabet Yautja de *Predator*. La console, elle, garde la trace
exacte et lisible de chaque fichier.

---

## 4. Ce que garantit la conversion

**WAV - aucune dégradation, et c'est vérifiable.**
Le FLAC est un format sans perte : son décodage redonne exactement le PCM
d'origine. Hi-Dump écrit ce PCM tel quel - même fréquence (44,1 / 48 / 96 /
192 kHz), même profondeur (16 → `pcm_s16le`, 24 → `pcm_s24le`, 32 →
`pcm_s32le`), même nombre de canaux, aucun filtre ni dither ni normalisation.

Cochez **« Vérifier chaque WAV en bit-perfect »** : Hi-Dump calcule le MD5 du
flux PCM du FLAC **et** du WAV produit, et affiche `[BIT-PERFECT]` quand les
deux sont rigoureusement identiques, échantillon par échantillon.

**MP3 - le meilleur compromis possible.**
Le MP3 est un format avec perte : aucun encodeur ne peut produire un MP3 « non
dégradé ». Hi-Dump utilise donc les réglages les plus transparents - LAME **V0**
(~245 kbps de moyenne) avec `compression_level 0`, l'analyse psychoacoustique
la plus poussée. Rééchantillonnage uniquement au-dessus de 48 kHz (limite du
format MP3), via le resampler **SoXR** en précision 28 bits ; une source 96 kHz
passe à 48 kHz, une source 88,2 kHz à 44,1 kHz.

**Débit variable (V0) contre débit constant (320k).** Le débit n'est pas
l'échantillonnage : dans les deux cas le MP3 sort en 44,1 kHz, comme le FLAC
d'entrée. Le débit décrit seulement la quantité de données conservée par
seconde. En 320k CBR, l'encodeur dépense 320 kbps partout - y compris sur un
silence ou une note tenue, où c'est du gâchis. En V0, il descend sur les
passages simples et **monte jusqu'à 320 kbps sur les passages difficiles**.
Résultat : fichiers ~30 % plus légers, sans avantage audible démontré pour le
320k CBR - le seul intérêt réel de ce dernier est la compatibilité avec de
vieux lecteurs qui digèrent mal le débit variable.

**Métadonnées.** Tags recopiés depuis le FLAC, écrits en **ID3v2.3 + ID3v1**
(la combinaison la mieux reconnue par les autoradios et baladeurs). Pochette
intégrée conservée, réencodée en JPEG si elle était en PNG. Les WAV reçoivent
les tags dans le chunk `LIST INFO` - le format WAV ne gère pas les pochettes.

---

## 5. Robustesse

- **Écriture atomique** : chaque fichier est produit sous un nom `.part` puis
  renommé une fois complet. Une coupure ne laisse jamais de WAV tronqué.
- **Reprise** : relancez, les fichiers déjà convertis sont ignorés - Hi-Dump
  compare la destination à la source avant de lancer quoi que ce soit.
- **Doute levé, jamais tranché tout seul** : si un fichier est déjà présent
  mais que le FLAC source a été modifié depuis, Hi-Dump demande s'il faut le
  reconvertir ou le garder. Si deux fichiers sources différents produiraient le
  même nom de sortie, il demande également quoi faire (tout convertir, ne
  garder que le premier, ou annuler).
- **Un fichier corrompu n'arrête pas le lot** : signalé, compté, on continue.
- **Chemins Windows > 260 caractères** gérés (préfixe `\\?\`).
- **Rapport CSV** (`_rapport_conversion.csv`) écrit à la racine de la
  destination : statut, chemins, tailles, durée, vérification, erreurs.
- Réglages mémorisés dans `%LOCALAPPDATA%\Hi-Dump\config.json`.

---

## 6. Questions fréquentes

**Le WAV est bien plus gros que le FLAC ?**
Oui, et c'est normal. Le FLAC **est** compressé - mais sans perte : il ramène
le fichier à 50-60 % de la taille du WAV et son décodage redonne exactement les
mêmes échantillons. Le WAV, lui, n'est pas compressé du tout : c'est du PCM
brut. Les deux contiennent le même signal, au bit près ; seul le nombre
d'octets sur le disque change.

**Où est installé ffmpeg ?**
Dans `%LOCALAPPDATA%\Hi-Dump\bin`. Pour tout désinstaller : supprimez
`Hi-Dump.exe` et le dossier `%LOCALAPPDATA%\Hi-Dump`. Rien n'est écrit ailleurs,
aucune clé de registre, aucun droit administrateur requis.

**Combien de temps ça prend ?**
Avec 8 threads, comptez 1 à 3 minutes pour 100 titres en WAV+MP3. L'option de
vérification double à peu près ce temps.

**Ligne de commande ?**
Le moteur `hidump_engine.py` s'utilise seul :
`python hidump_engine.py "D:\Musique" "E:\Sortie" --formats both --quality V0 --verify`


---

## 7. Propriété intellectuelle

**© 2026 HiGRID - Tous droits réservés.**

Le logiciel, son code, son interface, ses habillages, le nom **Hi-Dump**, la
marque **HiGRID**, le logo, la mascotte et la charte chromatique sont la
propriété exclusive de HiGRID. Reproduction, diffusion, modification ou
réutilisation interdites sans autorisation écrite préalable.

Ces mentions figurent à quatre endroits, et ne doivent pas être retirées :

- en **en-tête du code source** (`Hi-Dump.pyw`, `hidump_engine.py`) ;
- en **pied de l'interface** (ligne discrète en bas de fenêtre) ;
- dans la fenêtre **À PROPOS** (bouton en bas à droite) ;
- dans les **propriétés de `Hi-Dump.exe`** - clic droit → Propriétés → Détails :
  société HiGRID, copyright, marques, description.

Le détail des droits et des licences des composants tiers (FFmpeg, LAME,
polices) figure dans `MENTIONS-LEGALES.md`.