Wudstyz

← Projets

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

  1. Télécharge la dernière version dans l'onglet Releases (fichier .dmg).
  2. Ouvre le .dmg, glisse MagCard dans Applications.
  3. 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

  1. Branche le lecteur MSR605X en USB.
  2. Lance MagCard : le bandeau en haut à droite passe au vert quand le lecteur est détecté.
  3. Lire une carte, ou remplis les champs Piste 1/2/3 et clique Écrire.
  4. 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.

  • Piste magnétique
  • Mac
  • Matériel

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

Toutes les mises à jour

Dans la même catégorie

Capture de Phare

Phare

Audit SEO, GSO et accès des robots d’IA à un site web.

Mac

Capture de View3D

View3D

Aperçu 3D et catalogues de vos créations (STL, OBJ, 3MF…) pour Mac

Mac

Capture de StatGithub

StatGithub

Les statistiques de visiteurs de tous vos dépôts GitHub.

Mac