soundbox

Documentation

Overview

Example (Pipewire)

package main

import (
	"context"
	"log"
	"net"
	"time"

	"xengineering.eu/soundbox-go/soundbox"
)

func main() {
	ctx, cancel := context.WithCancel(context.Background())

	// all soundboxes are referenced by their MAC address
	soundboxes := []net.HardwareAddr{
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x01},
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x02},
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x03},
	}

	// start streaming
	go func() {
		err := soundbox.StreamPipewireContext(ctx, soundboxes)
		if err != nil {
			log.Fatal(err)
		}
	}()

	// let it play for some time
	time.Sleep(time.Minute)

	// stop it
	cancel()
}

Example (Url)

package main

import (
	"context"
	"log"
	"net"
	"time"

	"xengineering.eu/soundbox-go/soundbox"
)

func main() {
	ctx, cancel := context.WithCancel(context.Background())

	// all soundboxes are referenced by their MAC address
	soundboxes := []net.HardwareAddr{
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x01},
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x02},
		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x03},
	}

	// currently only web radio is supported
	url := "https://example.org/radio.mp3"

	// start streaming
	go func() {
		err := soundbox.StreamURLContext(ctx, url, soundboxes)
		if err != nil {
			log.Fatal(err)
		}
	}()

	// let it play for some time
	time.Sleep(time.Minute)

	// stop it
	cancel()
}

Index

• func StreamPipewireContext(ctx context.Context, targets []net.HardwareAddr) error
• func StreamURLContext(ctx context.Context, url string, targets []net.HardwareAddr) error

Examples

• Package (Pipewire)
• Package (Url)

Functions

func StreamPipewireContext

func StreamPipewireContext(ctx context.Context, targets []net.HardwareAddr) error

func StreamURLContext

func StreamURLContext(ctx context.Context, url string, targets []net.HardwareAddr) error

StreamURLContext streams audio from a given URL to one or multiple soundbox devices. The devices are referenced via their MAC addresses given by the targets argument. The ctx argument is passed to cancel the streaming.