Update README

Makefile

@@ -60,6 +60,9 @@ docs:
 		--doc_opt=markdown,RPC.md \
 		rpc/*.proto
 
+toc:
+	markdown-toc --maxdepth 2 -i README.md
+
 kick: kickstart
 kickstart:
 	launchctl kickstart -k system/com.apple.audio.coreaudiod

README.md

@@ -4,6 +4,28 @@
 
 > <h2>PROJECT IS WORK IN PROGRESS!</h2>
 
+<!-- toc -->
+
+- [What is this?](#what-is-this)
+- [How it works](#how-it-works)
+- [Features](#features)
+- [Platforms](#platforms)
+- [Install from binaries](#install-from-binaries)
+- [Install from sources](#install-from-sources)
+- [Usage](#usage)
+- [Sender configuration](#sender-configuration)
+- [Receiver configuration](#receiver-configuration)
+- [Troubleshooting](#troubleshooting)
+- [Common issues](#common-issues)
+- [Programmatic control](#programmatic-control)
+- [Socket address](#socket-address)
+- [Hacking](#hacking)
+- [Donating](#donating)
+- [Authors](#authors)
+- [License](#license)
+
+<!-- tocstop -->
+
 ## What is this?
 
 This repo provides macOS **Virtual Audio Device** (VAD) for **streaming audio** to or from remote devices. It is part of [Roc Toolkit](https://github.com/roc-streaming/roc-toolkit) project and is interoperable with both Roc and third-party software.
@@ -131,6 +153,16 @@ client:
   commit:  76ca125
 ```
 
+*TODO*
+
+## Sender configuration
+
+*TODO*
+
+## Receiver configuration
+
+*TODO*
+
 ## Troubleshooting
 
 To enable verbose logging of the command line tool, use `-v` flag. Specify it multiple times to increase verbosity:
@@ -201,6 +233,10 @@ More details are available here:
 * [driver_protocol.proto](rpc/driver_protocol.proto) - protocol definition
 * [RPC.md](RPC.md) - generated protocol documentation
 
+To use RPC interface, you'll need to copy `driver_protocol.proto` to your project and use gRPC to generate client code for the language of your choice ([1](https://grpc.io/docs/languages/), [2](https://github.com/grpc/grpc-swift)).
+
+Roc VAD RPC interface mostly mirrors underlying C API of Roc Toolkit. Please refer to [C API reference](https://roc-streaming.org/toolkit/docs/api/reference.html) for more details on semantics of various options.
+
 ## Socket address
 
 By default, driver starts (unauthenticated) gRPC server at `127.0.0.1:9712`.