Skip to content

Latest commit

 

History

History
84 lines (46 loc) · 5.01 KB

README.md

File metadata and controls

84 lines (46 loc) · 5.01 KB

NearDrop is a partial implementation of Google's Nearby Share/Quick Share for macOS.

Protocol documentation 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.

Installation

Download the latest build from the releases section, unzip, move to your applications folder. When running for the first time, right-click the app and select "Open", then confirm running an app from unidentified developer.

If you want the app to start on boot, follow these steps to add NearDrop as a login item.

Installation with Homebrew

brew install grishka/grishka/neardrop

Contributing

Pull requests that change the readme will not be accepted.

FAQ

The app would not open because "Apple cannot check it for malicious software", you gotta fix your shit

Right-click the app in Finder and select "Open". Or, open System Settings -> Privacy and security, scroll down and allow the app to run.

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. 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 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 is the app not notarized?

Because I don't want to pay Apple $99 a year for the privilege of developing macOS apps and I oppose their idea of security. The slightly less scary security warning isn't worth $99/year IMO.

Why is this not on the app store?

Because I don't want to pay Apple $99 a year for the privilege of developing macOS apps. I also don't want to have to go through the review process.

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, 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.