{"id":18026310,"url":"https://github.com/surge-tech/rfid-triggered-audio-system","last_synced_at":"2026-05-08T14:07:46.475Z","repository":{"id":258906770,"uuid":"873963489","full_name":"Surge-Tech/RFID-Triggered-Audio-System","owner":"Surge-Tech","description":"RFID tag reader that plays a specific audio when the correct tag is read.","archived":false,"fork":false,"pushed_at":"2024-10-29T20:40:44.000Z","size":1724,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-30T10:45:28.177Z","etag":null,"topics":["arduino","dfplayer","dfplayer-mini","esp32","esp32-arduino","oled","rfid"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Surge-Tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-17T02:47:20.000Z","updated_at":"2024-10-29T20:40:48.000Z","dependencies_parsed_at":"2024-12-17T23:10:57.262Z","dependency_job_id":"bbfdeefd-ef20-4d62-afcb-e0a3c551fdf0","html_url":"https://github.com/Surge-Tech/RFID-Triggered-Audio-System","commit_stats":null,"previous_names":["surge-tech/rfid-triggered-audio-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Surge-Tech/RFID-Triggered-Audio-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surge-Tech%2FRFID-Triggered-Audio-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surge-Tech%2FRFID-Triggered-Audio-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surge-Tech%2FRFID-Triggered-Audio-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surge-Tech%2FRFID-Triggered-Audio-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Surge-Tech","download_url":"https://codeload.github.com/Surge-Tech/RFID-Triggered-Audio-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surge-Tech%2FRFID-Triggered-Audio-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272839677,"owners_count":25001862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","dfplayer","dfplayer-mini","esp32","esp32-arduino","oled","rfid"],"created_at":"2024-10-30T08:06:06.059Z","updated_at":"2026-05-08T14:07:46.371Z","avatar_url":"https://github.com/Surge-Tech.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RFID-Triggered-Audio-System\nThis project is an RFID-based audio player that uses an OLED display for user feedback. When an authorized RFID tag is scanned, a corresponding audio file is played through the DFPlayer Mini. The OLED screen provides status updates throughout the process.\n\nFor a detailed guide on building this project visit the [Instructables Page](https://www.instructables.com/RFID-Triggered-Audio-System/).\n\n## Features\nOLED Display for visual feedback (Adafruit SSD1306 128x32).\nRFID Reader (MFRC522) to scan RFID tags and trigger specific audio tracks.\nDFPlayer Mini to play audio files stored on an SD card.\nSystem ready and error messages are displayed on the OLED screen.\n\n## Libraries Required:\nEnsure you have the following libraries installed before uploading the code:\n\n* Adafruit GFX Library\n* Adafruit SSD1306 Library\n* MFRC522 Library\n* DFRobotDFPlayerMini Library\n\n## Hardware Setup\nOLED Display 128x32\nRFID Reader (MFRC522)\nDFPlayer Mini with an SD card containing the audio files\nMicrocontroller (ESP32/Arduino)\n\n#### Pin Connections for Arduino Uno:\n* OLED GND GND\n* OLED VCC 5V\n* OLED (SCL) SCK\tA5\n* OLED SDA A4\n* RFID RST 9\n* RFID SDA 10\n* DFPlayer Mini RX 4\n* DFPlayer Mini TX 5 **1kOhm resistor inbetween**.\n* DFPlayer Mini BUSY 6\n\nMore pinouts for the RFID module can be found on the [RC522 GitHub](https://github.com/miguelbalboa/rfid?tab=readme-ov-file#pin-layout)\nNote: You can modify DFPlayerMini pins numbers according to your setup if needed.\n\n## Wiring Diagram\n\n![Schematic](https://github.com/user-attachments/assets/5ef1caef-6a3c-463e-a8b5-e1f78cf70442)\n\nUsing an Arduino Nano\n\n* \u003ca href=\"https://lab.arts.ac.uk/uploads/images/gallery/2022-11/aquNhFLaNisOaPu5-dfplayerpinout.png\" target=\"_blank\"\u003eDFPlayerMini Pinout\u003c/a\u003e\n* \u003ca href=\"https://electropeak.com/learn/wp-content/uploads/2020/12/OLED-0.91INCH-pin.jpg\" target=\"_blank\"\u003eOLED Screen Pinout\u003c/a\u003e\n* \u003ca href=\"https://www.electrovigyan.com/wp-content/uploads/2021/04/pinout.jpg\" target=\"_blank\"\u003eRFID-RC522 Pinout\u003c/a\u003e\n\n## How to Use\n#### Prepare the RFID Tags:\nReplace the 00 values in the tagUIDs array with the actual UID values of your RFID tags.\nUse the DumpInfo code that comes with the RFID library to find the UID of each tag.\n\n#### Prepare the SD Card for DFPlayer Mini:\nStore the audio files on the SD card. The files should be named 0001.mp3, 0002.mp3, and so on.\nInsert the SD card into the DFPlayer Mini.\nSD card should be 32gb or less.\n\n#### Upload Code:\nUse the Arduino IDE to upload the code to your Arduino board.\nEnsure all the libraries listed above are installed in the Arduino IDE.\n\n#### Operation:\nPower up the system.\nThe OLED will display system status such as \"Equipment Activated\" and \"Ready to Scan.\"\nScan an RFID tag, and if the tag is recognized, the corresponding audio file will play. If the tag is not recognized, an error message will appear on the OLED.\n\n## License:\nThis project is open source and licensed under the MIT License. Contributions are welcome!\n\n## Audio Files:\nIncluded example audio files in the audio folder. I do not own any of the sounds included in the folder.\n\n## Examples:\nThe original idea for this project was to be implimented as a mobile device to scan prop audio survalence devices in an escape room. \n\nCan be hooked up to an amplifier and used as a stand-alone audio player. \n\n## Future Improvements\nImplement additional features such as multi-language support for the OLED messages.\nAdd support for multiple audio files per tag, cycling through tracks.\nImprove error handling and reporting.\n\nFeel free to customize further or reach out with questions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurge-tech%2Frfid-triggered-audio-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsurge-tech%2Frfid-triggered-audio-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurge-tech%2Frfid-triggered-audio-system/lists"}