{"id":13490236,"url":"https://github.com/simondankelmann/Bluetooth-LE-Spam","last_synced_at":"2025-03-28T06:30:41.415Z","repository":{"id":204332697,"uuid":"707667804","full_name":"simondankelmann/Bluetooth-LE-Spam","owner":"simondankelmann","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-30T07:30:14.000Z","size":229030,"stargazers_count":4172,"open_issues_count":16,"forks_count":331,"subscribers_count":75,"default_branch":"main","last_synced_at":"2025-02-01T13:30:49.117Z","etag":null,"topics":["android","bluetooth-low-energy","f-droid","fdroid"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simondankelmann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-20T11:54:26.000Z","updated_at":"2025-02-01T00:34:16.000Z","dependencies_parsed_at":"2024-11-19T14:04:11.023Z","dependency_job_id":"26e371d7-3566-4777-bd5b-52d4c2821f3f","html_url":"https://github.com/simondankelmann/Bluetooth-LE-Spam","commit_stats":null,"previous_names":["simondankelmann/bluetooth-le-spam"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simondankelmann%2FBluetooth-LE-Spam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simondankelmann%2FBluetooth-LE-Spam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simondankelmann%2FBluetooth-LE-Spam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simondankelmann%2FBluetooth-LE-Spam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simondankelmann","download_url":"https://codeload.github.com/simondankelmann/Bluetooth-LE-Spam/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245785798,"owners_count":20671632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","bluetooth-low-energy","f-droid","fdroid"],"created_at":"2024-07-31T19:00:43.351Z","updated_at":"2025-03-28T06:30:41.407Z","avatar_url":"https://github.com/simondankelmann.png","language":"Kotlin","funding_links":[],"categories":["Kotlin","硬件_其他"],"sub_categories":["资源传输下载"],"readme":"# Bluetooth LE Spam [![Discord](https://img.shields.io/discord/1170266776731406386?label=Discord\u0026link=https://discord.gg/x4e4Gma585)](https://discord.gg/x4e4Gma585)\n\n[\u003cimg src=\"https://f-droid.org/badge/get-it-on.png\"\nalt=\"Get it on F-Droid\"\nheight=\"80\"\u003e](https://f-droid.org/packages/de.simon.dankelmann.bluetoothlespam/)\n\nThis project uses the built-in Bluetooth Low Energy (BLE) functionality built into Android devices\nto create Phantom Bluetooth Device Advertisements, similar to what is known, for instance, in the case of the Flipper Zero.\nWhile other apps are available that provide similar functionality, the objective of this app is to enhance convenience and user-friendliness in the process.\n\n#### [For Support, Join the Discord Server](https://discord.gg/x4e4Gma585)\n\n\u003e [!NOTE]\n\u003e This project is not actively updated due to no further optimizations to the exploit.\n\u003e Contributions from anyone are appreciated.   \n\n## Requirements\n\n\u003cdetails \u003e\n\u003csummary\u003eDetails\u003c/summary\u003e\n\u003cbr\u003e\n- Android 8.0 (API level 26) or later \u003cbr\u003e\n \u003cbr\u003e\nTip: If you don't know your API level visit \u003ca href=\"https://developer.android.com/tools/releases/platforms\"\u003eSDK Platform release notes\u003c/a\u003e. You also can view your Android version in the Info tab in settings.\n \u003cbr\u003e\n   \u003cbr\u003e\n- You can not run the app on IOS or PC (even with emulators/VM's)\n\n\u003c/details\u003e\n\n\n## Functionality\n\n\u003cdetails \u003e\n\u003csummary\u003eSending BLE advertisements (Pop-Ups)\u003c/summary\u003e\n\u003cbr\u003e\nThis app can send BLE advertisements that mimic the usage of various services.\nThis can cause nearby devices that listen to such advertisements to show unwanted popup dialogs.\n\nSupported services are:\n\n- Apple (new device popups, various action modals)\n- [Microsoft Swift Pair](https://learn.microsoft.com/en-us/windows-hardware/design/component-guidelines/bluetooth-swift-pair) (Windows Devices)\n- Samsung Easy Setup\n\nEnd of life services are:\n- [Google Fast Pair](https://developers.google.com/nearby/fast-pair/landing-page) (Android devices) -- patched on modern devices\n  \nYou can send BLE advertisements for all services or for selected targets only.\n\n\u003c/details\u003e\n\n\u003cdetails \u003e\n\u003csummary\u003eApple iOS 17 Crash (patched)\u003c/summary\u003e\n\u003cbr\u003e\nWith some modifications to the advertised BLE package, it is possible to trigger a reboot in various iOS 17 devices.\nThis causes the targeted iPhone to temporarily freeze for a few minutes before automatically restarting.\n\nThis is reported to be partially patched in iOS 17.2, and fully patched in iOS 18.\n\n\u003e Note:\n\u003e To achieve optimal results, it is recommended to set the advertising interval to a value between 20 and 100 milliseconds.\n\u003eAdditionally, locking and unlocking the targeted iPhone can aid in the process.\n\n\u003c/details\u003e\n\n\u003cdetails \u003e\n\u003csummary\u003eLovespouse (Adult Toys)\u003c/summary\u003e\n\u003cbr\u003e\nWith these BLE advertisements, it is possible to enable and disable various adult toys that support the Lovespouse app.\nAdditionally, the \"Denial of Pleasure\" can be executed by selecting the Lovespouse Stops List and setting the repeat mode to Repeat List. More information on this topic can be found \u003ca href=\"https://mandomat.github.io/2023-11-13-denial-of-pleasure/\"\u003ehere\u003c/a\u003e.\n\u003c/details\u003e\n\n\u003cdetails \u003e\n\u003csummary\u003eSpam Detector\u003c/summary\u003e\n\u003cbr\u003e\nThe Spam Detector tool allows you to detect nearby spammers, even on the lock screen.\nIt can identify spam from Flipper Zeros, our app, and various other software and scripts.\nOnce your device has detected spam, it will send you a notification, indicating whether it was sent by a Flipper Zero or another source.\n\n  \u003e NOTE:\n\u003e Location permission and background location access are required for this feature to work.\n\u003e These permissions are necessary because Android mandates them for Bluetooth scanning in the background.\n\u003e It's important to note that the app will NOT collect your location data.\n\u003c/details\u003e\n\n## Range\n\n\u003cdetails \u003e\n\u003csummary\u003eDetails\u003c/summary\u003e\n\u003cbr\u003e\nThe range of Bluetooth Low Energy (BLE) can vary between devices.\nSome may have a long range, while others may have a short range.\n\nAndroid's Bluetooth Low Energy API allows apps to set the TX Power level and include it in the advertiser's payload.\nHowever, it doesn't permit direct modification of the byte values actually transmitted in the payload.\nThis limitation affects the range of the Fast Pair functionality.\nReceiving devices calculate the transmitter's proximity based on the actual received signal strength and the transmitted byte in the payload, which contains the TX Power level the transmitter used.\n\nDevices like the Flipper Zero, however, have the capability to modify this byte, significantly extending their range.\n\u003c/details\u003e\n\n\n## Installation\n\n\u003cdetails \u003e\n\u003csummary\u003eDetails\u003c/summary\u003e\n\u003cbr\u003e\nYou can get installable APK files from the \u003ca href=\"https://github.com/simondankelmann/Bluetooth-LE-Spam/releases\"\u003eGithub Releases\u003c/a\u003e\nand from \u003ca href=\"https://f-droid.org/packages/de.simon.dankelmann.bluetoothlespam/\"\u003eF-Droid\u003c/a\u003e.\nYou can clone the git repo and also build the app yourself.\n\nIf you are an end-user looking for a fully functional app, download the Release APK for optimal performance (simply go for this one).\nIf you are a developer or tester, opt for the Debug APK for testing and debugging purposes.\n\u003c/details\u003e\n\n## Credits\n\n\u003cdetails \u003e\n\u003csummary\u003eClick to open\u003c/summary\u003e\n\u003cbr\u003e\n- \u003ca href=\"https://www.mobile-hacker.com/author/boni11/\"\u003emh from mobile-hacker.com\u003c/a\u003e for the \u003ca href=\"https://www.mobile-hacker.com/2023/09/07/spoof-ios-devices-with-bluetooth-pairing-messages-using-android/\"\u003eArticle / Guideline\u003c/a\u003e about using the nRF Connect App to Spoof iOS Devices  \u003cbr\u003e \n- \u003ca href=\"https://github.com/Willy-JL\"\u003eWilly-JL\u003c/a\u003e, \u003ca href=\"https://github.com/ECTO-1A\"\u003eECTO-1A\u003c/a\u003e, \u003ca href=\"https://github.com/Spooks4576\"\u003eSpooks4567\u003c/a\u003e and \u003ca href=\"https://github.com/Mr-Proxy-source\"\u003eMrproxy\u003c/a\u003e for their contribution in the BLE Spam App on the Flipper Zero \u003cbr\u003e  \n- \u003ca href=\"https://github.com/furiousMAC\"\u003eFuriousMAC\u003c/a\u003e and \u003ca href=\"https://github.com/hexway\"\u003eHexway\u003c/a\u003e for their prior researches \u003cbr\u003e  \n- \u003ca href=\"https://mandomat.github.io/aboutme/\"\u003emandomat\u003c/a\u003e for the research of \u003ca href=\"https://mandomat.github.io/2023-11-13-denial-of-pleasure/\"\u003eDenial of Pleasure\u003c/a\u003e\u003cbr\u003e\n- \u003ca href=\"https://github.com/tutozz\"\u003etutozz\u003c/a\u003e for the research of Easy Setup Buds in Android\u003cbr\u003e\n- \u003ca href=\"https://github.com/K3YOMI\"\u003eK3YOMI\u003c/a\u003e for the spam detector idea \u003cbr\u003e  \n- \u003ca href=\"https://www.tiktok.com/discover/glorious-gizmos\"\u003eGlorious Gizmos\u003c/a\u003e for making content and tutorials on our app \u003cbr\u003e  \n- And special thanks to anyone else who has been involved in prior research and publications related to this topic. \u003cbr\u003e  \n\u003c/details\u003e\n\n## Screenshots\n\n\u003cdetails\u003e\n\u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/1.png\" width=300\u003e\n\u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/2.png\" width=300\u003e\n\u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/3.png\" width=300\u003e\n\u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/4.png\" width=300\u003e\n\u003c/details\u003e\n\n## Disclaimer\n\u003cdetails \u003e\n\u003csummary\u003eDisclaimer for Bluetooth Low Energy Protocol Investigation Repository\u003c/summary\u003e\n\u003cbr\u003e\nThis repository contains code for the investigation and experimentation of the Bluetooth Low Energy (BLE) protocol.\nPlease be aware of the following disclaimers before using or contributing to this repository:\n\n1. Purpose: The code and information provided in this repository are intended for educational and research purposes and is just a proof of concept.\n   It is not intended for any malicious or harmful activities.\n\n2. Legal Compliance: Users are responsible for ensuring that their use of the code and information in this repository complies with all applicable laws and regulations, including those governing wireless communication and intellectual property rights.\n\n3. No Warranty: The code and information provided in this repository are provided \"as is\" without any warranties, expressed or implied.\n   The authors and contributors are not responsible for any consequences resulting from the use of this code.\n\n4. Risks: Experimenting with BLE protocols can have potential security and privacy implications.\n   Users should exercise caution and use this code responsibly, respecting the privacy and security of devices and systems.\n\n5. Contribution Guidelines: If you contribute to this repository, ensure that your contributions comply with the project's goals and the repository's license.\n   By contributing, you agree to license your contributions under the same license as this repository.\n\n6. Support: This repository is not maintained for production use.\n   The authors and contributors may not provide support or updates regularly.\n\nBy using and contributing to this repository, you agree to these disclaimers and guidelines.\nIf you do not agree, please refrain from using or contributing to this repository.\n\nFor any questions or concerns, please contact the repository maintainers on Discord or Github.\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimondankelmann%2FBluetooth-LE-Spam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimondankelmann%2FBluetooth-LE-Spam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimondankelmann%2FBluetooth-LE-Spam/lists"}