> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Desktop NFC: full read and write support via the NFC Agent app

# Full NFC read and write on desktop with NFC Agent

Want to read and write NFC filament tags from your computer? **NFC Agent** is SimplyPrint's open-source desktop software that gives you full NFC capabilities - read any tag, write any format, and manage your filament inventory without ever touching your phone.

This is the most powerful NFC method available. It works on Mac, Windows, and Linux, supports **every tag type and every standard**, and once set up, integrates seamlessly with SimplyPrint's web panel.

This article covers everything about NFC Agent. For a general introduction to NFC in 3D printing, see our [main NFC article](https://help.simplyprint.io/en/article/19luyni/).

---

# What you need

To use NFC Agent, you'll need:

1. **A compatible USB NFC reader** - Not any NFC reader will do; you need one that works with the PC/SC standard. We recommend ACS-brand readers (more on that below).

2. **NFC Agent software** - Our free, open-source application that bridges your USB reader to SimplyPrint.

3. **A computer** - Mac, Windows, or Linux. Sorry, Chromebooks - they can't install traditional software.

||| **Safari users:** Safari requires extra steps to connect to NFC Agent. If you're using Safari, see [Safari not connecting to DYMO, Zebra, or NFC Agent](https://help.simplyprint.io/en/article/safari-not-connecting-to-dymo-zebra-or-nfc-agent-evi914/) before continuing.

---

# Why use NFC Agent?

NFC Agent is for users who want the **full desktop experience** - no phone needed, no app switching, everything in your browser.

**Best for:**
* Managing large filament inventories from your desk
* Batch-writing tags for multiple spools
* Users who prefer keyboard and mouse over phone tapping
* Print farms that need a dedicated workstation for filament management
* Anyone who wants the most complete tag type support

**How it works:**
1. You plug in a USB NFC reader
2. NFC Agent runs in the background, acting as a bridge between your reader and your browser
3. SimplyPrint's web panel automatically detects NFC Agent and unlocks the read/write features
4. Place a tag on your reader - SimplyPrint sees it instantly

No manual configuration needed. Install the software, plug in the reader, and SimplyPrint handles the rest.

---

# Limitations

Let's be upfront about what NFC Agent can and can't do:

| What works | What doesn't |
| ---- |
| All tag types (NTAG, MIFARE, ICODE SLIX, etc.) | Chromebooks (can't install software) |
| All standards (OpenPrintTag, QIDI, Creality, etc.) | Cheap "keyboard" USB readers |
| Mac, Windows, Linux | Remote computers (reader must be local) |
| Full read + write capabilities |  |
| Background operation |  |

|| NFC Agent requires a **smart card reader**, not the cheap USB dongles that just type out tag IDs. Those keyboard-style readers are fine for linking existing tags, but can't write anything.

---

# Which standards work with NFC Agent?

Short answer: **all of them**.

NFC Agent supports every NFC tag type, which means every filament standard works. This is the only desktop method that can handle OpenPrintTag's ICODE SLIX tags.

| Standard | NFC Agent support | Notes |
| ---- |
| OpenPrintTag | ✅ | Requires ACR1552U reader |
| OpenSpool | ✅ | Any supported reader |
| OpenTag | ✅ | Any supported reader |
| QIDI | ✅ | Any supported reader |
| Creality CFS | ✅ | Any supported reader |
| Anycubic ACE | ✅ | Any supported reader |
| Bambu Lab | ✅ | Read-only (no spec for writing) |
| SimplyPrint URL | ✅ | Any supported reader |

| OpenPrintTag uses a special tag type (ICODE SLIX) that only the ACR1552U reader can handle. If you want full OpenPrintTag support, get that specific reader.

---

# Supported hardware

NFC Agent works with **ACS-brand smart card readers** using the PC/SC standard. These are professional-grade readers - not the cheap keyboard-emulating dongles.

## Recommended readers

| Reader | Price range | Best for | Buy |
| ---- |
| **ACR1552U** | ~$80-100 | Everything - supports ALL tag types including ICODE SLIX | [Amazon](https://amzn.to/48KvK4v) |
| **ACR122U** | ~$30-40 | Budget option - most common tags | [Amazon](https://amzn.to/48NzOkF) |
| **ACR1252U** | ~$50-60 | Mid-range - good all-rounder | [Amazon](https://amzn.to/48Ne1tb) |
| **ACR1255U-J1** | ~$70-80 | Bluetooth + USB - portable option | [Amazon](https://amzn.to/3KNB1Aj) |

*Some links are affiliate links. We may earn a commission at no extra cost to you.*

## Which reader should I buy?

**If you want one reader that does everything:** Get the **ACR1552U**. It's the only reader that supports ICODE SLIX tags (used by OpenPrintTag/Prusa). Yes, it's the most expensive, but it's future-proof.

**If you're on a budget and don't need OpenPrintTag:** The **ACR122U** is the most affordable option and handles QIDI, Creality, Anycubic, OpenSpool, and OpenTag just fine.

**If you want wireless flexibility:** The **ACR1255U-J1** has Bluetooth, so you can walk around your print farm and scan tags without being tethered to your computer.

## Other supported readers

NFC Agent also works with readers from other manufacturers:
* SCM Microsystems (SCR3310)
* Identiv (uTrust series)
* HID Global (OMNIKEY series)

If you already have a PC/SC-compatible reader lying around, it's worth trying - it might just work.

---

# Installation

NFC Agent is free and open-source. Download it from GitHub:

**GitHub repository:** https://github.com/SimplyPrint/nfc-agent/

## macOS

**Option 1: Download the installer**
1. Go to the [GitHub Releases page](https://github.com/SimplyPrint/nfc-agent/releases)
2. Download the `.dmg` file for your Mac (Intel or Apple Silicon)
3. Open the DMG and drag NFC Agent to your Applications folder
4. Launch NFC Agent - it'll ask for permission to run in the background

**Option 2: Install via Homebrew**
```
brew install simplyprint/tap/nfc-agent
```

That's it for Mac - no drivers needed. macOS has built-in PC/SC support.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_y42pv0.png)

## Windows

1. Go to the [GitHub Releases page](https://github.com/SimplyPrint/nfc-agent/releases)
2. Download the `.exe` installer
3. Run the installer and follow the prompts - if it complains about "Unknown publisher", click "Learn more" and "Run anyways"
4. NFC Agent will start automatically and appear in your system tray

Windows also has built-in PC/SC support, so no additional drivers are needed for most ACS readers.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_100fmoa.png)

## Linux

Linux requires a few extra steps because the PC/SC daemon needs to be installed and running.

### Debian / Ubuntu

```bash
# Install the .deb package
sudo apt install ./NFC-Agent-*.deb

# Start the PC/SC daemon
sudo systemctl enable --now pcscd
```

### Fedora / RHEL

```bash
# Install the .rpm package
sudo dnf install ./NFC-Agent-*.rpm

# Start the PC/SC daemon
sudo systemctl enable --now pcscd
```

### Arch Linux

```bash
# Install required packages
pacman -S pcsclite ccid

# Extract the tar.gz to /opt or your preferred location
# Start the PC/SC daemon
sudo systemctl enable --now pcscd
```

### Important: Blacklist kernel NFC modules

Linux has a built-in NFC subsystem that can conflict with NFC Agent. You'll need to blacklist these kernel modules:

1. Create the blacklist file:
```bash
sudo nano /etc/modprobe.d/blacklist-nfc-pn533.conf
```

2. Add these lines:
```
blacklist pn533
blacklist pn533_usb
blacklist nfc
```

3. Reboot your computer

Without this step, your reader might not be detected properly.

---

# Setting up NFC Agent with SimplyPrint

Once NFC Agent is installed and running, SimplyPrint detects it automatically. There's no manual linking or configuration required.

## Verifying the connection

1. Make sure NFC Agent is running (check your menu bar / system tray)
2. Open SimplyPrint in your browser: `https://simplyprint.io/panel`
3. Go to the **Filament** section
4. Click on any spool, then look for the NFC options

If NFC Agent is detected, you'll see options for reading and writing NFC tags. If not, you'll see a message prompting you to install NFC Agent.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_v5qi4o.png)

## How the connection works

NFC Agent runs a small local server on your computer (port 32145 by default). When you open SimplyPrint in your browser, it checks if this local server is available. If it is, all the NFC features light up.

This means:
* **NFC Agent must be running** for the features to work
* **The browser and NFC Agent must be on the same computer** - you can't use a reader plugged into a different machine
* **No internet required for the connection** - the browser talks directly to NFC Agent on localhost

---

# How to read NFC tags

Reading tags with NFC Agent is straightforward:

1. **Make sure NFC Agent is running** - Check your menu bar or system tray
2. **Plug in your USB reader** - Wait for the LED to light up
3. **Open SimplyPrint** and go to **Filament**
4. **Click "Scan NFC"** or open a spool and click "Link NFC tag"
5. **Place the tag on your reader** - The tag data appears instantly

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_1amhlja.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_za7hw0.png)

## What you'll see

Depending on the tag type and what's written on it, you'll see different information:

* **Tag UID** - The unique identifier (always present)
* **Standard detected** - OpenSpool, QIDI, Creality, etc.
* **Filament data** - Material type, color, brand (if encoded on the tag)
* **Matching spool** - If the tag is already linked to a spool in your inventory

---

# How to write NFC tags

Writing tags lets you create new NFC stickers for your filament spools in any format you want.

## Step-by-step: Writing a tag

1. **Open SimplyPrint** and go to **Filament**
2. **Select or create a spool** you want to write a tag for
3. **Click "Write NFC tag"** in the spool options
4. **Choose the format** - Pick from OpenPrintTag, OpenSpool, QIDI, Creality, Anycubic, or SimplyPrint URL
5. **Place a blank tag on your reader**
6. **Click "Write"** - The tag is written and automatically linked to your spool

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_y4kyjx.png)

## Choosing the right format

Not sure which format to use? Here's a quick guide:

| If you have... | Use this format |
| ---- |
| QIDI Box printer | QIDI |
| Creality K2/HI with CFS | Creality CFS |
| Anycubic printer with ACE | Anycubic ACE |
| Prusa XL or compatible | OpenPrintTag |
| OpenSpool-compatible hardware | OpenSpool |
| Just want phone scanning | OpenSpool or OpenTag |
| No specific hardware, just inventory | SimplyPrint URL |

| Remember: The format you choose affects which hardware can read the tag. A QIDI tag won't work in a Creality CFS, and vice versa.

---

# How to link existing tags

If you have spools with NFC tags already on them (like official Bambu Lab or QIDI filament), you can link those tags to your SimplyPrint inventory without overwriting them.

1. **Create or find the spool** in your SimplyPrint inventory
2. **Click "Link NFC tag"**
3. **Place the existing tag on your reader**
4. **Confirm the link**

Now when you scan that tag, SimplyPrint knows exactly which spool it belongs to. This is useful for:
* Branded filament with factory NFC tags
* Tags you've written with other tools
* Keeping your physical and digital inventory in sync

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/image_4hua8u.png)
---

# Troubleshooting

## NFC Agent isn't detected by SimplyPrint

**Check if NFC Agent is running:**
* Look for the NFC Agent icon in your menu bar (Mac) or system tray (Windows)
* On Linux, check with `ps aux | grep nfc-agent`

**Try restarting NFC Agent:**
* Quit and relaunch the application

**Check your browser:**
* NFC Agent works best with Chrome, Edge, or Firefox
* Make sure you're accessing SimplyPrint over HTTPS

**Make sure NFC Agent is up to date:**
* Visit the [GitHub releases page](https://github.com/SimplyPrint/nfc-agent/releases) and check if you're running the latest version
* Older versions may have compatibility issues with newer browsers or SimplyPrint updates

## Safari won't connect to NFC Agent

**Problem:** You're using Safari and SimplyPrint can't detect NFC Agent, even though it's running.

**Solution:** Safari requires you to manually trust the local certificate used by NFC Agent. See our dedicated guide: [Safari not connecting to DYMO, Zebra, or NFC Agent](https://help.simplyprint.io/en/article/safari-not-connecting-to-dymo-zebra-or-nfc-agent-evi914/)

| Alternatively, use Chrome, Firefox, or Edge - these browsers work without extra configuration.

## Reader not detected

**Check the USB connection:**
* Try a different USB port
* Try a different USB cable
* Make sure the reader's LED lights up when plugged in

**On Linux, check pcscd:**
```bash
sudo systemctl status pcscd
```

If it's not running:
```bash
sudo systemctl start pcscd
```

**On Linux, check for kernel module conflicts:**
Make sure you've blacklisted the `pn533` and `nfc` modules as described in the installation section.

## Card not detected when placed on reader

**Check the reader LED:**
* Most readers have an LED that changes when a card is detected
* If the LED doesn't change, the card isn't being read

**Try repositioning the card:**
* NFC readers have a "sweet spot" - usually the center of the reader
* Make sure the card is flat against the reader surface

**Try a different card:**
* Some cards may be damaged or incompatible
* Test with a known-good card to isolate the issue

## Write operation fails

**Check the card type:**
* Make sure you're using the right tag type for the format you're writing
* QIDI and Creality require MIFARE Classic 1K
* OpenPrintTag requires ICODE SLIX

**Check if the card is locked:**
* Some tags can be permanently locked after writing
* If a tag is locked, you'll need a fresh one

**Check for write protection:**
* Some tags come with factory write protection
* Look for "writable" or "blank" tags when purchasing

---

# When to use NFC Agent vs other methods

Here's how NFC Agent compares to the other ways you can do NFC in SimplyPrint:

| Method | Best for | Limitations |
| ---- |
| **NFC Agent** | Desktop users, batch operations, full format support | Requires hardware purchase and software install |
| **Mobile app** | Quick scans, on-the-go inventory | Some formats don't work on iOS |
| **Web NFC** | Quick Android-only tasks, no app install | No iOS, no MIFARE Classic, limited browser support |
| **USB keyboard reader** | Cheapest option, just linking existing tags | Read-only, can't write tags |

**Choose NFC Agent if:**
* You want to do everything from your computer
* You need to write tags (not just read them)
* You want support for ALL tag types and standards
* You're writing tags for OpenPrintTag (Prusa) - only ACR1552U can handle these
* You're managing a large inventory and want efficiency

**Choose mobile app if:**
* You already have a phone with NFC
* You want the simplest setup (no hardware to buy)
* You're mostly scanning and don't need heavy batch operations

---

# Technical details

This section is for the curious - you don't need this to use NFC Agent, but it might help if you're troubleshooting or want to understand what's happening under the hood.

## How NFC Agent communicates

NFC Agent runs a local HTTP and WebSocket server on port 32145 (by default). When SimplyPrint's web panel loads, it checks for this local server. If it finds it, the panel can:

* List connected readers
* Detect when cards are placed or removed (via WebSocket events)
* Read card data in various formats
* Write data to cards
* Handle authentication for MIFARE Classic cards

## Supported tag types

| Tag type | Read | Write | Notes |
| ---- |
| NTAG213/215/216 | ✅ | ✅ | Most common for OpenSpool, OpenTag, Anycubic |
| NTAG424 DNA | ✅ | ✅ | Newer, more secure variant |
| MIFARE Classic 1K/4K | ✅ | ✅ | Used by QIDI, Creality, Bambu Lab |
| MIFARE Ultralight | ✅ | ✅ | Used by some Anycubic tags |
| MIFARE DESFire | ✅ | ✅ | Advanced secure tags |
| ICODE SLIX / SLIX2 | ✅ | ✅ | OpenPrintTag - requires ACR1552U |
| ISO 14443 Type A/B | ✅ | ✅ | General standard |
| FeliCa | ✅ | Limited | Japanese standard, not common in 3D printing |

## Environment variables

You can configure NFC Agent with these environment variables:

| Variable | Default | Description |
| ---- |
| `NFC_AGENT_PORT` | 32145 | Port for the local server |
| `NFC_AGENT_HOST` | 127.0.0.1 | Host address (keep as localhost for security) |

## Open source

NFC Agent is fully open source under the GNU Affero General Public License v3.0. You can view the code, report issues, and contribute at:

**GitHub:** https://github.com/SimplyPrint/nfc-agent/

---

# Quick reference

| **Method** | NFC Agent (desktop software + USB reader) |
| **Platforms** | Mac, Windows, Linux |
| **Read support** | ✅ All tag types |
| **Write support** | ✅ All standards |
| **Required hardware** | ACS USB reader (ACR122U, ACR1252U, ACR1255U, ACR1552U) |
| **Required software** | NFC Agent (free, open-source) |
| **OpenPrintTag support** | ✅ (ACR1552U only) |
| **QIDI support** | ✅ |
| **Creality CFS support** | ✅ |
| **Anycubic ACE support** | ✅ |
| **OpenSpool support** | ✅ |
| **OpenTag support** | ✅ |
| **Bambu Lab support** | ✅ Read / ❌ Write |
| **Price range** | $30-100 for reader |
| **Setup difficulty** | Medium (install software + buy hardware) |

---

# Related articles

* [NFC / RFID support in SimplyPrint](https://help.simplyprint.io/en/article/19luyni/) - Hardware, methods, and step-by-step guides
* Reading and writing NFC tags with the SimplyPrint app - The mobile method
* Reading and writing NFC tags via your browser (Web NFC) - The no-app Android method
* Reading NFC tag IDs with a USB reader - The cheap read-only method
* The Filament Manager feature - Managing your filament inventory