MyFavMirrors/owntone-server
1
0
Fork 0
mirror of https://github.com/owntone/owntone-server.git synced 2025-01-26 06:03:20 -05:00
Code Issues Packages Projects Releases Wiki Activity

[docs] Pulseaudio/Bluetooth instructions (credit Rob Pope)

Browse Source
This commit is contained in:
ejurgensen 2016-09-29 22:48:27 +02:00
parent 27bb2b6c5a
commit 09a0efa9ad
1 changed files with 45 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
README_PULSE.md
View File

@ -1,10 +1,13 @@
# forked-daapd and Pulseaudio
Credit: [Rob Pope](http://robpope.co.uk/blog/post/setting-up-forked-daapd-with-bluetooth)
## Setting up Pulseaudio
## Step 1: Setting up Pulseaudio in system mode with Bluetooth support
If you see a "Connection refused" error when starting forked-daapd, then you
will probably need to setup Pulseaudio to run in system mode. This means that
the Pulseaudio daemon will be started during boot and be available to all users.
will probably need to setup Pulseaudio to run in system mode [1]. This means
that the Pulseaudio daemon will be started during boot and be available to all
users.
How to start Pulseaudio depends on your distribution, but in many cases you will
need to add a pulseaudio.service file to /etc/systemd/system with the following
@ -23,22 +26,54 @@ ExecStart=/usr/bin/pulseaudio --system --disallow-exit
WantedBy=multi-user.target
```
After you have added the file you can start it with "systemctl start pulseaudio"
and enable it on boot with "systemctl enable pulseaudio".
If you want Bluetooth support, you must also configure Pulseaudio to load the
Bluetooth module. Do this by adding the following to /etc/pulse/system.pa:
```
### Enable Bluetooth
.ifexists module-bluetooth-discover.so
load-module module-bluetooth-discover
.endif
```
Now you can:
- (re)start Pulseaudio with `systemctl restart pulseaudio`
- enable system mode on boot with `systemctl enable pulseaudio`
- check that the Bluetooth module is loaded with `pactl list modules short`
## Setting up forked-daapd:
## Step 2: Setting up forked-daapd
Add the forked-daapd user to the pulse-access group:
Add the user forked-daapd is running as (typically "daapd") to the
"pulse-access" group:
```
adduser daapd pulse-access
```
Now (re)start forked-daapd.
## Bluetooth
[TBD]
## Step 3: Adding a Bluetooth device
(this page is work in progress)
To connect with the device, run `bluetoothctl` and then:
```
power on
agent on
scan on
**Note MAC address of BT Speaker**
pair [MAC address]
**Type Pin if prompted**
trust [MAC address]
connect [MAC address]
```
Now the speaker should appear in forked-daapd. You can also verify that
Pulseaudio has detected the speaker with `pactl list sinks short`.
---
[1] Note that Pulseaudio will warn against system mode. However, in this use
case it is actually the solution recommended by the [Pulseaudio folks themselves](https://lists.freedesktop.org/archives/pulseaudio-discuss/2016-August/026823.html).