MPD Ansible Role

Description

This role installs a Music Player Daemon server.

Features

Configuration:

• Configure MPD music directory, output devices, and more…
• Ensure the Alsa device is unmuted on MPD start.
• Start MPD as socket service.

Security:

• Configure MPD user and password.
• Work with SElinux enforced.
• Configure the firewall.

Notes: The mpd role combines well with kodi role to create a multimedia computer.

Dependencies

OS recommendation

• “Fedora minimal” is recommended.
• “Fedora server” is recommended if its additional functionalities are required.

Roles

• common

Variables

Optional

Name	Default Value	Description
mpd_alsa_mixer	Master	Ensure the specified mixer control is unmuted before starting MPD.
mpd_audio_output	type "alsa" \n name "ALSA Device"	The MPD audio output using MPD audio output format.
mpd_auto_update	true	If true, enable auto-updates of the MPD database.
mpd_default_permissions	read,add,control,admin	The permission of the default unauthenticated user.
mpd_firewalld_source		If specified, restrict the MPD access to the specified sources list in CIDR notation (["192.168.1.10/32", "192.168.1.0/24", "2001:db8:1234:5678::/64"], …). By default, allow all machines from the current local network.
mpd_input_cache		If specified, use the specified input cache. Must be formatted using MPD input cache size format (Example: "1 GB").
mpd_music_directory	/var/lib/mpd/music	MPD music directory, can also be a share with specific scheme like nfs://, smb://, …
mpd_passwords		If specified, set the specified list of passwords and access rights. Must be formatted using MPD password format.
mpd_update	true	If true, update the MPD database after installation.
mpd_replaygain	auto	Replay gain mode to use.
mpd_use_cifs	false	If true, configure SELinux to allow MPT to access to CIFS/SMB shares.
mpd_use_nfs	false	If true, configure SELinux to allow MPT to access to NFS shares.
mpd_zeroconf	false	If true, enable Zeroconf/mDNS.

It is also recommended to look at the common role variables to customize the server OS (SSH, NTP, Firewall, and more).

Example Playbook

---
- hosts: all
  become: true
  force_handlers: true  # See "jgoutin.home.common" documentation
  collections:
    - jgoutin.home
  roles:
    - common
    - mpd
  vars:
    mpd_passwords:
      - my_password@read,add,control,admin
    mpd_default_permissions: read
    mpd_audio_output: |
       type            "alsa"
       name            "My sound card"
       device          "default:CARD=II"
       mixer_control   "Master"