From 46eb6a73d79c37326225989d29bd2a4556b9aeaf Mon Sep 17 00:00:00 2001
From: Salt <rehashedsalt@cock.li>
Date: Mon, 25 Jan 2021 19:38:55 -0600
Subject: [PATCH] Make Pulse role more modular

---
 roles/pulseaudio/README.md                   | 11 +++++++++
 roles/pulseaudio/defaults/main.yml           | 24 +++++++++++++++++++
 roles/pulseaudio/templates/pulse-daemon.conf | 25 ++++++++++----------
 3 files changed, 47 insertions(+), 13 deletions(-)
 create mode 100644 roles/pulseaudio/README.md
 create mode 100644 roles/pulseaudio/defaults/main.yml

diff --git a/roles/pulseaudio/README.md b/roles/pulseaudio/README.md
new file mode 100644
index 0000000..7240975
--- /dev/null
+++ b/roles/pulseaudio/README.md
@@ -0,0 +1,11 @@
+# pulseaudio
+
+Role to configure Pulseaudio as a system-wide daemon *without* using Pulse in system mode.
+
+## What?
+
+Pulseaudio runs as its own server with control over the audio hardware in `pulseaudio.service`. It listens on a socket in `/tmp/pulse-server` responding to members of the `audio` group.
+
+## Why?
+
+It allows for clean, efficient multi-user setups.
diff --git a/roles/pulseaudio/defaults/main.yml b/roles/pulseaudio/defaults/main.yml
new file mode 100644
index 0000000..f68ed20
--- /dev/null
+++ b/roles/pulseaudio/defaults/main.yml
@@ -0,0 +1,24 @@
+# vim:ft=ansible:
+# Flat volumes are the behavior where Pulse uses one global audio slider
+# instead of allowing for per-application, per-sink control.
+pulse_flat_volumes: "no"
+# Sample rate; pretty self-explanatory
+# Consider setting to 96000 if you have high-quality headphones
+pulse_sample_rate: 48000
+pulse_sample_rate_alternate: 44100
+# For some reason, Pulse does 16-bit sampling by default. This fixes that
+pulse_sample_format: s32le
+# Sometimes Pulse has to resample; speex-float-5 is pretty solid
+pulse_resample_method: speex-float-5
+pulse_resample_avoid: "true"
+# Latency settings; increase if you get stuttering
+# "Size" is in milliseconds
+pulse_latency_fragments: 5
+pulse_latency_fragment_size: 10
+
+## You shouldn't have to mess with these settings
+
+# Should the process be marked as high-priority?
+pulse_high_priority: "yes"
+# What level should Pulse renice itself to on startup?
+pulse_nice_level: -19
diff --git a/roles/pulseaudio/templates/pulse-daemon.conf b/roles/pulseaudio/templates/pulse-daemon.conf
index 11af05c..35c23cc 100644
--- a/roles/pulseaudio/templates/pulse-daemon.conf
+++ b/roles/pulseaudio/templates/pulse-daemon.conf
@@ -1,23 +1,22 @@
-# Configuration file for the PulseAudio daemon. See pulse-daemon.conf(5) for
-# more information. Default values are commented out.  Use either ; or # for
-# commenting.
+# See pulse-daemon.conf(5) for more info
+# This file managed via Ansible
 
 # Bugfixes for my desktop's audio card
 realtime-scheduling = no # Fixes a weird stutter issue
 
 # Sanity
-flat-volumes = no
+flat-volumes = {{ pulse_flat_volumes }}
 
 # Audio Quality
-default-sample-format = s32le # Pulse does 16bit sampling by default for some reason
-default-sample-rate = 48000 # Higher sample rate than default
-alternate-sample-rate = 44100
-resample-method = speex-float-5 # Increase resampling quality
-avoid-resampling = true
+default-sample-format = {{ pulse_sample_format }} # Pulse does 16bit sampling by default for some reason
+default-sample-rate = {{ pulse_sample_rate }}
+alternate-sample-rate = {{ pulse_sample_rate_alternate }}
+resample-method = {{ pulse_resample_method }} # Increase resampling quality
+avoid-resampling = {{ pulse_resample_avoid }}
 
-default-fragments = 5 # Pulse, why are you so friggin latent by default?
-default-fragment-size-msec = 10
+default-fragments = {{ pulse_latency_fragments }} # Pulse, why are you so friggin latent by default?
+default-fragment-size-msec = {{ pulse_latency_fragment_size }}
 
-high-priority = yes
-nice-level = -19
+high-priority = {{ pulse_high_priority }}
+nice-level = {{ pulse_nice_level }}