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.

Settings

Option	Values	Info
Enabled	On/Off	Sets if the module should display in the main module list when you start 240-MP.
Resume Playback	Ask/Always/Never	'Ask' will present you with an option to restart playback or resume, 'Always' will resume without asking and 'Never' will restart playback from the beginning without asking
YouTube Video Resolution	480p (Default), 720p, 1080p	Set the resolution of the video to request from YouTube for playback. I recommend to keep this on 480p for the Raspberry Pi on a CRT for best performance
Auto Show Subtitles	On/Off/Forced Only	Sets your preference for subtitle display when starting playback. On means if a subtitle is available then it will be set to display be default (based on your language preference). Forced only means it will attempt to find a subtitle track with a forced flag based on your language preference and if not default to off. Off will default to off =). All options still allow you toggle during playback.
Subtitle Language	[Language]	Sets your preferred language for subtitles and works in conjunction with the Auto Show Subtitles setting

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