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.

###Limitation The only Medium supported is Wifi LAN.

To build the Nearby Connection library, just type:

swift build

Last Updated: April 2022