Home

NFCC — NFC Control

Tap an NFC tag → run automations, log habits, and complete to-dos on your phone and PC.

---

NFCC turns a cheap NFC sticker into a universal remote. A single tap can launch apps on your PC, toggle phone state, log actions (like drinking water), clock in at work, or tick off a daily to-do—across multiple devices.

100% free and open source (MIT) — no ads, no tracking, no paid tier, forever.

Latest Release & Downloads • Live Web Demo

---

🌟 Features

• Routines: IF/ELSE branches over time, day, Wi-Fi, and Bluetooth. 28+ phone actions, 32+ PC actions.
• Tracking: Counters for water, coffee, calories, reps; state-aware toggles (home, office, gym, etc.)
• TODOs: Daily streak tracking or one-off tasks, with optional reminders.
• One tag, many jobs: A single tag can fire routines, log multiple trackers, and complete several to-dos in one tap.
• Local-first: Everything runs on your LAN. No cloud account or subscription required.
• NFC Writer: Write URLs, Wi-Fi, phone numbers, SMS, email, location, UPI links, and more.

📁 Repository Structure

nfcc/
├── nfcc_mobile/   # Flutter Android app (phone, web preview)
├── nfcc_pc/       # Python system-tray companion (Windows/macOS/Linux)
├── nfcc-web/      # Next.js landing page + NFC business card host
├── docs/          # Architecture, user guide, NFC data format, etc
└── .github/       # CI/CD pipelines

🚀 Quick Start

Phone (Android)

1. Download the latest APK from Releases.
2. Install and grant NFC + Location + Bluetooth permissions.
3. Open NFC Writer, pick an action, and tap a tag to write.

PC Companion

Windows:

NFCC-Companion.exe

macOS / Linux:

python3 nfcc_pc/main.py

Pair with the phone using the QR code in Settings → Pair PC.

Build from Source

# Mobile
cd nfcc_mobile
flutter pub get
flutter build apk --release --no-tree-shake-icons

# PC companion
cd nfcc_pc
pip install -r requirements.txt
python main.py

# Landing page
cd nfcc-web
npm install && npm run dev

📚 Documentation

• Architecture overview: How phone, PC, and tags interact
• User guide: Routines, tracking, to-dos, tag pairing
• PC networking: Ports, reconnects, firewall, VPN tips
• NFC data format: Tag content spec
• Permissions explained: Why each permission is needed
• F-Droid publishing: Submission workflow

🤝 Contributing

Pull requests are welcome! See CONTRIBUTING.md. Every PR must pass Android, PC, and Web CI workflows before merging.

📜 License

MIT © Yash Patil. See LICENSE for details.

---

NFCC: Tap. Automate. Track. Your habits, one tag at a time.