diff --git a/README.md b/README.md deleted file mode 100644 index 241941d..0000000 --- a/README.md +++ /dev/null @@ -1,60 +0,0 @@ -**NearDrop** is a partial implementation of [Google's Nearby Share](https://blog.google/products/android/nearby-share/) for macOS. This fork reflects the App Store version of NearDrop available [here](https://apps.apple.com/de/app/neardrop-quickshare-client/id6740147178?l=en-GB&mt=12). - -[Protocol documentation](/PROTOCOL.md) is available separately. - -The app lives in your menu bar and saves files to your downloads folder. It's that simple, really. - -## Limitations - -* **Wi-Fi LAN only**. Your Android device and your Mac need to be on the same network for this app to work. Google's implementation supports multiple mediums, including Wi-Fi Direct, Wi-Fi hotspot, Bluetooth, some kind of 5G peer-to-peer connection, and even a WebRTC-based protocol that goes over the internet through Google servers. Wi-Fi direct isn't supported on macOS (Apple has their own, incompatible, AWDL thing, used in AirDrop). Bluetooth needs further reverse engineering. -* **Visible to everyone on your network at all times** while the app is running. Limited visibility (contacts etc) requires talking to Google servers, and becoming temporarily visible requires listening for whatever triggers the "device nearby is sharing" notification. - -## Contributing - -Pull requests that change the readme will not be accepted. - -## FAQ - -#### My Android device doesn't see my Mac - -Make sure both devices are on the same Wi-Fi network. Local network communication may not work on some public networks — for example, in coffee shops or hotels. If you're on your own network, check your router settings to make sure it's not blocking local devices from talking to each other. - -#### How do I send files? - -Right-click a file in Finder, select Share, then select NearDrop. - -#### How do I send links? - -From the menu bar: File -> Share -> NearDrop. Safari also has a share button on the toolbar. - -#### My Mac doesn't see my Android device - -Unfortunately, Android listens for specific BLE (Bluetooth Low Energy) broadcasts to automatically become visible, and macOS doesn't allow apps to send them. - -##### Samsung devices - -After the Quick Share update, [there's currently no known workaround for this problem](https://github.com/grishka/NearDrop/issues/152). Subscribe to that issue to get notified if/when one becomes available. - -##### Non-Samsung devices - -As a workaround, you have to open the "Google Files" and tap "Receive" on the "Nearby Share" tab. - -To make it more easily accessible and/or if you don't want to install Google Files, you can use an app like [one of these](https://forum.xda-developers.com/t/how-to-manually-create-a-homescreen-shortcut-to-a-known-unique-android-activity.4336833/) to create a shortcut to launch one of these activity intents: - -- Option 1: - - Action: `com.google.android.gms.RECEIVE_NEARBY` - - Mime type: `*/*` -- Option 2: - - Component name: `com.google.android.gms/.nearby.sharing.ReceiveSurfaceActivity` - -#### Can the menu bar icon be removed? - -Yes. Drag the icon off the menu bar while holding cmd. To bring it back, launch the app a second time, while it's already running. - -#### I'm sending something to my Mac, the Android device displays a PIN code, but nothing happens on the Mac - -Make sure you have "do not disturb" off. The notification may also sometimes (rarely) end up in the notification center without being shown as a popup first — I'm not sure why this happens. - -#### Why not the other way around, i.e. AirDrop on Android? - -While I am an Android developer, and I have looked into this, this is nigh-impossible. AirDrop uses [AWDL](https://stackoverflow.com/questions/19587701/what-is-awdl-apple-wireless-direct-link-and-how-does-it-work), Apple's own proprietary take on peer-to-peer Wi-Fi. This works on top of 802.11 itself, the low-level Wi-Fi protocol, and thus can not be implemented without messing around with the Wi-Fi adapter drivers and raw packets and all that. It might be possible on Android, but it would at the very least require root and possibly a custom kernel. There is [an open-source implementation of AWDL and AirDrop for Linux](https://owlink.org/code/). diff --git a/images/YoDawg.jpg b/images/YoDawg.jpg deleted file mode 100644 index b7e34bf..0000000 Binary files a/images/YoDawg.jpg and /dev/null differ