Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SignalScope πŸ“‘

RF Device Scanner β€” WiFi, Bluetooth & BLE detector with threat analysis.

Features

  • πŸ“Ά WiFi Scanner β€” Detect all nearby networks with SSID, channel, security
  • πŸ”΅ Bluetooth / BLE Scanner β€” Identify devices, estimate distance via RSSI
  • ⚠️ Threat Detection β€” Auto-flag suspicious/unknown devices
  • 🎯 Live Radar β€” Animated radar with device blips
  • 🌑️ Signal Heatmap β€” Visual signal intensity map
  • πŸ“‹ Device Detail β€” Full info: MAC, RSSI, distance, timeline

Setup

1. Install dependencies

flutter pub get

2. Run on Android device

flutter run

Note: Real scanning requires a physical Android device.
On emulator, mock data is used automatically.

3. Build APK

flutter build apk --release

APK will be at: build/app/outputs/flutter-apk/app-release.apk

Permissions Required

Permission Purpose
ACCESS_FINE_LOCATION Required for WiFi + BLE scanning
BLUETOOTH_SCAN BLE device scanning (Android 12+)
BLUETOOTH_CONNECT BLE device connection
NEARBY_WIFI_DEVICES WiFi scanning (Android 13+)

Project Structure

lib/
β”œβ”€β”€ main.dart                    # Entry point
β”œβ”€β”€ theme/
β”‚   └── app_theme.dart           # Colors, typography
β”œβ”€β”€ models/
β”‚   └── scanned_device.dart      # Device model + enums
β”œβ”€β”€ services/
β”‚   └── scanner_service.dart     # WiFi + BLE scanning logic
β”œβ”€β”€ screens/
β”‚   β”œβ”€β”€ home_screen.dart         # Main screen with tabs
β”‚   └── device_detail_screen.dart
└── widgets/
    β”œβ”€β”€ common_widgets.dart      # StatCard, DeviceRow, etc.
    β”œβ”€β”€ radar_widget.dart        # Animated radar
    └── heatmap_widget.dart      # Signal heatmap

Packages Used

Package Purpose
flutter_blue_plus BLE scanning
wifi_scan WiFi scanning
permission_handler Runtime permissions
provider State management
google_fonts Inter + JetBrains Mono
fl_chart Charts (extendable)
sqflite Local device history storage

Notes

  • Tested on Android 12+
  • iOS support requires additional entitlements (CoreBluetooth, CoreLocation)
  • Hidden BLE devices with unresolvable MACs are flagged as threats
  • Open WiFi networks are flagged as suspicious

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages