Pixa.Soundbridge 1.0.0

Pixa.Soundbridge

Table of Contents

• About
• Getting Started
• Installing
• Usage

About <a name="about"></a>

This is a library for interacting with Roku Soundbridge, a network music player that Roku made before they were known for set-top boxes. Soundbridges can be controlled over the network with a text based protocol called RCP. This library implements an RCP client for the .net platform.

Getting Started <a name="getting_started"></a>

You'll need a .net project targetting a .net implementation implementing .net standard 2.0 or later and a Roku Soundbridge, either that you've owned for the past 15 years or bought on ebay for the nostalgia.

Installing <a name="installing"></a>

Nuget Package

Pixa.Soundbridge is available as a nuget package on nuget.org. You can install it with one of the following commands:

Package Manager

From the Package Manager Console in Visual Studio with the project you wish to reference this library selected type:

Install-Package Pixa.Soundbridge

.net CLI

With the .net core SDK installed and at a command prompt at the directory where the project file you wish to reference this library is located type:

dotnet add package Pixa.Soundbridge

PackageReference

Edit the project file you wish to reference this library and add the following to any ItemGroup section:

<PackageReference Include="Pixa.Soundbridge"/>

Usage <a name="usage"></a>

Connect to a Soundbridge

using Pixa.Soundbridge;

...

var soundbridgeIPAddress = "192.168.123.456";
var sb = SoundbridgeFactory.CreateFromTcp(soundbridgeIPAddress);

Connect the Soundbridge to a server

// Get a list of the servers the soundbridge can see
var servers = sb.GetServers();

// Connect to a specific server
var serverName = "My Media Server";
var server = servers["My Media Server"];

Play some music

// Open a container

var c1 = server.Container.GetChildContainers()["Audio"];
c1.Enter();
var c2 = c1.GetChildContainers()["Random Music"];
c2.Enter();
c2.GetSongs().Play();