tree: 0675433d2fa124828af3213c50226f81ec348e24 [path history] [tgz]
  1. connections/
  2. cpp/
  3. docs/
  4. internal/
  5. proto/
  6. third_party/
  7. .bazelrc
  8. .gitignore
  9. .gitmodules

Nearby C++ Library

The repository contains the Nearby project C++ library 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


Currently we provide precompiled libraries. See the following page for instructions.

Last Updated: Feb 2022