Application
ChipCard
Lire et écrire des cartes à puce sur Mac.

- Version v1.0publiée le 12 novembre 2026 · 14,7 Mo
- Macplateforme
- Publié en novembre 2026première publication
- Code publicREADME et code sur GitHub
English ·-informational)
Usage prévu. ChipCard est un outil personnel de recherche et d'apprentissage pour lire/écrire tes propres cartes à puce (badges, cartes de test, projets perso) dont tu as le droit de modifier le contenu. Il parle le protocole standard PC/SC (ATR, APDU) sans contourner de protection ni cloner une carte sécurisée : il lit et écrit ce que le lecteur veut bien communiquer, rien de plus. Utilise-le uniquement sur du matériel qui t'appartient ou que tu es autorisé à manipuler.
Ce que ça fait
ChipCard pilote un lecteur de cartes à puce PC/SC depuis une vraie application macOS, avec une interface simple en français :
- lecture de l'ATR et exploration de la carte (AID, fichiers EF/DF) ;
- console APDU libre, avec quelques commandes types ;
- lecture et écriture de cartes à mémoire synchrone (ex. SLE4428), avec code PSC ;
- garde-fou sur la zone protégée (adresses
0000–001F), confirmation explicite requise pour y toucher ; - conversion texte clair ↔ hexadécimal, copie du contenu en clair (hors zone protégée) ;
- duplication guidée d'une carte vers une autre, et indicateur rapide « carte vierge / déjà utilisée ».
Ce projet est le compagnon de MagCard, qui fait la même chose pour les cartes à piste magnétique (lecteur MSR605X). 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 ChipCard 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/ChipCard.app"
Rien d'autre à installer : ni Python, ni Homebrew, ni Node — tout est embarqué dans l'application.
Premiers pas
- Branche le lecteur de cartes à puce en USB, insère une carte.
- Lance ChipCard : l'ATR s'affiche dès que la carte est détectée.
- Lire tout le contenu, ou utilise la section Mémoire pour lire/écrire une plage d'adresses.
- Pour écrire : renseigne le code PSC si la carte en a un (
FF FFpar défaut sur les cartes neuves SLE4428), puis Écrire. La zone0000–001Fest protégée par défaut — elle contient des données lues par certains lecteurs pour reconnaître la carte, l'écraser peut la rendre illisible.
Compatibilité et limites connues
- Testé et fiable en lecture ET en écriture : lecteur HID OMNIKEY 3121, cartes à mémoire SLE4428.
- Lecteur ACS ACR39U : lit correctement les cartes à mémoire, mais son implémentation de la commande VERIFY (présentation du code PSC) ne fonctionne pas de façon fiable avec ce pilote sur macOS — l'écriture peut échouer. Préfère l'OMNIKEY si tu as le choix.
- Testé sur Mac Apple Silicon (arm64) uniquement, pas sur Mac Intel ni sur un deuxième Mac.
- La duplication de carte et l'indicateur vierge/utilisée sont implémentés mais n'ont pas encore été validés sur du matériel réel au moment de la publication — teste-les prudemment la première fois, de préférence sur une carte sans valeur.
- Pas de mode de simulation sans matériel pour l'instant : il faut un lecteur PC/SC 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/ChipCard.git
cd ChipCard
./build_app.sh # construit ChipCard.app (télécharge ses dépendances dans .venv/)
./make_dmg.sh # construit ChipCard.dmg à partir de ChipCard.app
Organisation du code
app.py/app_common.py— fenêtre native (pywebview) autour du serveur local.chip.py— communication PC/SC (APDU, décodage ATR, lecture/écriture mémoire).msr.py— petit serveur HTTP local qui reliechip.pyà 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 lecteurs ou d'autres familles de cartes à puce.
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
ChipCard v1.0
Installation / Installation
FR : Ouvre ChipCard.dmg, glisse ChipCard 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/ChipCard.app" dans le Terminal.
EN: Open ChipCard.dmg, drag ChipCard 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/ChipCard.app" in Terminal.
Prérequis / Requirements
FR : Mac Apple Silicon (arm64), lecteur de cartes à puce PC/SC (testé avec HID OMNIKEY 3121). Rien d'autre à installer.
EN: Apple Silicon Mac (arm64), PC/SC smart-card reader (tested with HID OMNIKEY 3121). Nothing else to install.
Avertissement / Warning
FR : Cette application peut écrire sur des cartes à mémoire réelles. Une mauvaise adresse d'écriture peut rendre une carte illisible de façon permanente — la zone 0000-001F est protégée par défaut, ne la désactive que si tu sais ce que tu fais.
EN: This app can write to real memory cards. Writing to the wrong address can make a card permanently unreadable — the 0000-001F zone is protected by default; only disable that guard if you know what you're doing.
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 (ChipCard.dmg):
12bf3c9ce5499a9eb7db0c6f57ee692c10865a27eef63ebd48d0ed9332965515

