Changes between Version 3 and Version 4 of Sound

Timestamp:

01/07/13 10:12:40 (9 years ago)

Author:

Antoine Martin

Comment:

re-order things

Sound

@@ -3 +3 @@
 ''Note: at the moment sound is disabled by default so all commands must be started with the environment variable {{{XPRA_SOUND}}} set to any non-zero value. ie:
 {{{
-XPRA_SOUND=1 xpra start :10
+export XPRA_SOUND=1
+xpra start :10
 }}}
 ''
@@ -13 +14 @@
 You will need:
 * a build/installation including gstreamer support for both client and server
-* a server with pulseaudio
 * a client with sound output of any kind (even virtual)
+* a server with pulseaudio (for going beyond the simple test step)
 
-== Existing Desktop Test Setup ==
-The easiest way of testing that a system is capable of forwarding and receiving sound is on a Posix system (Linux, BSD, etc) with an existing desktop environment running, and including a pulseaudio server.
-Check that pulseaudio is running:
+== Test Sound Source Setup ==
+The easiest way of testing that a system is capable of forwarding and receiving sound is on a Posix system (Linux, BSD, etc).
+Using the {{{XPRA_SOUND_TEST}}} environment variable, we can instruct the xpra server to use a fake sound source instead of hooking into a pulseaudio server:
+{{{
+XPRA_SOUND_TEST=1 xpra start :10
+}}}
+Then we can attach the client and start the speaker from the tray:
+{{{
+xpra attach
+}}}
+Getting this far ensures that sound forwarding does work on this system, albeit from a fake source instead of pulseaudio.
+
+
+== Using an existing pulseaudio server ==
+Next, we want to add pulseaudio, but without starting it ourselves, so we can simply re-use the existing server that gets started with most modern desktops.
+[[BR]]
+Check that pulseaudio is running in your Posix desktop:
 {{{
 pactl info
@@ -34 +49 @@
 identical pulseaudio server, refusing to create a sound loop - sound disabled
 }}}
-Getting this far should ensure that all the components are installed and enabled.
-
-== Test Sound Source Setup ==
-Instead of using an existing pulseaudio server, one can use a test sound source by specifying this environment variable:
-{{{
-XPRA_SOUND_TEST=1 xpra start ...
-}}}
-This allows you to actually start the sound forwarding from the same machine and the same user account, without needing to start a new pulseaudio server. The downside is that all you will hear is a test tone.
-Getting this far ensures that sound forwarding does work, albeit from a fake source instead of pulseaudio.
+Getting this far should ensure that all the components are installed, enabled and that the xpra server found the pulseaudio device to connect to.
 
 == Test Remote Setup ==
@@ -49 +56 @@
 {{{pavucontrol}}} on the server should show an Xpra entry in the {{{Recording}}} tab.
 The client should show an Xpra entry in the {{{Playback}}} tab (or whatever mixer/sound tool you have installed)
-