{"id":39553809,"url":"https://github.com/0penpublic/onhit","last_synced_at":"2026-05-02T09:01:56.818Z","repository":{"id":332975729,"uuid":"1125964641","full_name":"0penPublic/onHit","owner":"0penPublic","description":"Trigger Android NFC events without a physical tag by Xposed.","archived":false,"fork":false,"pushed_at":"2026-04-17T19:22:49.000Z","size":446,"stargazers_count":50,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-17T21:25:36.778Z","etag":null,"topics":["android-app","ezxhelper","ndef","ndef-nfc","ndef-record","ndef-replay","nfc","rfid","xposed","xposed-module"],"latest_commit_sha":null,"homepage":"https://github.com/Xposed-Modules-Repo/mba.vm.onhit","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0penPublic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-31T18:40:20.000Z","updated_at":"2026-04-17T19:22:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0penPublic/onHit","commit_stats":null,"previous_names":["0penpublic/onhit"],"tags_count":7,"template":false,"template_full_name":"KyuubiRan/EzXHepler-template","purl":"pkg:github/0penPublic/onHit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0penPublic%2FonHit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0penPublic%2FonHit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0penPublic%2FonHit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0penPublic%2FonHit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0penPublic","download_url":"https://codeload.github.com/0penPublic/onHit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0penPublic%2FonHit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"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":["android-app","ezxhelper","ndef","ndef-nfc","ndef-record","ndef-replay","nfc","rfid","xposed","xposed-module"],"created_at":"2026-01-18T06:59:55.657Z","updated_at":"2026-05-02T09:01:56.805Z","avatar_url":"https://github.com/0penPublic.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# onHit\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/0penPublic/onHit/refs/heads/main/onhit-logo.svg\" alt=\"icon\" width=\"150\" /\u003e\n\n![Release Download](https://img.shields.io/github/downloads/Xposed-Modules-Repo/mba.vm.onhit/total?style=flat-square)\n![Release Download](https://img.shields.io/github/downloads/0penPublic/onHit/total?style=flat-square)\n[![Release Version](https://img.shields.io/github/v/release/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/releases/latest)  \n[![GitHub Star](https://img.shields.io/github/stars/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/stargazers)\n[![GitHub Star](https://img.shields.io/github/stars/Xposed-Modules-Repo/mba.vm.onhit?style=flat-square)](https://github.com/Xposed-Modules-Repo/mba.vm.onhit/stargazers)\n[![GitHub Fork](https://img.shields.io/github/forks/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/network/members)\n![GitHub Repo size](https://img.shields.io/github/repo-size/0penPublic/onHit?style=flat-square\u0026color=3cb371)\n[![GitHub license](https://img.shields.io/github/license/0penPublic/onHit?style=flat-square)](LICENSE)\n[![GitHub Repo Languages](https://img.shields.io/github/languages/top/0penPublic/onHit?style=flat-square)](https://github.com/0penPublic/onHit/search?l=kotlin)\n[![Telegram](https://img.shields.io/badge/Telegram-on_hit-blue.svg?style=flat-square\u0026color=12b7f5)](https://t.me/on_hit)\n\n\u003c/div\u003e\n\n## 什么是 onHit ?\n\n这是一个 **Xposed 模块**，用于在 **系统内部模拟 NFC 标签触碰事件**，从而触发系统对 **NDEF 数据** 的解析与分发流程，使目标应用能够像接收到真实 NFC 标签一样处理 NDEF 内容。\n\n模块内置了一个 **简易的文件管理器**，用于：\n\n - 从实体 NFC 标签中读取并保存 **NDEF 数据（原始字节流）**\n\n - 将已保存的 **NDEF 文件**写入实体 NFC 标签\n\nNDEF 的 读写过程完全基于 Android 官方公开 API 实现，理论上在不使用 Xposed 的情况下也可独立运行；\n\nXposed 仅用于实现 **“无实体标签的 NDEF 重放”**，即在系统层直接注入 NFC 触碰事件，这是普通应用无法完成的部分。\n\n## What is onHit?\n\nonHit is an **Xposed module** that simulates **NFC tag touch events at the system level**, allowing the Android system to parse **NDEF data** and dispatch NFC events as if a real NFC tag were presented.\n\nThe module includes a **simple built-in file manager** that can:\n\n- Extract and store **NDEF data (raw byte streams)** from physical NFC tags\n- Write previously saved **NDEF files** back to physical NFC tags\n\nAll NDEF read and write operations are implemented using **Android’s public system APIs** and can function independently without Xposed.\n\nXposed is only required to enable **tagless NDEF replay**, which injects NFC tag events directly into the system — a capability not available to regular applications.\n\n## Requirements / 使用需求\n\n- `Rooted Android device` \n\n  `已有 Root 权限的 Android 设备`\n- `Dreamland` or `LSPosed` etc. Environment\n  \n  `Dreamland` 或者 `LSPosed` 之类的环境\n- Android system with AOSP-like NFC framework (vendor ROMs may vary) \n\n  AOSP 类似的 NFC 框架 (部分手机厂商私有的实现可能会无法使用)\n\n## How to Use / 如何使用\n\n 1. Install the onHit application. \n    \n    安装 onHit 应用程序。\n 2. **Enable Module**: If you have an *Xposed environment*, enable `onHit` and scope it to **NFC Service** (`com.android.nfc`). \n \n    **启用模块**：在 *Xposed 环境*中激活 `onHit` 并勾选 **NFC 服务** (`com.android.nfc`)。\n 3. **Setup Storage**: Open `onHit` and choose a directory to store your NDEF files.\n\n    **设置存储**：打开 `onHit` 并选择一个用于存放 NDEF 文件的文件夹。\n 4. **Import**: *Import NDEF data* from a physical NFC tag or local files.\n\n    **导入**：从实体 NFC 标签或本地文件*导入 NDEF 数据*\n\n 5. **Replay (Xposed Required)**: Click an NDEF file in the list. The module will triggering the Android NFC dispatch system as if a real tag were detected.\n\n    **(需要 Xposed) 重放/模拟**：在文件列表中点击 NDEF 文件。模块将触发 Android 系统的 NFC 分发流程。\n \n## Acknowledgments\n Special thanks to the following projects for their invaluable contributions to the community:\n - [LSPosed](https://github.com/LSPosed/LSPosed)\n - [ExXHelper](https://github.com/KyuubiRan/EzXHelper)\n - [AndroidX](https://developer.android.com/jetpack/androidx)\n \n    ...\n\n## Limitations\n\n- Strongly dependent on Android version and vendor NFC implementation\n- Some OEM frameworks may modify or restrict NFC internals\n- Not intended for production use\n- No guarantee of compatibility across devices or ROMs\n\n## Legal \u0026 Ethical Notice\n\nThis project is intended for **research, learning, and testing purposes only**.\n\nDo NOT use this project to:\n- Bypass security mechanisms without authorization\n- Attack or impersonate real-world NFC systems\n- Violate laws, terms of service, or privacy policies\n\nYou are solely responsible for how you use this software.\n\n## License\n\nThis project is licensed under the **GNU General Public License v2.0 (GPLv2)**.\n\nYou may use, modify, and redistribute this software under the terms of GPLv2.\nAny derivative work must also be distributed under the same license.\n\nSee the `LICENSE` file for full license text.\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/#0penPublic/onHit\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=0penPublic/onHit\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=0penPublic/onHit\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=0penPublic/onHit\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0penpublic%2Fonhit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0penpublic%2Fonhit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0penpublic%2Fonhit/lists"}