๐Ÿ”ต Bluetooth Scanner

A web-based Bluetooth device scanner that uses the Web Bluetooth API to discover and display information about nearby Bluetooth devices.

Features

  • ๐Ÿ” Device Discovery: Scan for nearby Bluetooth devices
  • ๐Ÿ“ฑ Device Information: Display device names, IDs, and connection status
  • ๐Ÿ•’ Real-time Updates: Shows when devices were discovered
  • ๐Ÿงน Clear Function: Easy way to clear the device list
  • ๐Ÿ“Š Device Counter: Keep track of how many devices have been found
  • ๐ŸŽจ Responsive Design: Works on desktop and mobile devices

Browser Compatibility

This app uses the Web Bluetooth API, which is supported in:

  • โœ… Chrome (desktop and Android)
  • โœ… Edge (desktop and Android)
  • โœ… Opera (desktop and Android)
  • โŒ Firefox (not supported)
  • โŒ Safari (not supported)

Important Notes

Privacy Limitations

Due to privacy and security restrictions in the Web Bluetooth API:

  • MAC addresses are not directly accessible through the Web Bluetooth API
  • Device information is limited to what the device chooses to advertise
  • Users must explicitly grant permission to access each device
  • The API requires user interaction (button click) to initiate scanning

How It Works

  1. User Interaction Required: Click "Start Scan" to begin device discovery
  2. Permission Dialog: Browser will show a device selection dialog
  3. Device Selection: Choose a device from the list to add it to your scanner
  4. Device Information: Basic information about the selected device is displayed
  5. Connection Attempts: The app tries to connect to get additional device details

Technical Details

  • Built with vanilla JavaScript and the Web Bluetooth API
  • Uses TailwindCSS for styling
  • Responsive design with mobile-first approach
  • Error handling for unsupported browsers and connection issues

Usage

  1. Open the app in a supported browser
  2. Click "Start Scan" to begin scanning
  3. Select devices from the browser's permission dialog
  4. View discovered devices in the list
  5. Use "Clear" to remove all devices from the list

Limitations

  • Cannot perform passive scanning (requires user interaction for each device)
  • Limited device information available due to privacy restrictions
  • MAC addresses are not accessible through the Web Bluetooth API
  • Some devices may not be discoverable or may require specific pairing procedures

For more advanced Bluetooth scanning capabilities, consider using native mobile apps or desktop applications with appropriate system permissions.