advanced_device_info #

The ultimate, all-in-one Flutter device intelligence and diagnostics plugin. Retrieve 100+ native hardware specs, live peripheral states, anti-fraud & security indicators, DRM certifications, biometric hardware, thermal throttling, display HDR profiles, audio stream volumes, and accessibility settings on Android and iOS.

Replaces the need for 5+ fragmented packages (device_info_plus, battery_plus, connectivity_plus, root checkers, audio volume managers, and sensor libraries) into a single, unified, lightweight library with zero dangerous permissions.

📑 Table of Contents #

• ⚡ Why advanced_device_info? (Comparison Matrix)
• ✨ Exhaustive Feature Breakdown
  • 1. 🛡️ Security, Developer Mode & Anti-Fraud Suite
  • 2. 🌡️ Thermal & Power Management
  • 3. 🎬 DRM & Video Streaming Certification
  • 4. 🔐 Biometric Hardware & Enrollment
  • 5. 🧭 Hardware Sensors Inventory
  • 6. ⚡ Live Hardware & Peripheral Signals
  • 7. 🖥️ Display HDR, Colors & Refresh Rates
  • 8. 🧰 Onboard Peripherals & Radios
  • 9. 🔊 Audio Streams & Volume Controls
  • 10. 🌐 Regional, Theme & Accessibility
  • 11. 🔋 Battery & Power Health
  • 12. 📶 Network & VPN Tunnel Detection
  • 13. 📱 "About Phone" System Build Info
  • 14. 💾 Storage & 🧠 RAM Memory Details
• 📦 Installation & Setup
• 🚀 Real-World Code Recipes
  • Recipe 1: Full System Diagnostics in 1 Line
  • Recipe 2: FinTech / Banking Fraud Shield
  • Recipe 3: OTT Streaming & DRM Validation
  • Recipe 4: Adaptive 120Hz Gaming & Thermal Throttling
  • Recipe 5: Audio Volume Level Inspector
  • Recipe 6: Accessibility & Theme Synchronization
• 📚 Comprehensive API & Model Reference
• 🔒 Zero-Permission Architecture
• 🤝 Contributing & Support
• 📝 License

⚡ Why advanced_device_info? #

✨ Exhaustive Feature Breakdown #

1. 🛡️ Security, Developer Mode & Anti-Fraud Suite #

Designed specifically for banking, crypto wallets, payment apps, and gaming anti-cheat engines:

• Developer Options (isDeveloperMode) - Detects if Android Developer Options are enabled in system settings.
• USB Debugging (ADB) (isAdbEnabled) - Detects if ADB debugging over USB is currently enabled.
• Wireless Debugging (Wi-Fi ADB) (isWirelessDebuggingEnabled) - Detects Android 11+ wireless ADB debugging.
• USB Cable Connection State (isUsbConnected) - Detects if device is currently plugged into a USB host computer or charger.
• Fake GPS / Mock Location (isMockLocation) - Identifies simulated GPS locations or installed mock location providers.
• Stay Awake on Charge (isStayAwake) - Detects developer mode setting that prevents screen sleep while charging.
• USB App Package Verification (isVerificationOfAppsOverUsb) - Checks if package verification over ADB is enforced.
• Root & Jailbreak Detection (isRooted, isJailbroken) - Deep inspection across 14 known su binary paths, test-keys build signatures, Superuser apps, Magisk mount points, and iOS sandbox integrity.
• Screen Lock Security (isDeviceSecure) - Checks if user has configured a secure lock screen (PIN, Pattern, Password, or Biometrics).
• Native Debugger Attachment (isDebuggerAttached) - Detects active debuggers (ptrace, LLDB, Java Debug Wire Protocol).
• isCompromised Convenience Flag - Fast evaluation combining root, jailbreak, debugger, and mock GPS checks into a single boolean.

2. 🌡️ Thermal & Power Management #

Essential for games, media rendering, camera processing, and heavy machine learning workloads:

• Thermal Throttling State (thermalStatus) - Android 10+ and iOS thermal states:
  • NONE / NOMINAL - Device operating at normal temperatures.
  • LIGHT / FAIR - Minor thermal elevation, light throttling.
  • MODERATE - Moderate thermal throttling, fans or clock adjustments initiated.
  • SEVERE / SERIOUS - Significant thermal throttling, performance heavily throttled.
  • CRITICAL - Critical temperature threshold reached.
  • EMERGENCY / SHUTDOWN - Thermal emergency shutdown imminent.
• Throttling Warning Helper (isThrottling) - Quick boolean check for moderate or critical thermal conditions.
• Battery Saver Mode (isPowerSaveMode) - Checks if system low-power mode is currently active.
• Device Doze / Idle State (isDeviceIdleMode) - Detects Android Doze mode (device stationary with screen off).

3. 🎬 DRM & Video Streaming Certification #

Verify media playback readiness for OTT platforms (Netflix, Prime Video, Disney+, Apple TV+):

• Widevine Security Level (widevineSecurityLevel) - Returns L1 (hardware-backed secure decryption), L2, or L3 (software decryption).
• HD / 4K Streaming Certification (isHdCapable) - Confirms whether device is certified for 1080p FHD and 4K UHD streaming.
• DRM Vendor & Version (widevineVendor, widevineVersion) - DRM library information (e.g. Google, FairPlay).
• Crypto System ID (systemId) - Hardware cryptographic system identifier.

4. 🔐 Biometric Hardware & Enrollment #

• Hardware Presence (hasBiometrics) - Detects if biometric hardware exists on the device.
• Enrollment State (isEnrolled) - Confirms if the user has actively registered biometric credentials.
• Supported Modalities (supportedTypes) - List of available biometric types (fingerprint, face, iris, optic).
• Modalities Getters - hasFingerprint, hasFaceId, hasIris.

5. 🧭 Hardware Sensors Inventory #

Comprehensive enumeration of onboard sensor chips:

• Sensor Detection Flags:
  • hasAccelerometer (3-axis acceleration)
  • hasGyroscope (angular velocity / rotation)
  • hasMagnetometer (digital compass / magnetic field)
  • hasBarometer (atmospheric pressure & altimeter)
  • hasProximity (object distance sensor)
  • hasLight (ambient illumination sensor)
  • hasStepCounter (hardware pedometer)
• Total Sensors Count (totalSensorCount) - Total count of physical sensors detected on device (e.g. 24+ on modern phones).
• Sensor Names Catalog (sensorNames) - List containing every registered hardware sensor name.

6. ⚡ Live Hardware & Peripheral Signals #

Real-time hardware status without polling:

• Screen Interactive State (isScreenOn) - Checks if display panel is turned on and interactive.
• Wi-Fi Radio Adapter (isWifiEnabled) - Hardware Wi-Fi radio toggle state (independent of whether connected to an AP).
• Active Phone / VoIP Call (isCallActive) - Real-time call or communication session detection (cellular or VoIP).
• Headphone / Audio Routing (isHeadphonesConnected) - Wired 3.5mm headsets, USB-C DACs, Bluetooth A2DP, or LE audio devices.
• Cellular SIM Slot Count (simSlotCount) - Hardware modem count (1 for Single SIM, 2 for Dual SIM).
• Dual SIM Helper (isDualSim) - Quick boolean check if device supports Dual SIM.

7. 🖥️ Display HDR, Colors & Refresh Rates #

• HDR Display Playback (isHdrSupported) - High Dynamic Range video capability.
• Supported HDR Formats (supportedHdrTypes) - HDR10, HDR10_PLUS, DOLBY_VISION, HLG.
• Wide Color Gamut (isWideColorGamut) - DCI-P3 color gamut display panel detection.
• Supported Refresh Rates (supportedRefreshRates) - All display refresh frequencies supported by the panel (e.g., [45Hz, 48Hz, 50Hz, 60Hz, 90Hz, 120Hz]).
• High Refresh Rate Helper (supportsHighRefreshRate) - True if display supports > 60Hz.
• Screen Brightness & Auto-Mode (screenBrightness, isAutoBrightnessEnabled) - Display brightness level (0–255) and adaptive toggle state.

8. 🧰 Onboard Peripherals & Radios #

• NFC Hardware (isNfcAvailable, isNfcEnabled) - NFC chip availability and active toggle state.
• Bluetooth Radio (isBluetoothAvailable, isBluetoothEnabled) - Bluetooth adapter presence and state.
• Camera Flashlight / Torch (hasFlashlight) - Built-in LED flash availability.
• Camera Lenses Count (cameraCount, frontCameraCount, backCameraCount) - Front and rear physical camera counts.
• Haptic Engine (hasVibrator, hasAmplitudeControl) - Vibration motor presence and advanced amplitude modulation.

9. 🔊 Audio Streams & Volume Controls #

• Audio Stream Volumes:
  • mediaVolume & maxMediaVolume (Music, videos, games)
  • ringVolume & maxRingVolume (Incoming call ringtones)
  • callVolume & maxCallVolume (In-call voice volume)
  • alarmVolume & maxAlarmVolume (Alarm clock sound)
  • notificationVolume & maxNotificationVolume (System notifications)
• Volume Percentage (mediaVolumePercentage) - Normalized 0.0 to 100.0% volume.
• Hardware Microphone Mute (isMicrophoneMute) - Hardware/system microphone mute state.
• Bluetooth Audio Profile (isBluetoothA2dpOn) - Active A2DP high-fidelity audio stream.

10. 🌐 Regional, Theme & Accessibility #

