Track device activity using phone number delivery receipts
GitHub RepoImpressions6k

Track device activity using phone number delivery receipts

@githubprojectsPost Author

Project Description

View on GitHub

Tracking Device Activity with a Clever SMS Hack

Ever wondered if there was a simpler, more low-level way to see if a device is active on a network? Sometimes, the most interesting solutions come from repurposing existing systems in ways they weren't originally intended. That's exactly the vibe of the Device Activity Tracker project.

Instead of relying on complex polling, push notifications, or battery-draining background services, this tool uses a fundamental, ubiquitous system of mobile networks: SMS delivery receipts.

What It Does

In short, the Device Activity Tracker monitors when a specific mobile device is active by leveraging SMS delivery receipts. You send an SMS to a target phone number. When the recipient's device receives the message and acknowledges it to the carrier, a delivery report is generated. This project listens for those reports.

By tracking the timestamps of these delivery receipts, you can infer the device's recent activity on the cellular network. No message is stored or read; it's all about the metadata of the delivery confirmation.

Why It's Cool

The cleverness here is in the implementation. It's a side-channel attack on device presence, in the best possible sense.

  • No App Required: This method doesn't require any software to be installed on the target device. It works at the carrier level.
  • Battery Efficient (For You): Your tracking system isn't constantly pinging the device. It sends one SMS and waits for a network-level callback.
  • Stealthy: The target might receive a blank or harmless SMS (depending on your provider), but the primary data point is the unseen delivery receipt.
  • Simple Tech Stack: The provided implementation is straightforward, focusing on the core logic of sending an SMS and processing the webhook callback for the delivery receipt. It's a great learning project for understanding telecom APIs.

Potential use cases for developers could include prototyping simple asset tracking, creating custom "device online" status checkers, or understanding the flow of telecom webhooks.

How to Try It

The complete code and setup instructions are available on GitHub. You'll need a few things to get started:

  1. Clone the repo: git clone https://github.com/gommzystudio/device-activity-tracker
  2. Get an SMS API Provider: You'll need an account with a service like Twilio, Plivo, or Vonage that supports programmable SMS and delivery receipt webhooks.
  3. Configure the Project: Set your API credentials and phone numbers in the configuration. The core logic will involve sending an SMS and setting up a webhook endpoint (like /delivery-receipt) that the provider will call.
  4. Run and Monitor: Start the service, send a test SMS, and watch for the delivery receipt POST request to your endpoint. The timestamp in that receipt is your activity signal.

Check the repository's README for specific code examples and configuration details.

Final Thoughts

This project is a neat example of thinking outside the box. It's not a full-blown, production-ready monitoring system, but it's a fascinating proof-of-concept. For developers, it opens up a different way to think about device presence and demonstrates how to creatively use the hidden signals in everyday infrastructure. It's the kind of hack that makes you look at a basic technology like SMS in a whole new light.

What would you build with this kind of low-level activity trigger?


@githubprojects

Back to Projects
Project ID: b7728906-b081-4505-a912-1b4749bf79e6Last updated: December 12, 2025 at 11:12 AM