Adding a local player agent

scribblings/rkt-web-player.scrbl

@@ -2,7 +2,8 @@
 
 @(require (for-label racket/base
                      racket/contract
-                     rkt-web-player))
+                     rkt-web-player
+                     rkt-web-player/player-agent))
 
 @title{RKT Web Player}
 @author{Hans van Dijkema}
@@ -32,3 +33,15 @@ network renderer. Player resources are closed when the web server exits.
 The default listen address only exposes the interface to the local computer.
 Use a LAN address deliberately if other devices should control the player.
 }
+
+@defmodule[rkt-web-player/player-agent]
+
+@defproc[(run-player-agent) any/c] {
+
+Starts the graphical polling playback agent. The agent keeps a generated
+256-bit application identifier in a user-specific INI file, registers with the
+configured RKT Web Player server, downloads assigned tracks over HTTP, and
+plays them with @tt{racket-audio}. Its configured display name is authoritative
+and is followed by the server. Importing the module does not start the GUI; the
+function must be called explicitly.
+}