Scripts PowerShell pour faire fonctionner correctement les périphériques Apple Magic (génération 2021) sur Windows 11 : défilement de la souris, défilement + gestes 3/4 doigts du trackpad, disposition clavier française correcte.
Ce dépôt ne contient aucun binaire. Que des scripts, du texte et une source de disposition clavier. Chaque driver est téléchargé par le script, sur votre machine, depuis sa source officielle. Voir Pourquoi rien n'est livré avec le dépôt.
📖 Guide illustré pas-à-pas, en français — pourquoi Windows échoue, comment le réparer, et ce qui ne marchera jamais : https://www.depannonline.xyz/magic-mouse-windows
English version: README.en.md
git clone https://github.com/mo94/magic-devices-windows.git
cd magic-devices-windowsSans git : bouton Code › Download ZIP sur GitHub, ou l'archive équivalente servie directement depuis la page DepannOnline, avec son empreinte SHA-256 affichée — de quoi vérifier ce que vous téléchargez avant de l'exécuter.
Combien de temps ? La manipulation elle-même prend 20 à 35 minutes pour les trois appareils. Si le pilote de la souris n'est pas déjà sur la machine, le téléchargement du paquet Boot Camp chez Apple (500 Mo à 2 Go) peut porter la séance à une heure environ. C'est de l'attente, pas du travail — et le trackpad seul ou le clavier seul ne demandent pas ce téléchargement.
Les périphériques Magic de 2021 (ceux livrés avec les iMac 24" Apple Silicon) s'annoncent en Bluetooth avec des Product IDs récents :
| Appareil | VID/PID | Modèle |
|---|---|---|
| Magic Keyboard | 004C:0322 |
Touch ID + pavé numérique |
| Magic Mouse | 004C:0323 |
Magic Mouse 2021 |
| Magic Trackpad | 004C:0324 |
Magic Trackpad 2021 |
Windows ne charge qu'un driver Bluetooth HID générique : pointer, cliquer et taper fonctionnent, mais pas le défilement ni les gestes.
Et Boot Camp ne se charge pas tout seul : Apple a arrêté Boot Camp fin 2020, avant
ces appareils. Vérifié empiriquement (paquets Macmini8,1 et iMac20,2) — aucun INF
Boot Camp ne déclare les PID 0322/0323/0324. Faire « clic droit sur le .inf > Installer »
ne donne donc rien. Le fichier applewirelessmouse.sys, lui, est dans le paquet Boot
Camp et fonctionne parfaitement : il faut simplement l'attacher à la main au bon nœud,
en filtre — c'est exactement ce que fait Install-MagicMouse.ps1.
| Souris (0323) | Trackpad (0324) | |
|---|---|---|
| Défilement 2 doigts | ✅ | ✅ |
| Clic droit | ✅ | ✅ |
| Défilement horizontal | ✅ | ✅ |
| Gestes 2 doigts (retour/avance) | partiel | ✅ |
| Gestes 3 / 4 doigts | ❌ impossible | ✅ |
| Zoom pincement | ❌ | ✅ |
La Magic Mouse ne gère pas les gestes 3/4 doigts : sa surface tactile ne rapporte que 1 à 2 points de contact, y compris sous macOS. Ce n'est pas un manque de driver, c'est le matériel. Aucun logiciel, gratuit ou payant, ne fera apparaître ces gestes.
Côté Magic Keyboard : Touch ID ne fonctionne pas sous Windows (limite Apple), et les touches Fn / multimédia / rétroéclairage ne sont que partiellement gérées.
- Windows 10/11 x64 (ou ARM64 pour le trackpad)
- Les appareils Magic appairés en Bluetooth avant de lancer les scripts
- Droits administrateur (les scripts demandent l'élévation UAC automatiquement)
- Une connexion Internet au premier lancement (téléchargement des drivers)
Lancer les scripts avec
powershell -ExecutionPolicy Bypass -File <script>.ps1. Sous Windows PowerShell 5.1, depuis une vraie fenêtre PowerShell. Les scripts sont en ASCII pur pour éviter tout souci d'encodage.
powershell -ExecutionPolicy Bypass -File bootstrap.ps1Trackpad puis souris, avec une seule élévation UAC.
Options : -SkipTrackpad, -SkipMouse, -Keyboard.
powershell -ExecutionPolicy Bypass -File scripts\Install-Trackpad.ps1Télécharge la release signée Microsoft du driver PTP open source, puis l'installe via
pnputil. Aucune désactivation de sécurité : pas de test-signing, Secure Boot reste
actif. Le trackpad devient un Precision Touchpad Windows à part entière.
Régler les gestes dans Paramètres > Bluetooth et appareils > Pavé tactile (3 et 4
doigts). Réglages fins : drivers\trackpad\AmtPtpControlPanel.exe.
powershell -ExecutionPolicy Bypass -File scripts\Install-MagicMouse.ps1- Cherche
applewirelessmouse.syssur votre machine (System32, DriverStore) ; - sinon, propose de télécharger le Boot Camp Support Software depuis les serveurs d'Apple avec brigadier (MIT) et d'en extraire le fichier ;
- copie le driver, crée le service noyau, et l'attache en LowerFilter sur le nœud souris en ne ciblant que le PID 0323 — le clavier (0322) et le trackpad (0324) ne sont jamais touchés.
Si le défilement ne répond pas tout de suite, redémarrer le PC.
Pour ne faire que l'étape de récupération du driver :
powershell -ExecutionPolicy Bypass -File scripts\Get-AppleMouseDriver.ps1
# autre modèle si besoin :
powershell -ExecutionPolicy Bypass -File scripts\Get-AppleMouseDriver.ps1 -Model iMac20,2Le clavier n'a pas besoin de driver, mais le mapping AZERTY Apple ≠ Français Windows
fait sortir de mauvais caractères (- → =, = → !, et @ # < > | mal placés).
powershell -ExecutionPolicy Bypass -File scripts\Install-KeyboardLayout.ps1
# ou, pour ne rien exécuter de prébuilt et construire la disposition soi-même :
powershell -ExecutionPolicy Bypass -File scripts\Install-KeyboardLayout.ps1 -SourceOnlyDétails et sélection de la disposition : keyboard/README.md.
- Souris :
powershell -ExecutionPolicy Bypass -File scripts\Uninstall-MagicMouse.ps1(retire le LowerFilter, supprime le service et le fichier). - Trackpad :
pnputil /enum-driverspour trouver leoemXX.infcorrespondant àAmtPtpDevice, puispnputil /delete-driver oemXX.inf /uninstall. - Clavier : Paramètres > Applications > « French - Apple » > Désinstaller, puis retirer la disposition dans les options linguistiques.
C'est un choix, pas un oubli.
| Composant | Licence | Pourquoi il n'est pas dans le dépôt |
|---|---|---|
applewirelessmouse.sys |
Propriétaire Apple (CLUF Boot Camp) | Non redistribuable. Apple le met à disposition depuis ses propres serveurs ; c'est de là qu'il doit venir, et l'accord vous lie à Apple, pas à nous. |
Driver trackpad (AmtPtp*) |
GPL-2.0 | Redistribuable, mais la GPL-2.0 impose de fournir la source correspondante avec le binaire. Pointer sur la release amont garde binaire et source ensemble, toujours en phase. |
| Installeur clavier (MSI/DLL) | MIT | Redistribuable, mais un binaire opaque dans un dépôt public est un mauvais signal. On livre la source de la disposition (.klc), le script va chercher l'installeur amont. |
Conséquence agréable : tout ce dépôt est lisible. Ouvrez les .ps1, ils font
exactement ce qu'ils annoncent, et rien d'autre.
- Une mise à jour Windows ou un ré-appairage Bluetooth peut effacer le
LowerFiltersdu nœud souris (la clé est liée à l'instance du périphérique). Symptôme : le défilement disparaît du jour au lendemain. Remède : relancerInstall-MagicMouse.ps1. - La souris doit être appairée et connectée au moment de l'installation, sinon le nœud
PID&0323n'existe pas et le script s'arrête (volontairement). brigadiertélécharge un paquet Apple de 500 Mo à 2 Go ; prévoir le temps et la place.- Sur ARM64, seul le trackpad est couvert (le driver Apple souris est x64).
Le travail utile vient d'autres gens. Voir CREDITS.md.
- Trackpad : vitoplantamura/MagicTrackpad2ForWindows (GPL-2.0), basé sur imbushuo/mac-precision-touchpad
- Souris : technique du LowerFilter de sbagirici/apple-magic-mouse-scroll-fix-windows (MIT)
- Clavier : kud/apple-french-keyboard-windows (MIT)
- Téléchargement Boot Camp : timsutton/brigadier (MIT)
Les scripts de ce dépôt sont sous licence MIT (LICENSE).
Fourni tel quel, sans garantie. Ces scripts modifient la base de registre et créent un
service noyau ; Uninstall-MagicMouse.ps1 annule proprement l'opération. Faites un point
de restauration si vous êtes prudent.
Apple, Magic Mouse, Magic Trackpad, Magic Keyboard, Boot Camp et macOS sont des marques d'Apple Inc. Windows est une marque de Microsoft Corporation. Ce projet n'est ni affilié à, ni approuvé par Apple Inc. ou Microsoft Corporation.
Les retours sur d'autres modèles (Magic Mouse 1re génération, Magic Trackpad 2, claviers d'autres dispositions) sont les bienvenus : le principe est le même, seul le PID ciblé change.
- Bug, matériel qui ne répond pas, PID inconnu → ouvrir une issue
- Aucun binaire n'est accepté dans les contributions — ni
.sys, ni.cat, ni.dll, ni.exe, ni.msi. Le.gitignoreles refuse partout dans l'arborescence ; ne le contournez pas avecgit add -f. Un driver se télécharge depuis sa source officielle, il ne se recopie pas dans un dépôt.
Maintenu par DepannOnline — dépannage et infogérance informatique, à Lyon et à distance.
- 📖 Guide pas-à-pas en français, avec les captures et les pièges : https://www.depannonline.xyz/magic-mouse-windows
- 🛟 Vous préférez qu'on le fasse à votre place ? Intervention à distance, forfait unique pour les trois appareils — conditions et tarif sur la page ci-dessus.