Application
MagCard
Lire et écrire des cartes à piste magnétique sur Mac.

- Version v1.0publiée le 12 novembre 2026 · 14,4 Mo
- Macplateforme
- Publié en novembre 2026première publication
- Code publicREADME et code sur GitHub
English ·-informational)
Usage prévu. MagCard est un outil personnel de recherche et d'apprentissage pour lire/écrire tes propres cartes (badges, cartes de test, projets perso) dont tu as le droit de modifier le contenu. Il ne contourne aucune protection et ne fonctionne que sur des cartes à piste magnétique en clair, inscriptibles par n'importe quel lecteur MSR605X du commerce. Utilise-le uniquement sur du matériel qui t'appartient ou que tu es autorisé à manipuler.
Ce que ça fait
MagCard pilote un lecteur MSR605X (USB HID) depuis une vraie application macOS, avec une interface simple en français :
- lecture et écriture des 3 pistes d'une carte magnétique ;
- vérification automatique après écriture ;
- modèles enregistrés (jeux de valeurs réutilisables) ;
- journal des opérations (jamais le contenu des cartes) exportable en CSV ;
- copie en un clic vers le presse-papiers pour coller la valeur ailleurs ;
- réglage de la coercivité (hico / loco) et test des voyants du lecteur.
Ce projet est le compagnon de ChipCard, qui fait la même chose pour les cartes à puce (lecteurs PC/SC). Les deux sont volontairement deux applications séparées, chacune avec son propre nom et sa propre icône, pour rester simples.
Installation
- Télécharge la dernière version dans l'onglet Releases (fichier
.dmg). - Ouvre le
.dmg, glisse MagCard dans Applications. - Premier lancement : l'application n'est pas notariée par Apple (pas de compte développeur payant pour ce petit projet gratuit). Au premier double-clic, macOS peut refuser de l'ouvrir — fais clic droit → Ouvrir, puis confirme. Si ça ne suffit pas, lance dans le Terminal :
bash xattr -dr com.apple.quarantine "/Applications/MagCard.app"
Rien d'autre à installer : ni Python, ni Homebrew, ni Node — tout est embarqué dans l'application.
Premiers pas
- Branche le lecteur MSR605X en USB.
- Lance MagCard : le bandeau en haut à droite passe au vert quand le lecteur est détecté.
- Lire une carte, ou remplis les champs Piste 1/2/3 et clique Écrire.
- Utilise Copier à côté de chaque piste pour coller la valeur dans un autre champ.
Compatibilité et limites connues
- Testé avec un lecteur MSR605X (USB HID, VID/PID
0x0801/0x0003) sur Mac Apple Silicon (arm64). - Non testé sur Mac Intel, ni sur un deuxième Mac que celui du développement.
- Pas de mode de simulation sans matériel pour l'instant : il faut un lecteur MSR605X branché pour essayer l'application.
- L'application n'est pas notariée (voir ci-dessus).
Construire depuis les sources
git clone https://github.com/Wudstyz/MagCard.git
cd MagCard
./build_app.sh # construit MagCard.app (télécharge ses dépendances dans .venv/)
./make_dmg.sh # construit MagCard.dmg à partir de MagCard.app
Organisation du code
app.py/app_common.py— fenêtre native (pywebview) autour du serveur local.msr.py— protocole USB HID du MSR605X et petit serveur HTTP local pour l'interface.web/index.html— interface (une seule page, sans dépendance externe).build_assets/— génération de l'icône.
Contribuer
Les suggestions et pull requests sont bienvenues, en particulier pour la compatibilité avec d'autres Mac ou d'autres lecteurs de la même famille.
Licence
MIT — voir aussi THIRD_PARTY_NOTICES.md.
Dernières mises à jour
v1.0 Dernière version
12 novembre 2026 · il y a 4 jours · Mac
MagCard v1.0
Installation / Installation
FR : Ouvre MagCard.dmg, glisse MagCard dans Applications. Au premier lancement, l'application n'est pas notariée par Apple : fais clic droit → Ouvrir, puis confirme. Si macOS refuse encore, lance xattr -dr com.apple.quarantine "/Applications/MagCard.app" dans le Terminal.
EN: Open MagCard.dmg, drag MagCard into Applications. On first launch the app is not notarized by Apple: right-click → Open, then confirm. If macOS still refuses, run xattr -dr com.apple.quarantine "/Applications/MagCard.app" in Terminal.
Prérequis / Requirements
FR : Mac Apple Silicon (arm64), lecteur MSR605X (USB). Rien d'autre à installer.
EN: Apple Silicon Mac (arm64), MSR605X reader (USB). Nothing else to install.
Sécurité / Security
FR : Application non notariée, signature ad hoc/locale. Vérifie l'empreinte SHA-256 ci-dessous après téléchargement.
EN: Not notarized, ad-hoc/local signature. Verify the SHA-256 checksum below after downloading.
SHA-256 (MagCard.dmg):
7a8873d5fa3f69bf25974e1dd4203b53c9b2cd80a64e702023cd85bc4e513153

