Track device activity using phone number delivery receipts
T

Track device activity using phone number delivery receipts

Track device activity using phone number delivery receipts

5,024 stars
N/A forks
N/A contributors

README

Project documentation from 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

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Dec 11, 2025