Repository navigation
Releases
v1.1.0
Summary
- New action
proxmark3.write_magic_uid— write a random or custom UID to block 0 of writable Magic MIFARE Classic tags - Returns
uid,block_0, andtag_typein the action response - Only UID bytes and BCC are changed; SAK, ATQA, and manufacturer data are preserved
- Keys: configured integration keys plus common fallbacks (factory, MAD, NDEF, null)
- README updated with usage examples and automation sample
Upgrade
Reload the integration or restart Home Assistant after updating via HACS or git pull.
Test plan
- Place a Magic MIFARE Classic tag on the reader
- Call
proxmark3.write_magic_uidwithoutuid— verify response and sensor UID update - Call with
uid: "76343115"(or your hex) — verify written UID matches - Confirm normal (non-Magic) tags fail with a clear error
v1.0.1
Highlights
First stable release of the Proxmark3 Home Assistant integration.
Features
- NDEF decoding — Ultralight/NTAG and optional MIFARE Classic (MAD/NDEF, same logic as
hf mf ndefread) - NFC Tag sensor — UID, tag type, optional block data and NDEF JSON (
ntagattribute) - UID-only mode — no blocks or keys required; UID is always read
- 3-step config wizard — reading options → raw MIFARE Classic blocks → keys
- 64 locale translations — full Home Assistant language set
- Options flow — tune keys, blocks, NDEF, and poll intervals without re-adding the integration
- HACS-ready — hassfest + HACS validation CI, brand icon assets
Default entity id: sensor.proxmark3_nfc_tag.
Installation
HACS: add ClusterM/ha-proxmark3 as a custom repository (Integration), install Proxmark3, restart Home Assistant.
Manual: copy custom_components/proxmark3 into your config and restart.
Requires Proxmark3 with Iceman firmware and USB access from the Home Assistant host.
See README for NDEF writing with NFC Tools and automation examples.
v1.0.0
Highlights
First stable release of the Proxmark3 Home Assistant integration.
Features
- NDEF decoding — Ultralight/NTAG and optional Classic (MAD/NDEF, same logic as
hf mf ndefread) - UID-only mode — no blocks or keys required; UID is always read
- 3-step config wizard — reading options → raw blocks → Classic keys
- 64 locale translations — full Home Assistant language set
- Options flow — tune keys, blocks, NDEF, and poll intervals without re-adding the integration
Installation
HACS: add ClusterM/ha-proxmark3 as a custom repository (Integration), install Proxmark3, restart Home Assistant.
Manual: copy custom_components/proxmark3 into your config and restart.
Requires Proxmark3 with Iceman firmware and USB access from the Home Assistant host.
See README for NDEF writing with NFC Tools and automation examples.