🎉 live server seems to be working now

third_party/sendspin-go/examples/basic-server/README.md

@@ -0,0 +1,101 @@
+# Basic Server Example
+
+This example demonstrates how to create a simple Sendspin streaming server that broadcasts a test tone to connected players.
+
+## What it does
+
+- Creates a Sendspin server that streams a 440Hz test tone
+- Listens for WebSocket connections from players
+- Broadcasts synchronized audio to all connected clients
+- Supports mDNS service advertisement for easy discovery
+- Handles multiple clients with different codec preferences
+
+## Building
+
+```bash
+cd examples/basic-server
+go build
+```
+
+## Running
+
+Start server with defaults (192kHz/24-bit stereo):
+
+```bash
+./basic-server
+```
+
+Start on a different port:
+
+```bash
+./basic-server -port 9000
+```
+
+Configure sample rate and channels:
+
+```bash
+./basic-server -rate 48000 -channels 2
+```
+
+Disable mDNS:
+
+```bash
+./basic-server -mdns=false
+```
+
+## Command-line options
+
+- `-port` - Server port (default: 8927)
+- `-name` - Server name (default: "Basic Server")
+- `-rate` - Sample rate in Hz (default: 192000)
+- `-channels` - Number of channels (default: 2)
+- `-mdns` - Enable mDNS advertisement (default: true)
+
+## Key features demonstrated
+
+1. **Simple setup** - Just create a source and start the server
+2. **Test tone generation** - Built-in test tone for easy testing
+3. **Automatic client handling** - Clients are managed automatically
+4. **Multi-codec support** - Automatically negotiates best codec per client
+5. **mDNS discovery** - Clients can find the server automatically
+
+## Code highlights
+
+```go
+// Create audio source (440Hz test tone)
+source := sendspin.NewTestTone(192000, 2)
+
+// Create and start server
+config := sendspin.ServerConfig{
+    Port:       8927,
+    Name:       "My Server",
+    Source:     source,
+    EnableMDNS: true,
+}
+
+server, _ := sendspin.NewServer(config)
+server.Start()
+```
+
+## Testing
+
+Start the server:
+
+```bash
+./basic-server
+```
+
+In another terminal, connect a player:
+
+```bash
+cd ../..
+go run . -server localhost:8927
+```
+
+You should hear a 440Hz tone (A4 note) playing.
+
+## Next steps
+
+- See `examples/custom-source/` for implementing custom audio sources (files, streams, etc.)
+- Check out the server CLI (`cmd/sendspin-server/`) for a full-featured server with TUI
+- Modify the test tone frequency or add multiple frequencies for testing

third_party/sendspin-go/examples/basic-server/main.go

@@ -0,0 +1,77 @@
+// ABOUTME: Basic Sendspin server example
+// ABOUTME: Demonstrates how to create a simple streaming server
+package main
+
+import (
+	"flag"
+	"log"
+	"os"
+	"os/signal"
+	"syscall"
+
+	"github.com/Sendspin/sendspin-go/pkg/sendspin"
+)
+
+func main() {
+	port := flag.Int("port", 8927, "Server port")
+	serverName := flag.String("name", "Basic Server", "Server name")
+	sampleRate := flag.Int("rate", 192000, "Sample rate (Hz)")
+	channels := flag.Int("channels", 2, "Number of channels")
+	enableMDNS := flag.Bool("mdns", true, "Enable mDNS service advertisement")
+	flag.Parse()
+
+	log.Printf("Creating test tone source: %dHz, %d channels", *sampleRate, *channels)
+
+	source := sendspin.NewTestTone(*sampleRate, *channels)
+
+	config := sendspin.ServerConfig{
+		Port:       *port,
+		Name:       *serverName,
+		Source:     source,
+		EnableMDNS: *enableMDNS,
+		Debug:      false,
+	}
+
+	server, err := sendspin.NewServer(config)
+	if err != nil {
+		log.Fatalf("Failed to create server: %v", err)
+	}
+
+	log.Printf("Starting Sendspin server...")
+	log.Printf("  Name: %s", *serverName)
+	log.Printf("  Port: %d", *port)
+	log.Printf("  Audio: %dHz, %d channels, 24-bit", *sampleRate, *channels)
+	if *enableMDNS {
+		log.Printf("  mDNS: enabled")
+	}
+
+	errChan := make(chan error, 1)
+	go func() {
+		if err := server.Start(); err != nil {
+			errChan <- err
+		}
+	}()
+
+	// Print client info periodically
+	go func() {
+		for {
+			select {
+			case <-make(chan struct{}):
+			}
+		}
+	}()
+
+	log.Printf("\nServer running. Press Ctrl+C to stop")
+	sigChan := make(chan os.Signal, 1)
+	signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)
+
+	select {
+	case <-sigChan:
+		log.Printf("Received interrupt signal, shutting down...")
+	case err := <-errChan:
+		log.Printf("Server error: %v", err)
+	}
+
+	server.Stop()
+	log.Printf("Server stopped")
+}