Skip to content

Releases

v1.1.0

Choose a tag to compare

@ClusterM ClusterM released this 26 May 01:21

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, and tag_type in 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_uid without uid — 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

Choose a tag to compare

@ClusterM ClusterM released this 23 May 17:55

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 (ntag attribute)
  • 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

Choose a tag to compare

@ClusterM ClusterM released this 23 May 14:14

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.