# Hi-Dump sur macOS

**© 2026 HiGRID - Tous droits réservés.**  contact@higrid.eu  ·  334fredo

Application autonome. **Rien à installer**, aucun Python, aucun Homebrew :
Hi-Dump embarque son propre moteur, en version Apple Silicon et en version
Intel, et choisit la bonne au lancement.

---

## 1. Installation

1. Décompressez l'archive.
2. Glissez **`Hi-Dump.app`** dans votre dossier **Applications** (ou laissez-la
   où vous voulez : elle fonctionne depuis n'importe quel dossier, y compris
   une clé USB).
3. **Clic droit** sur l'application → **Ouvrir** → **Ouvrir**.

Le clic droit n'est nécessaire qu'une seule fois. Ensuite, double-clic normal,
et l'icône peut rester dans le Dock.

### Pourquoi ce clic droit la première fois

macOS étiquette tout fichier arrivé par un navigateur et refuse d'ouvrir d'un
simple double-clic une application non signée par un compte développeur Apple
payant. Ce n'est pas un signalement de virus : c'est le même message pour tout
logiciel indépendant non signé. Le clic droit sur **Ouvrir** est la voie
officielle prévue par Apple pour lever l'alerte.

Si le menu contextuel ne propose pas de bouton **Ouvrir** (macOS Sequoia et
suivants), deux solutions :

- **Réglages Système → Confidentialité et sécurité**, tout en bas, bouton
  **Ouvrir quand même** ;
- ou double-cliquez sur **`Autoriser Hi-Dump (1re ouverture).command`** livré à
  côté de l'application : il retire l'étiquette de quarantaine, signe
  l'application localement, puis la lance.

L'équivalent en une ligne dans le Terminal, si vous préférez :

```bash
xattr -dr com.apple.quarantine /Applications/Hi-Dump.app
```

Rien n'est installé, rien n'est transmis : cette commande retire seulement une
étiquette posée par le navigateur.

---

## 2. Premier lancement

Un bandeau propose **INSTALLER FFMPEG** : un clic, Hi-Dump télécharge le moteur
audio et l'installe dans votre dossier utilisateur, en version **native Apple
Silicon ou Intel** selon votre Mac. Une à trois minutes, une seule fois.

Si ffmpeg est déjà présent (Homebrew, MacPorts), Hi-Dump le détecte tout seul
et le bandeau n'apparaît pas.

Le bouton **RACCOURCI BUREAU** place un lien vers l'application sur votre
Bureau.

---

## 3. Où Hi-Dump écrit

| Quoi | Où |
|---|---|
| Réglages (skin, langue, dossiers) | `~/Library/Application Support/Hi-Dump/config.json` |
| Moteur audio téléchargé | `~/Library/Application Support/Hi-Dump/bin` |
| Polices Anton, Archivo, Space Mono | `~/Library/Fonts` |
| Rapport de conversion | `_rapport_conversion.csv`, à la racine du dossier de sortie |

**Désinstallation** : mettez `Hi-Dump.app` à la corbeille et supprimez le
dossier `~/Library/Application Support/Hi-Dump`. Aucun réglage système n'aura
été modifié, aucun mot de passe administrateur demandé.

Les polices s'affichent pleinement **au second lancement** : macOS ne les
référence qu'après leur copie dans votre dossier de polices. La première
session utilise des polices de substitution, sans autre conséquence que
l'aspect.

---

## 4. Utilisation

Identique à la version Windows : sélection des dossiers, formats, qualité,
options, puis **LANCER LA CONVERSION**. Voir `LISEZ-MOI.md` pour le détail des
réglages, des garanties bit-perfect et des explications de débit.

Le moteur s'utilise aussi seul, en ligne de commande :

```bash
/Applications/Hi-Dump.app/Contents/Resources/runtime-arm64/bin/python3.12 \
  /Applications/Hi-Dump.app/Contents/Resources/app/hidump_engine.py \
  ~/Musique/FLAC ~/Musique/Sortie --formats both --quality V0 --verify
```

*(remplacez `runtime-arm64` par `runtime-x86_64` sur un Mac Intel)*

---

## 5. Compatibilité

- macOS 10.15 Catalina et suivants.
- Apple Silicon (M1 à M4) en natif, Intel 64 bits en natif.
- Environ 200 Mo sur le disque, moteur audio compris.
