Changes between Version 22 and Version 23 of Sound

Timestamp:

12/11/13 10:19:37 (9 years ago)

Author:

Antoine Martin

Comment:

--

Sound

@@ +1 @@
+{{{#!div class="box"
 = Sound =
 
 Once the sound has started forwarding (and not before), you may get more diagnostic messages by setting {{{XPRA_SOUND_DEBUG=1}}}. (see [/wiki/Debugging Debugging])
 {{{XPRA_SOUND_QUEUE_TIME}}} can be used to control the default amount of buffering on the receiver.
+}}}
 
+
+{{{#!div class="box"
 == Status and Platform Quircks ==
-Sound is fairly stable in v0.9.x onwards on Posix platforms, as long as you use the latest version (see #396), there are still quirks to be ironed out for MS Windows (see #362) and OSX (see #379)
+Sound is fairly stable in v0.9.x onwards on Posix platforms, as long as you use the latest version (see #396), there are still quirks to be ironed out for MS Windows (see #362) and OSX (see #379).
+[[BR]]
+The only codec that is widely used is '''mp3'''.
+
+[[BR]]
 
 Useful development documentation:
@@ -12 +20 @@
 * [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/chapter-buffering.html Buffering]
 * [http://docs.gstreamer.com/display/GstSDK/Basic+tutorial+12%3A+Streaming Basic tutorial: Streaming]
+}}}
 
 
+{{{#!div class="box"
 == Requirements ==
 You will need:
@@ -20 +30 @@
 * a server with pulseaudio installed (for going beyond the simple test step)
 * users must be "pulseaudio-enabled" - whatever that means in terms of permissions and user setup (policy, user group, etc: this is distribution specific)
+}}}
 
+
+{{{#!div class="box"
 == Standalone Tests ==
 You can run the following test commands to run/test individual parts of the sound pipeline:
@@ -29 +42 @@
 * {{{./xpra/sound/src.py}}} will dump the sound coming from the pulseaudio server to a file until interrupted (named {{{Sound_Record.exe}}} on MS Windows)
 * {{{./xpra/sound/sink.py}}} will play a sound file until interrupted - a "cheap mp3 player" ({{{Sound_Play.exe}}} on MS Windows)
+}}}
 
 
+{{{#!div class="box"
 == 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).
@@ -43 +58 @@
 You should then hear a constant (rather annoying) tone.
 Getting this far ensures that sound forwarding does work on this system, albeit from a fake source instead of a pulseaudio server.
+}}}
 
 
+{{{#!div class="box"
 == Test Sound Output ==
 Since we use [http://gstreamer.freedesktop.org/ GStreamer] for sound support, the first thing to do is to check if gstreamer sound output works on your system.
@@ -53 +70 @@
 If the {{{autoaudiosink}}} does not work for you, you may want to try other options (availability varies): {{{pulsesink}}} ({{{PulseAudio}}}), {{{osxaudiosink}}} (OSX), {{{directsoundsink}}} (MS Windows), {{{alsasink}}} / {{{osssink}}} / {{{oss4sink}}} / {{{jackaudiosink}}} (Posix).
 If this does not work, please refer to [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gst-running.html Running GStreamer Applications] documentation (in particular {{{GST_DEBUG}}})
+}}}
 
+
+{{{#!div class="box"
 == Simple Diagnostics ==
 Things to look for:
@@ -65 +85 @@
 }}}
 * {{{pavucontrol}}} both on the client and inside the xpra session (see example screenshots below)
+}}}
 
+
+{{{#!div class="box"
 == 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.
@@ -90 +113 @@
 }}}
 Getting this far should ensure that all the components are installed, enabled and that the xpra server found the pulseaudio device to connect to.
+}}}
 
+
+{{{#!div class="box"
 == Test Remote Setup ==
 Using a second client machine (or a second desktop session, virtual machine, etc), we can connect this new client to the server and get the sound from the desktop session forwarded to the client.
@@ -96 +122 @@
 {{{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) - see screenshots below.
+}}}
 
+
+{{{#!div class="box"
 == Full Setup ==
 Finally, we may want an xpra session to use a dedicated pulseaudio server.
@@ -135 +164 @@
 
 And yet more log messages as your start a sound application in this xpra session.
+}}}
 
+
+{{{#!div class="box"
 == ALSA, OSS, etc ==
 The instructions above will make sound work with all applications that use pulseaudio for output.
 For those that do not, please see [http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/PerfectSetup PulseAudio Perfect Setup] to route their sound to pulseaudio.
+}}}
 
 
-
+{{{#!div class="box"
 == Screenshots ==
 * Sound information displayed on session info (with speaker enabled and running and microphone disabled):
@@ -154 +187 @@
 [[BR]]
 [[Image(/raw-attachment/wiki/Sound/pavucontrol-server.png)]]
+}}}