Wudstyz

← Projets

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

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

Rien d'autre à installer : ni Python, ni Homebrew, ni Node — tout est embarqué dans l'application.

Premiers pas

  1. Branche le lecteur de cartes à puce en USB, insère une carte.
  2. Lance ChipCard : l'ATR s'affiche dès que la carte est détectée.
  3. Lire tout le contenu, ou utilise la section Mémoire pour lire/écrire une plage d'adresses.
  4. Pour écrire : renseigne le code PSC si la carte en a un (FF FF par défaut sur les cartes neuves SLE4428), puis Écrire. La zone 0000–001F est 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 relie chip.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.

  • Cartes à puce
  • Mac
  • Matériel

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

Toutes les mises à jour

Dans la même catégorie

Capture de Croquis

Croquis

Transforme n’importe quelle image en dessin à colorier.

Mac

Capture de MagCard

MagCard

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

Mac

Capture de Vigie

Vigie

Voyez tout ce que votre Mac envoie sur le réseau, et à qui.

Mac