Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv0.4.2

sms_receiver

Android SMS Receiver API without permission required.

AndroidiOS
pub.dev API documentation Source code
30-day downloads
18
Likes
53
Pub points
140

Install package

flutter pub add sms_receiver

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The sms_receiver package enables Android apps to receive SMS messages without requiring the READ_SMS permission, leveraging Android's built-in SMS receiver API. It provides a straightforward way to listen for incoming SMS messages directly in Flutter applications on Android. While it works seamlessly on Android, iOS support is limited due to platform restrictions. The package is ideal for use cases like OTP auto-retrieval, two-factor authentication, or automated message processing. It requires minimal setup and integrates easily with existing Flutter projects.

Use cases

  • OTP auto-retrieval
  • Two-factor authentication
  • Automated message processing
  • SMS-based triggers
  • Real-time notification systems

Key features

  • No READ_SMS permission required
  • Android-only SMS listening
  • Simple event-driven API
  • Lightweight and fast
  • Works with background execution

Suitable for

  • Android-only apps
  • Authentication flows
  • Background message handling
  • Low-permission apps
  • Quick SMS integration

Considerations

  • iOS not supported
  • Limited to Android platform
  • Requires Android manifest configuration
  • May not work on all devices
  • Depends on system-level SMS delivery

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

sms_receiver

NOTE: This plugin might no longer needed due to flutter/flutter#13015

pub package

Flutter plugin for reading incoming-and-expected SMS only

Currently developed for Android: reading message without requesting SMS permission.

Usage

  • Generate acceptable message format

    • DON'T generate hash message on runtime using AppSignatureHelper. Store hash as constant inside your app, either on the server or client.

  • Add dependency to this package

  • Create SmsReceiver() with onSmsReceived(String message) handler.

  • Start listening with startListening()

  • Stop listening with stopListening()

  • Once sms received or receiver timed out, use startListening again. See example

    • Receiver timeout is 5 minutes. Currently not configurable.

Future Development

  • Add/Combine with iOS counterpart

Categories

SMS

Source repository

Projects using this package

No data available yet.