📞 advanced_call_log

● Android call history reader
● Built‑in runtime permission helpers
● Dual‑SIM metadata (best‑effort)

Platforms: ✅ Android | ❌ iOS (not supported by iOS APIs)

📸 Screenshots

advanced_call_log screenshot

✨ Features

  • 🔐 Permission helpers
    • CallLog.hasPermissions()
    • CallLog.requestPermissions()
  • 📋 Read call logs
    • Incoming / Outgoing / Missed / Rejected / Blocked (device dependent)
  • 🧾 Useful fields
    • number, formattedNumber, name, timestamp, duration
    • phoneAccountId, simDisplayName (best‑effort)

📦 Install

dependencies:
  advanced_call_log: ^1.0.0

🔧 Android setup

1) Add permissions

Add the following to your app manifest: android/app/src/main/AndroidManifest.xml

<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

2) Google Play policy (important)

Google Play restricts Call Log permissions. If your app does not qualify for an allowed use‑case, your submission can be rejected.

  • Policy: Use of SMS or Call Log permission groups

🔐 Runtime permissions

Android runtime permission model applies.

final granted = await CallLog.requestPermissions();
if (!granted) {
  // show message / open settings
  return;
}

🚀 Usage

Get all logs

final logs = await CallLog.get();
for (final e in logs.take(10)) {
  print('${e.callType}  ${e.number}  ${e.duration}s');
}

Query logs

final logs = await CallLog.query(
  dateTimeFrom: DateTime.now().subtract(const Duration(days: 7)),
  type: CallType.missed,
);

for (final e in logs) {
  final ts = e.timestamp ?? 0;
  print('MISSED: ${e.name ?? e.number} @ ${DateTime.fromMillisecondsSinceEpoch(ts)}');
}

Filter by number / name

final byNumber = await CallLog.query(number: '98765');
final byName = await CallLog.query(name: 'Ahmed');

🧩 Returned fields

Field Meaning
name Cached contact name (if available)
number Raw dialed number
formattedNumber Locale formatted number
callType Incoming/Outgoing/Missed/etc
timestamp Call start time (ms epoch)
duration Call duration (seconds)
phoneAccountId Phone account id (best‑effort)
simDisplayName SIM label (best‑effort)

🛡️ Notes / limits

  • iOS does not allow reading call logs.
  • Some OEMs may return null for SIM fields.
  • If you need a runnable example app, run this inside example/:
flutter create .
flutter run

🌐 Homepage

https://nh97.co.in/

📄 License

MIT

☕ Sponsor a cup of tea

If this package saves you development time, consider supporting my work.

Sponsor

https://github.com/sponsors/nousath

Libraries

advanced_call_log