• Timezone Identifier & Display Name (timezoneId, timezoneDisplayName, e.g. Asia/Kolkata, India Standard Time).
• Formatted UTC Offset (formattedUtcOffset, e.g. +05:30, -04:00).
• Timezone Offset in Seconds (timezoneOffsetSeconds).
• Preferred System Languages (preferredLanguages, e.g. ["en-US", "hi-IN"]).
• 24-Hour Clock Format (is24HourFormat) - User preference for 12h vs 24h clock.
• Font Scale Multiplier (fontScale, e.g. 0.90x, 1.15x) - System accessibility text zoom.
• Screen Reader State (isScreenReaderActive) - TalkBack (Android) or VoiceOver (iOS) active status.
• Dark Mode Theme (isDarkMode) - OS dark mode / night theme detection.

11. 🔋 Battery & Power Health #

• Battery Level (0% to 100%).
• Charging State (charging, discharging, full, notCharging).
• Power Source (ac, usb, wireless, dock, none).
• Battery Health (good, overheat, dead, over_voltage, cold).
• Battery Temperature in °Celsius and °Fahrenheit (batteryTemperature, temperatureFahrenheit).
• Battery Helpers: isLow (<= 20%), isFull (>= 95%).

12. 📶 Network & VPN Tunnel Detection #

• Active Internet State (isConnected, isOffline).
• Connection Transport Type (wifi, cellular, ethernet, bluetooth, vpn, none).
• VPN Tunnel Detection (isVpnActive) - Deep inspection across tun, ppp, p2p, tap, ipsec virtual interfaces and system proxy tables.
• Transport Helpers: isWifi, isCellular.

13. 📱 "About Phone" System Build Info #

• Branding: Device Name, Manufacturer, Brand, Model, Hardware Board.
• OS Information: Release, Codename, Incremental build number.
• Security Patch: Android Security Patch date (securityPatch, e.g. 2024-05-01).
• Kernel Version: OS Kernel release (kernelVersion, e.g. Linux 5.15.78).
• Radio Firmware: Baseband / Modem version (radioVersion).
• Bootloader: Bootloader identifier (bootloader).
• CPU Architectures: Supported ABIs (supportedAbis, e.g. arm64-v8a).
• System Uptime: Formatted uptime string (formattedUptime, e.g. "2d 4h 15m").
• Emulator / Simulator: Hardware and fingerprint heuristic verification.

14. 💾 Storage & 🧠 RAM Memory Details #

• Exact byte values: totalStorage, usedStorage, freeStorage, totalRam, usedRam, availableRam.
• Percentage calculations: storageInfo.usagePercentage, memoryInfo.usagePercentage.
• Convenience GB / MB getters: totalStorageGB, usedStorageGB, freeStorageGB, totalRamGB, availableRamGB.
• Formatted strings: formattedUsedStorage (e.g. "54.2 GB"), formattedAvailableRam (e.g. "3.5 GB").
• Byte formatting extension: 1073741824.toReadableBytes() -> "1.0 GB".
• Warning helpers: isLowStorage(thresholdPercent: 90), isLowMemory(thresholdPercent: 85).

📦 Installation & Setup #

Add advanced_device_info to your pubspec.yaml:

dependencies:
  advanced_device_info: ^0.0.2

Or install via Flutter CLI:

flutter pub add advanced_device_info

Platform & Environment Compatibility #

🚀 Real-World Code Recipes #

Recipe 1: Full System Diagnostics in 1 Line #

Fetch every hardware, security, sensor, and battery metric in a single optimized native call:

import 'package:advanced_device_info/advanced_device_info.dart';

void runFullDiagnostics() async {
  final SystemInfo sys = await AdvancedDeviceInfo.getSystemInfo();

  // About Phone
  print('Device: ${sys.deviceInfo.manufacturer} ${sys.deviceInfo.model}');
  print('Security Patch: ${sys.deviceInfo.securityPatch}');
  print('Kernel: ${sys.deviceInfo.kernelVersion}');
  print('Uptime: ${sys.deviceInfo.formattedUptime}');

  // Storage & RAM
  print('Storage: ${sys.storageInfo.formattedUsedStorage} / ${sys.storageInfo.formattedTotalStorage}');
  print('RAM: ${sys.memoryInfo.formattedUsedRam} / ${sys.memoryInfo.formattedTotalRam}');

  // Display & Peripherals
  print('Refresh Rates: ${sys.displayCapabilitiesInfo.supportedRefreshRates.join(", ")} Hz');
  print('Sensors Count: ${sys.sensorsInfo.totalSensorCount}');
  print('Widevine DRM: ${sys.drmInfo.widevineSecurityLevel}');
}

Recipe 2: FinTech / Banking Fraud Shield #

Protect banking, payment, and confidential applications from emulators, debuggers, rooted devices, and GPS spoofers:

