BranchesTags

Repository files navigation

Buy Me A CoffeeDiscordGitHub release

Tag Reader for Home Assistant

The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.

I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.

Photos of the final product

Building the tag reader

To build your own tag reader, you need the following components:

The 3D models for the case are here.

WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.
Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.

Connecting the components

Photo of schematics

There are not too many components to connect, but it does require soldering. You will need the following:

Also, make sure that you have set the switches on the PN532 to the following:

  • Switch 1: On (up)
  • Switch 2: Off (down)

This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!

To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.

⚠️ The tag reader requires ESPHome 1.16.0.

If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.

Open Case

Configuring for use with Home Assistant

The tag reader requires Home Assistant 0.115 or later.

If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.

The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.

Usage

Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.

Screenshot of the Home Assistant tag UI

Disclamer

We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.

About

Simple to build/use NFC tag reader, specially created for Home Assistant

adonno.com

Topics

esphometag-reader

Resources

Readme
GPL-3.0 license
Activity

Stars

1.6k stars

Watchers

57 watching

Forks

211 forks
Report repository

Releases

Sponsor this project

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Buy Me A CoffeeDiscordGitHub release
Tag Reader for Home Assistant
The tag reader is a simple to build/use NFC tag reader, specially created for Home Assistant. It is using a D1 mini ESP 8266 and the PN532 NFC module. The firmware is built using ESPhome.
I am selling a pre-built version, a DIY version (assembly required), or just the case (use with own components). Check it out on my website.
Photos of the final product
Building the tag reader
To build your own tag reader, you need the following components:
The 3D models for the case are here.
WARNING regarding AZdelivery D1. We have had several users contacting us with different issues, we don't recommend using these boards and won't provide support for them.

Recent reports suggest more clones of the D1 are now working as expected. This has been verified on an AZdelivery D1.
Connecting the components
Photo of schematics
There are not too many components to connect, but it does require soldering. You will need the following:
Also, make sure that you have set the switches on the PN532 to the following:
  • Switch 1: On (up)
  • Switch 2: Off (down)
This enables the PN532 module to communicate with the D1 over I2C, and is required for the modules to work together!
To flash the reader firmware to your D1 Mini you point ESPHome at tagreader.yaml.
⚠️ The tag reader requires ESPHome 1.16.0.
If you're new to ESPHome, we recommend that you use the ESPHome Home Assistant add-on.
Open Case
Configuring for use with Home Assistant
The tag reader requires Home Assistant 0.115 or later.
If the tag reader is unable to connect to a wifi network, it will start a WiFi access point with a captive portal to allow you to enter your WiFi credentials.
The tag reader will be automatically discovered by Home Assistant once the tag reader is connected to the same network. You can follow the instructions in the UI to set it up.
Usage
Scanned tags can be managed from the tags interface in Home Assistant. You can find it under config -> tags.
Screenshot of the Home Assistant tag UI
Disclamer
We use aliexpress affiliate links for the components and the tools. Some Ad-blockers might block these links and thus they seem to appear broken. You will have to temporarily disable the ad-blocker to open these links.
About
Simple to build/use NFC tag reader, specially created for Home Assistant
adonno.com
Topics
esphometag-reader
Resources
Readme
GPL-3.0 license
Activity
Stars
1.6k stars
Watchers
57 watching
Forks
211 forks
Report repository
Releases
Sponsor this project
Packages
Contributors
Languages