📱 Android SIM, Call & SMS Logs

A comprehensive package for retrieving SIM card details, call history, and SMS logs programmatically on Android devices.

This repository simplifies the process of querying Android's internal Telephony and Content Provider APIs. It handles cursors, background querying, and data mapping so you can easily access device communications data with minimal boilerplate.

---

✨ Features

• 📶 SIM Information: Read active carrier names, SIM slot indexes, phone numbers, network types, and subscription details.
• 📞 Call Logs: Retrieve full call history (incoming, outgoing, missed, rejected) along with timestamps and exact durations.
• 💬 SMS Logs: Access SMS messages from the inbox and outbox, including sender/receiver addresses, text bodies, and timestamps.
• ⚡ Optimized: Safe background querying to prevent blocking the main UI thread.

---

🔒 Required Android Permissions

To use this library, you must request the following permissions in your AndroidManifest.xml:

<manifest xmlns:android="[http://schemas.android.com/apk/res/android](http://schemas.android.com/apk/res/android)" package="com.your.package">

    <!-- Required for SIM Info -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />

    <!-- Required for Call Logs -->
    <uses-permission android:name="android.permission.READ_CALL_LOG" />

    <!-- Required for SMS Logs -->
    <uses-permission android:name="android.permission.READ_SMS" />

    <application>
        ...
    </application>
</manifest>