Clone this repo:
  1. 8765e5b Bug fixes for 233012255 and 232995024 by jfcarroll · 30 minutes ago master
  2. 8867721 Add reset for std::promise by aaronyujiaze · 81 minutes ago
  3. 500f67c Add Wifi Medium to query WIFI interface capability and information by hai007 · 2 hours ago
  4. ea939b7 Add connection attempt type into the established connection for distinguishing the initial and upgrade in the pipeline. So we could get the information of: by hai007 · 8 hours ago
  5. f39770d Fixes Flaky test by set larger timer(100 ->1000 ms) for CancelableAlarm. by edwinwu · 32 hours ago

Nearby C++ Library

The repository contains the Nearby project C++ library source code. This is not an officially supported Google product.

About the Nearby Project

Nearby Connection

Nearby Connections is a high level protocol on top of Bluetooth/WiFi that acts as a medium-agnostic socket. Devices are able to advertise, scan, and connect with one another over any shared medium (eg. BT <-> BT). Once connected, the two devices share a list of all supported mediums and attempt to upgrade to the one with the highest bandwidth (eg. BT -> WiFi). The connection is encrypted, reliable, and fully duplex. BYTE, FILE, and STREAM payloads are all supported and will be chunked & transferred internally and recombined on the receiving device. See Nearby Connections Overview for more information.

Checkout the source tree

git clone
cd nearby
git submodule update --init --recursive

Building Nearby, Unit Testing and Sample Apps

We support multiple platforms including Linux, iOS & Windows.

Building for Linux

Currently we support building from source using [bazel] ( Other BUILD system such as cmake may be added later.


  1. Bazel
  2. clang with support for c++ 17+
  3. Openssl (-lssl;-lcrypto).

To build the Nearby Connection Core library:

CC=clang CXX=clang++ bazel build -s --check_visibility=false //connections:core  --spawn_strategy=standalone --verbose_failures

Building for macOS and iOS

Currently we support building with Swift Package Manager.


  1. Xcode. Available from Apple Store.
  2. Google Protobuf Compiler (protoc). If you have homebrew installed, you can do brew install protobuf.

To build the Nearby Connection library:

swift build

We also provide a iOS [sample app using the Nearby Connections library] (


The only Medium supported is Wifi LAN.

Last Updated: April 7, 2022