{"id":17043896,"url":"https://github.com/sbosley/roon-api-grpc-bridge","last_synced_at":"2025-10-04T04:32:39.259Z","repository":{"id":38637697,"uuid":"187748941","full_name":"sbosley/roon-api-grpc-bridge","owner":"sbosley","description":"Roon extension that exposes gRPC APIs for the core Roon APIs","archived":false,"fork":false,"pushed_at":"2025-01-14T23:33:27.000Z","size":99,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T15:11:55.915Z","etag":null,"topics":["roon","roon-extension"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sbosley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-21T02:41:31.000Z","updated_at":"2025-01-14T23:33:31.000Z","dependencies_parsed_at":"2024-06-20T08:18:53.505Z","dependency_job_id":"bb8782eb-3ef4-4132-a7e9-fc40c71db406","html_url":"https://github.com/sbosley/roon-api-grpc-bridge","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbosley%2Froon-api-grpc-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbosley%2Froon-api-grpc-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbosley%2Froon-api-grpc-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sbosley%2Froon-api-grpc-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sbosley","download_url":"https://codeload.github.com/sbosley/roon-api-grpc-bridge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248586244,"owners_count":21128998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["roon","roon-extension"],"created_at":"2024-10-14T09:31:36.500Z","updated_at":"2025-10-04T04:32:34.200Z","avatar_url":"https://github.com/sbosley.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Roon API gRPC Bridge\nThis project is a [Roon Extension](https://github.com/RoonLabs/node-roon-api). Running this extension starts a [gRPC](https://grpc.io/) server that acts as a bridge to RoonBrowseApi, RoonImageApi, and RoonTransportApi for a single paired core. gRPC services are defined using [protocol buffers](https://developers.google.com/protocol-buffers/), which allows generating idiomatic client libraries for the service in [9+ languages](https://grpc.io/docs/). This project includes a protobuf service definition matching the Roon client APIs, allowing API consumers to use an idiomatic client library in their preferred language to interact with the Roon API, rather than being restricted to using Node.js. \n\n## Setup\nThis project and its examples are built with [Bazel](https://bazel.build). To build and run from source, you will need to first install Bazel for your platform using the instructions provided [here](https://docs.bazel.build/versions/master/install.html). Bazel will manage its own versions of all the project's dependencies (including the Node.js runtime for the server and Go SDK + protobuf compiler for the examples), so in theory you shouldn't need to install anything else.\n\nAs an alternative, if you don't need to run the examples and would prefer not to install Bazel, you can run the extension using Node.js directly.\n\n## Bridge Server\nThe service definition can be found in `protos/roon.proto`. The `protos/BUILD` file contains an example of using Bazel to generate a service client library for Go. If you want to use the service definition from another language/platform, you can either use Bazel to define additional language-specific build rules depending on the `//protos:roon_proto` target, or invoke the gRPC proto compiler for your preferred language manually on the `roon.proto` file. See the [gRPC Docs](https://grpc.io/docs/) for instructions on getting started for various platforms.\n\n## Running with Bazel\nTo run the bridge server using Bazel, run the following from the repository root:\n```\nbazel run //:bridge-server\n```\nThe gRPC API started by the extension will bind to `0.0.0.0:50051` by default. The host and port may alternatively be specified with the `--host` argument:\n```\nbazel run //:bridge-server -- --host 127.0.0.1:5678\n```\nBazel will install and manage its own instance of Node.js along with the bridge-server's npm dependencies, so this is the easiest way to get up and running without any additional setup.\n\n## Running with Node\nTo run using an existing Node.js installation, first install the bridge server dependencies using `npm install`. Then from the repository root, run:\n```\nnode .\n# Or, when using the --host arg:\nnode . --host 127.0.0.1:5678\n```\n\n## Extension authorization\nThe first time you run the bridge server, you will need to authorize it in Roon. This can be done from Settings\u003eExtensions.\n\n## Running the example\nThe `examples` directory contains an example Go client calling the gRPC API. The example calls `ListAllZones` and logs the output, then does a series of `Browse` and `Load` calls to demonstrate playing an album from the Roon library in the given zone (it chooses the first in the album list for demo purposes).\nTo run the example using Bazel, run the following from the repository root:\n```\nbazel run //examples:bridge_client\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsbosley%2Froon-api-grpc-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsbosley%2Froon-api-grpc-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsbosley%2Froon-api-grpc-bridge/lists"}