Module: NFC Reader

DRAFT

Allows you to use an PC/SC compatible NFC reader to watch videos associated to NFC Cards/Tags.

We've tested with the ACS ACR122U NFC reader specifically. If you are using a different reader that is also PC/SC compatible but it isn't recognized please let us know.

To Enable

1. Connect a PC/SC compatible NFC Reader (we use and recommend the ACS ACR122U reader)
2. Make sure the necessary drivers are installed
   • On Raspberry Pi:
     • Run the following script from the project root to install the necessary drivers

       sudo ./scripts/setup-nfc-reader.sh`
       

   • On macOS:
     • The PC/SC drivers are included by default on MacOS so plugging in a compatible NFC reader should just work
3. Create a nfc_mapping.json file in the 240-MP data directory
   • On Raspberry Pi: ~/.local/share/240-MP/nfc_mapping.json
   • On macOS: ~/Library/Application Support/240-MP/nfc_mapping.json
4. And add any card UIDs and video paths you'd like to use into that file.
   • Example:

   {
       "7A:12:D0:3D": {
           "path": "/full-path-to-your-video-files/RoboCop (1987).mp4",
           "title": "Robocop (1987)"
       }
   }

   • Mapping values can be absolute paths, relative paths, direct media URLs, or YouTube page URLs (YouTube playback requires yt-dlp to be installed).
   • The "title" property is optional, if its added it will be displayed in the UI as the title of the card
   • Relative paths are resolved from the app/data roots at runtime.
5. Then go to Settings > NFC Reader and set Enabled to On
6. Open NFC Reader from the module list
7. Present a mapped card to start playback