WiFi Signal Strength #

A Flutter package to get WiFi signal strength indicator for iOS and Android platforms.

Features #

✅ Get WiFi signal strength in dBm
✅ Get WiFi signal level (0-4 scale)
✅ Check if WiFi is connected
✅ Get WiFi SSID (network name)
✅ Visual WiFi signal strength indicator widget
✅ Two visual styles: Bars and Sectors
✅ Custom RSSI input support
✅ Works on both iOS and Android

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  wifi_signal_strength: ^1.0.0

Then run:

flutter pub get

Platform Setup #

Android #

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

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

Note: For Android 10 (API 29) and above, location permission is required to access WiFi information. Make sure to request location permissions at runtime.

iOS #

Add the following to your ios/Runner/Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs location permission to access WiFi information</string>

Note: iOS requires location permissions to access WiFi SSID. For iOS 13+, additional entitlements may be required for full functionality.

Usage #

Basic Example #

import 'package:wifi_signal_strength/wifi_signal_strength.dart';

// Check if WiFi is connected
final isConnected = await WifiSignalStrength.isWifiConnected();
print('WiFi connected: $isConnected');

// Get signal strength in dBm
final signalStrength = await WifiSignalStrength.getSignalStrength();
if (signalStrength != null) {
  print('Signal strength: $signalStrength dBm');
}

// Get signal level (0-4)
final signalLevel = await WifiSignalStrength.getSignalLevel();
if (signalLevel != null) {
  print('Signal level: $signalLevel/4');
}

// Get WiFi SSID
final ssid = await WifiSignalStrength.getWifiSSID();
if (ssid != null) {
  print('Connected to: $ssid');
}

Signal Level Reference #

4: Excellent signal (RSSI >= -50 dBm)
3: Good signal (RSSI >= -60 dBm)
2: Fair signal (RSSI >= -70 dBm)
1: Weak signal (RSSI >= -80 dBm)
0: No signal (RSSI < -80 dBm)

Visual Indicator Widget #

The package includes a ready-to-use widget for displaying WiFi signal strength visually:

import 'package:flutter/material.dart';
import 'package:wifi_signal_strength/wifi_signal_strength.dart';

// Using actual WiFi signal strength
WifiSignalStrengthIndicator(
  rssi: -55, // RSSI value from WifiSignalStrength.getSignalStrength()
  style: WifiSignalStyle.bars, // or WifiSignalStyle.sectors
  size: 100.0,
  showLevel: true,
)

// With custom RSSI value
WifiSignalStrengthIndicator(
  rssi: -65, // Your custom RSSI value
  style: WifiSignalStyle.sectors,
  size: 120.0,
  showLevel: true,
  excellentColor: Colors.green,
  goodColor: Colors.lightGreen,
  fairColor: Colors.orange,
  weakColor: Colors.deepOrange,
)

Complete Example with UI #

import 'package:flutter/material.dart';
import 'package:wifi_signal_strength/wifi_signal_strength.dart';

class WifiStatusWidget extends StatefulWidget {
  @override
  _WifiStatusWidgetState createState() => _WifiStatusWidgetState();
}

class _WifiStatusWidgetState extends State<WifiStatusWidget> {
  int? _signalStrength;
  WifiSignalStyle _style = WifiSignalStyle.bars;

  @override
  void initState() {
    super.initState();
    _updateWifiStatus();
  }

  Future<void> _updateWifiStatus() async {
    final signalStrength = await WifiSignalStrength.getSignalStrength();
    setState(() {
      _signalStrength = signalStrength;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        WifiSignalStrengthIndicator(
          rssi: _signalStrength,
          style: _style,
          size: 120.0,
          showLevel: true,
        ),
        Row(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () => setState(() => _style = WifiSignalStyle.bars),
              child: Text('Bars'),
            ),
            SizedBox(width: 16),
            ElevatedButton(
              onPressed: () => setState(() => _style = WifiSignalStyle.sectors),
              child: Text('Sectors'),
            ),
          ],
        ),
        ElevatedButton(
          onPressed: _updateWifiStatus,
          child: Text('Refresh'),
        ),
      ],
    );
  }
}

API Reference #