Skip to content

Commit

Permalink
update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
speidy committed Aug 3, 2018
1 parent c1d50a8 commit 4271fbb
Showing 1 changed file with 23 additions and 28 deletions.
51 changes: 23 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,8 @@ not available with other clients.
Here is how to build pulseaudio modules for your distro, so you can have audio
support through xrdp.

# Prerequisites
Prepare xrdp source in your home directory. Of course, you can choose another
directory.

cd ~
git clone https://github.com/neutrinolabs/xrdp.git

In this instruction, pulseaudio version is **10.0**. Replace the version number
in this instruction if your environment has different versions. You can find
In this instruction, pulseaudio version is **11.1**. You need to **replace the version
number in this instruction** if your environment has different versions. You can find
out your pulseaudio version executing the following command:

pulseaudio --version
Expand All @@ -48,21 +41,22 @@ Install pulseaudio and requisite packages to build pulseaudio.
apt install pulseaudio
apt build-dep pulseaudio

Fetch the pulseaudio source . You'll see `pulseaudio-10.0` directory in your
Fetch the pulseaudio source . You'll see `pulseaudio-11.1` directory in your
current directory.

apt source pulseaudio

Enter into the directory and build the pulseaudio package.

cd pulseaudio-10.0
cd pulseaudio-11.1
./configure

Finally, let's make. You'll have two .so files `module-xrdp-sink.so` and
Finally, let's build xrdp source / sink modukes. You'll have two .so files `module-xrdp-sink.so` and
`module-xrdp-source.so`.

cd ~/xrdp/sesman/chansrv/pulse
make PULSE_DIR="~/pulseaudio-10.0"
git clone https://github.com/neutrinolabs/pulseaudio-modules.git
cd pulseaudio-modules
make PULSE_DIR="~/pulseaudio-11.1"

## Other distro

Expand All @@ -74,38 +68,39 @@ command. Download the tarball of the pulseaudio version that you have.
After downloading the tarball, extact the tarball and `cd` into the source
directory, then run `./configure`.

wget https://freedesktop.org/software/pulseaudio/releases/pulseaudio-10.0.tar.xz
tar xf pulseaudio-10.0.tar.gz
cd pulseaudio-10.0
wget https://freedesktop.org/software/pulseaudio/releases/pulseaudio-11.1.tar.xz
tar xf pulseaudio-11.1.tar.gz
cd pulseaudio-11.1
./configure

If additional packages are required to run `./configure`, install requisite
packages depending on your environment.

Finally, let's make. You'll have two .so files `module-xrdp-sink.so` and
Finally, let's build xrdp source / sink modukes. You'll have two .so files `module-xrdp-sink.so` and
`module-xrdp-source.so`.

cd ~/xrdp/sesman/chansrv/pulse
make PULSE_DIR="~/pulseaudio-10.0"
git clone https://github.com/neutrinolabs/pulseaudio-modules.git
cd pulseaudio-modules
make PULSE_DIR="~/pulseaudio-11.1"

# Install

Install process is not distro specific except for install destination. Install
built two .so files into the pulseaudio modules directory. Typically,
`/usr/lib/pulse-10.0/modules` for Debian, `/usr/lib64/pulse-10.0/modules` for
CentOS 7. Other distro might have different path. Find out the right path for
your distro.
`/usr/lib/pulse-11.1/modules` for Debian, `/usr/lib64/pulse-10.0/modules` for
CentOS 7. Other distro might have different path. Find out the right path and
version that matches your distro/system.

Look into the directory with `ls` command. You'll see lots of `module-*.so`
files. There's the place!
files. There's the place! now `cd` to `pulseaudio-modules` directory and copy them.

cd ~/xrdp/sesman/chansrv/pulse
for f in *.so; do install -s -m 644 $f /usr/lib/pulse-10.0/modules; done
cd pulseaudio-modules
for f in *.so; do install -s -m 644 $f /usr/lib/pulse-11.1/modules; done

This command is equivalent to following:

install -s -m 644 module-xrdp-sink.so /usr/lib/pulse-10.0/modules
install -s -m 644 module-xrdp-source.so /usr/lib/pulse-10.0/modules
install -s -m 644 module-xrdp-sink.so /usr/lib/pulse-11.1/modules
install -s -m 644 module-xrdp-source.so /usr/lib/pulse-11.1/modules

Well done! Pulseaudio modules should be properly built and installed.

Expand Down

0 comments on commit 4271fbb

Please sign in to comment.