void enforceDeviceSecurity() async {
  final SecurityInfo security = await AdvancedDeviceInfo.getSecurityInfo();

  // 1. Check for compromised environment
  if (security.isCompromised) {
    throw SecurityException('Device is Rooted, Jailbroken, Debugged, or Mocking GPS');
  }

  // 2. Anti-Debugging & Anti-Tampering checks
  if (security.isDeveloperMode) {
    print('Alert: Developer Mode is toggled ON');
  }
  if (security.isAdbEnabled || security.isWirelessDebuggingEnabled) {
    print('Alert: ADB Debugging is active');
  }
  if (security.isUsbConnected) {
    print('Alert: Device connected to USB cable / PC');
  }

  // 3. Ensure user has a device lock screen set
  if (!security.isDeviceSecure) {
    print('Alert: No PIN, Pattern, or Password configured on device');
  }
}

Recipe 3: OTT Streaming & DRM Validation #

Check whether the device supports hardware-secure Widevine L1 for 1080p Full HD and 4K UHD video playback:

void verifyStreamingCapability() async {
  final DrmInfo drm = await AdvancedDeviceInfo.getDrmInfo();

  if (drm.isHdCapable) {
    print('Widevine L1 verified: Enabling 1080p / 4K UHD playback');
  } else {
    print('Widevine ${drm.widevineSecurityLevel}: Restricted to SD 480p streaming');
  }
}

Recipe 4: Adaptive 120Hz Gaming & Thermal Throttling #

Dynamically adjust graphics quality and frame rate based on device thermal status:

void configureGameSettings() async {
  final ThermalInfo thermal = await AdvancedDeviceInfo.getThermalInfo();
  final DisplayCapabilitiesInfo display = await AdvancedDeviceInfo.getDisplayCapabilitiesInfo();

  if (thermal.isThrottling) {
    // Thermal throttling detected: Reduce resolution & lock to 60 FPS
    applyQualityPreset(Quality.low);
    setTargetFps(60);
  } else if (display.supportsHighRefreshRate) {
    // Device is cool and display panel supports high refresh rate
    applyQualityPreset(Quality.ultra);
    setTargetFps(120);
  }
}

Recipe 5: Audio Volume Level Inspector #

Monitor volume streams, detect microphone mute, and identify Bluetooth A2DP audio routes:

void checkAudioRoutes() async {
  final AudioVolumeInfo audio = await AdvancedDeviceInfo.getAudioVolumeInfo();

  print('Media Volume: ${audio.mediaVolume} / ${audio.maxMediaVolume} (${audio.mediaVolumePercentage.round()}%)');
  print('Mic Hardware Muted: ${audio.isMicrophoneMute}');
  print('Bluetooth A2DP Streaming: ${audio.isBluetoothA2dpOn}');
}

Recipe 6: Accessibility & Theme Synchronization #

Adapt application layouts based on system font scale multipliers and screen readers:

void adaptUserExperience() async {
  final LocaleThemeInfo locale = await AdvancedDeviceInfo.getLocaleThemeInfo();

  print('Timezone: ${locale.timezoneId} (${locale.formattedUtcOffset})');
  print('Preferred Languages: ${locale.preferredLanguages.join(", ")}');
  print('24-Hour Clock: ${locale.is24HourFormat}');
  print('System Font Scale: ${locale.fontScale}x');
  print('TalkBack / VoiceOver Active: ${locale.isScreenReaderActive}');
  print('Dark Mode: ${locale.isDarkMode}');
}

📚 Comprehensive API & Model Reference #

Public API Methods (AdvancedDeviceInfo) #

Model Classes & Property Catalog #

🛡️ SecurityInfo

🌡️ ThermalInfo

🎬 DrmInfo

🔐 BiometricInfo

🧭 SensorsInfo

🖥️ DisplayCapabilitiesInfo

🧰 PeripheralsInfo

🔊 AudioVolumeInfo

🌐 LocaleThemeInfo

⚡ LiveHardwareInfo

🔋 BatteryInfo

📶 NetworkInfo

📱 DeviceInfo

💾 StorageInfo & 🧠 MemoryInfo

🔒 Zero-Permission Architecture #

Over 95% of features provided by advanced_device_info require no dangerous runtime permissions:

• Does NOT require sensitive permissions like READ_CALL_LOG, QUERY_ALL_PACKAGES, or PACKAGE_USAGE_STATS.
• Completely compliant with Google Play Store and Apple App Store review guidelines.
• Instant, silent initialization without interrupting users with runtime permission prompts.

🤝 Contributing & Support #

• Contributions, bug reports, and feature suggestions are welcome!
• GitHub Repository: naitikharkhani7/advanced_device_info
• Issues & Bug Reports: Submit an issue

📝 License #

This project is licensed under the MIT License - see the LICENSE file for details.