Make blacklist universal for linux

Author: coffandro

.goreleaser.yaml

@@ -64,6 +64,9 @@ nfpms:
       - src: ./build/linux/nfc-agent.desktop
         dst: /usr/share/applications/nfc-agent.desktop
         type: config
+      - src: ./build/linux/blacklist-nfc-pn533.conf
+        dst: /etc/modprobe.d/blacklist-nfc-pn533.conf
+        type: config
     scripts:
       postinstall: ./build/linux/postinstall.sh
 

README.md

@@ -100,38 +100,22 @@ sudo systemctl enable --now pcscd
 
 > **Note:** Unlike the `.deb` and `.rpm` packages, the tar.gz installation requires manual setup of the PC/SC daemon. If you see "No readers found", ensure `pcscd` is running (`systemctl status pcscd`).
 
-**Atomic Linux Distributions (Fedora Silverblue, Kinoite, etc.) with Distrobox:**
+**Kernel Module Fix (tar.gz installations only)**
 
-For immutable/atomic distributions, you can run NFC Agent inside a distrobox container while applying kernel fixes on the host OS:
+The `.deb` and `.rpm` packages automatically install the kernel module blacklist and unload conflicting modules. For tar.gz installations, you need to do this manually:
 
-1. **On the host OS** - Apply the kernel module blacklist (required for ACR122U and similar readers):
-   ```bash
-   # Create blacklist file on the host
-   echo -e "blacklist pn533_usb\nblacklist pn533\nblacklist nfc" | sudo tee /etc/modprobe.d/blacklist-pn533.conf
-
-   # Unload modules if currently loaded
-   sudo modprobe -r pn533_usb pn533 nfc 2>/dev/null || true
-
-   # Restart PC/SC daemon on host
-   sudo systemctl restart pcscd
-   ```
-
-2. **Inside distrobox** - Install the package:
-   ```bash
-   # Enter your distrobox container (e.g., Fedora-based)
-   distrobox enter fedora
+```bash
+# Blacklist conflicting kernel modules
+echo -e "blacklist pn533_usb\nblacklist pn533\nblacklist nfc" | sudo tee /etc/modprobe.d/blacklist-nfc-pn533.conf
 
-   # Install the RPM package
-   sudo dnf install ./NFC-Agent-*.rpm
-   ```
+# Unload modules if currently loaded
+sudo modprobe -r pn533_usb pn533 nfc 2>/dev/null || true
 
-3. **Run from distrobox** - Start NFC Agent from within the container:
-   ```bash
-   distrobox enter fedora
-   nfc-agent
-   ```
+# Restart PC/SC daemon
+sudo systemctl restart pcscd
+```
 
-> **Note:** The kernel module blacklist must be applied on the host OS because the kernel is shared between the host and containers. The pcscd service also runs on the host and is accessible from within distrobox.
+> **Atomic Distributions (Fedora Silverblue, Kinoite, etc.):** You can run NFC Agent inside a distrobox container. Install the `.rpm` package in the container—the blacklist file will be installed to the shared `/etc/modprobe.d/` on the host. Alternatively, apply the kernel module fix manually on the host OS, then run `nfc-agent` from the container.
 
 ## Quick Start
 
@@ -308,28 +292,11 @@ NFC Agent uses the PC/SC (Personal Computer/Smart Card) interface to communicate
    ```
 3. Try unplugging and reconnecting the reader
 
-**Linux: Kernel NFC modules conflict (ACR122U)**
-
-The Linux kernel's NFC subsystem (`pn533_usb`) may claim ACR122U readers before pcscd can access them. Check with:
-```bash
-lsmod | grep pn533
-```
+**Linux: Kernel NFC modules conflict**
 
-If modules are loaded, unload them and blacklist:
-```bash
-# Temporary fix
-sudo modprobe -r pn533_usb pn533 nfc
-sudo systemctl restart pcscd
+The Linux kernel's NFC subsystem may claim certain readers before pcscd can access them. The `.deb` and `.rpm` packages handle this automatically. For tar.gz installations, check with `lsmod | grep pn533`—if modules are loaded, follow the **Kernel Module Fix** steps in the [Linux installation section](#linux).
 
-# Permanent fix - create blacklist file
-echo -e "blacklist pn533_usb\nblacklist pn533\nblacklist nfc" | sudo tee /etc/modprobe.d/blacklist-pn533.conf
-```
-
-**Arch Linux with ACS readers:** Install the `acsccid` driver from AUR:
-```bash
-yay -S acsccid
-sudo systemctl restart pcscd
-```
+**Arch Linux with ACS readers:** Install the `acsccid` driver from AUR (`yay -S acsccid`) and restart pcscd.
 
 ### "Failed to connect to card"
 

build/linux/blacklist-nfc-pn533.conf

@@ -0,0 +1,7 @@
+# Blacklist kernel NFC modules that conflict with PC/SC daemon (pcscd)
+# These modules may claim NFC readers (especially ACR122U) before pcscd can access them
+# Installed by NFC Agent package
+
+blacklist pn533_usb
+blacklist pn533
+blacklist nfc

build/linux/postinstall.sh

@@ -1,11 +1,20 @@
 #!/bin/bash
 # Post-installation script for NFC Agent
 
+# Unload kernel NFC modules that conflict with pcscd (if loaded)
+# The blacklist config file prevents them from loading on next boot
+if lsmod | grep -q pn533; then
+    echo "Unloading conflicting kernel NFC modules..."
+    modprobe -r pn533_usb 2>/dev/null || true
+    modprobe -r pn533 2>/dev/null || true
+    modprobe -r nfc 2>/dev/null || true
+fi
+
 # Ensure pcscd is running (required for NFC readers)
 if command -v systemctl &> /dev/null; then
     # Enable and start pcscd if available
     systemctl enable pcscd 2>/dev/null || true
-    systemctl start pcscd 2>/dev/null || true
+    systemctl restart pcscd 2>/dev/null || true
 fi
 
 # Copy systemd user service to system location for all users