TagTuner is a device that enables you to access music playlists or albums using NFC tags.
It only works when integrated with Home Assistant media players and the Music Assistant music library is optional. This setup seamlessly blends your digital only music collection with the tactile experience of playing a physical record, tape or cd.
Physical music media offer several advantages:
- it's easy
- it's fast
- it's inclusive
TagTuner is made with ESPHome and includes
- an NFC reader
- a dial
- a button
- a multicolor LED light
All of this is housed in a sleek, custom design case.
D1-Custom version is only 16mm high
Here is an exploded view of the TagTuner 3D model with a round tag card
To start using TagTuner, you’ll need the following:
- Home Assistant 2024.10.x
- Music Assistant 2.x or Sonos speaker
- configured MAss music library and/or a streaming subscription
- TagTuner device configured in HAss
- Programmable NTAG213/215/216 tags
Assuming you already have Home Assistant (HAss) with Music Assistant (MAss) or Sonos set up and running, TagTuner supports Improv via Serial for Wi-Fi configuration.
If the Wi-Fi connection is misconfigured, the device will start a Wi-Fi access point, allowing you to connect and set the password.
Home Assistant will automatically detect your new TagTuner as ESPhome device.
In the Diagnostic panel of TagTuner you can see detailed state of your device.
Simply place any NFC tag and watch Status messages.
TagTuner relies heavily on Home Assistant automation. To get it working, import TagTuner for HAss blueprint
Create automation with this blueprint.
Select your TagTuner device (you can have more than one!) and media player that will be your speaker
I do a monthly updates of the blueprint. You can watch my repo with github to get email notifications.
List of current features:
- separate settings for MAss player and HAss player (http sources). If you don't need double setting, just set the same in both
- Stop music on tag removed: choose if you want this
- Announce every playlist: you can choose your TTS engine and TagTuner will use your speaker to read artist and playlist names
- Shuffle every playlist: choose if you want this. You can also add '/shuffle' (without quotes or spaces) at the end of the source URI to shuffle just this album
- Volume limiter: to limit the maximum volume set with TagTuner knob (kids friendly!)
- Notify about version mismatch: shoose if you want HA dashboard notification that your blueprint version is to new vs your TagTuner yaml firmware. Currently there are no breaking changes so this is future proofing the blueprint and your experience
Place your tag flat on the TagTuner or use the slot to position it nicely.
TagTuner will read the tag and send the playlist information to Home Assistant. Using automation, HAss will play music on the speaker you've set up for this TagTuner.
Single click: next
Double click: play/pause
Long click (>1s): mute/unmute
Triple click: previous
Rotate the dial left: volume down.
Rotate the dial right: volume up.
Watch the LED light in the button:
white blink: operation confirmed
flashing red: writing operation in progress
flashing green: writing success \
D1-Custom has a single color led so it's only blinking but it's really easy to understand what's going on with HAss device Diagnostic dashboard in case you would need that.
Check the Diagnostic->Status messages on the device page in Home Assistant.
The ladybug icon is your guide.
Choose NTAG215 (504 bytes) or NTAG216 (888 bytes) tags if you want to include the playlist name and artist. Otherwise, NTAG213 (144 bytes) will suffice for just links to playlists
Record-like cards can be printed (model file included) or you can buy those nice looking vinyl coasters. Just remember to put NFC stickers on them ;-)
Stickers can be used with 3d printed cards or any other object you can place on your TagTuner to play music.
I use Canon KC-18IF card-sized labels to customize my wooden NFC cards.
If your speaker is one of Music Assistant media players, your tags need to have a MAss URI.
Here you can find instructions on how to get URI for the playlist or album you want.
On the TagTuner device page, you'll find all the fileds nesesary to write the playlist URI to your tag
Minimum information needed is URI.
Fill in the Playlist URI -> click Write Tag -> LED starts flashing red -> Place the tag on TagTuner
Successful writing will be confirmed with green light.
Check Diagnostic->Status for any additional information.
If your speaker is Sonos media player, your tags can have a plain HTTP playlist URL.
Here you can find instructions on how to get the album or playlist url for Apple Music. Just copy it.
It should work the same with Spotify
On the TagTuner device page, you'll find all the fileds nesesary to write the playlist URL (URI) to your tag
Minimum information needed is URL.
Fill in the Playlist URL -> click Write Tag -> LED starts flashing red -> Place the tag on TagTuner
Successful writing will be confirmed with green light.
Check Diagnostic->Status for any additional information.
You can also write your tags with any NFC NDEF tag writer, such as NXP NFC TagWriter for iOS or Android
or
You can also play any Sonos app favorite playlist, album, or station!
Simply write the name of the playlist or station exactly as it appears in the Sonos app.
Then, enter sonos-2:// in the URI field.
If you have any read-only tags that can be read by TagTuner (give it a try to check), you can use them too!
To set the playlist URL, place it as the name of the tag in HAss panel
Any tag id read by TagTuner will be pushed to HAss blueprint automation.
Choose and print your enclosure with preffered colors and surface patterns
I suggest a cool-white (signal white) base and a dark front plate with a nice carbon fibre pattern.
This version is focused on minimum soldering since it's based on Grove parts and connectors
- m5stack Atom Echo controller
- pn532 NFC reader
- grove angle connectors
- grove cables
- grove rotary encoder
First, you need to solder the grove angle connector to the PN532 NFC board
Remember to set the DIP switches to 10 to enable I2C. Correct position for I2c is marked by yellow lines.
The SeeedStudio rotary encoder already has its connector. For the other end of the cable, simply use grove angle connector directly to the Atom controller
It's really as simple as that
Everything will fit into the enclosure.
Use short (<5mm) M2 screw for Atom and longer (10mm) M2.5 screws for everything else (nfc board, volume encoder, front plate).
This version requires a bit more soldering but allows the knob to be used as a button.
- esp32 D1 mini controller with USBC
- pn532 NFC reader
- hw040 rotary encoder
Remember to set the pn532 DIP switches to 10 to enable I2C (as described above).
pn532 connector:
- GND: GND
- VCC: VCC (+5V)
- SDA/TXD: IO21
- SCL/RXD: IO22
hw040 connector:
- CLK: IO18
- DT: IO19
- SW: IO23
- +: +3.3V
- GND: GND
ESP32 D1 mini will fit perfectly into the bottom part braces
Built-in LED is used as confirmation light
- 3d models: Atom Echo Grove version 3d models
- printables: 16mm D1-Custom version model
- tagtuner-atom-grove.yaml: based on m5stack Atom Echo and grove connectors
- tagtuner-atom-grove-ble.yaml: m5stack Atom Echo + Bluetooth & BLE proxy, no media player, ESP-IDF framework. This is current default install
- tagtuner-for-tagreader.yaml: TagTuner firmware for Adonno tagreader device (buzzer only, no led support)
- tagtuner-D1-custom1.yaml: ESP32 D1 mini with HW-040 rotary encoder and button. Bluetooth & BLE proxy, ESP-IDF framework
OK, I can try. Please choose your preferred way of communication
It all began one day back in 2022.
I've seen all those cool NFC jukebox projects but found myself too lazy to automate each tag individually.
So, I contributed to the Adonno tagreader project to enable it to push playlist URLs as HAss events.
Here's original story posted on Home Assistant communities.
Since then, TagTuner has been completely refactored and physically redesigned.
All of this is my personal hobby project, available for free download and personal use. If you’d like to support me with a coffee, beer, filament, or electronic parts, feel free to use PayPal paypal.me/lukagra
Links to parts listed above are affiliate links, which allow me to earn a small commission from your purchase. Thank you! 🙏
My work, including yaml files, 3d model and documentation, is licensed under
Creative Commons (4.0 International License) Attribution—Noncommercial—Share Alike
ESPhome components modifications are licensed under ESPHome license