Setting up Mopidy on a Raspberry Pi

Published on .

A couple weekends ago I set up a Mopidy server on my Raspberry Pi. Mopidy describes itself as a “music server”:

Mopidy plays music from local disk, Spotify, SoundCloud, Google Play Music, and more. You can edit the playlist from any phone, tablet, or computer using a variety of MPD and web clients.

I have a stereo receiver in my office that I use for my turntable, but because of the layout of the room the receiver is on the wall opposite my desk, where my computer is. If I want to listen to music via Spotify or local files I need to connect to the receiver with Bluetooth — it works okay, but I’ve been using it eight hours a day while working from home the past couple months and the dropped connections and radio interference are becoming frequent and annoying enough that I want a hard wired solution. I ended up settling on Mopidy on a Raspberry Pi 3 Model B running Raspbian Buster, connected to Spotify, YouTube, and, and local storage. I chose the 3 B because I already had one that was only being used as a Borg backup server.

Trying to hold myself to more of a regular schedule of writing here — hopefully every weekend — so I figured I would just type up my notes on its installation and configuration, and the small Ansible playbook I wrote to automate it.

First, add the public key for the Mopidy PPA to apt’s trusted keys, and install the repo.

- name: Add Mopidy PPA key
    state: present
  become: yes
  become_user: root

- name: Install Mopidy Debian Buster PPA
    dest: /etc/apt/sources.list.d/mopidy.list
    force: no
    mode: 0644
    owner: root
    group: root
  become: yes
  become_user: root

Then you can install all the packages you need. Mopidy is a modular system. The Mopidy application itself is just the server — you have to install other extensions to get more features, like a web UI, Spotify connectivity, etc. Altogether I’m installing five applications: Mopidy, the Mopidy server itself; Iris, a web UI for the server; Mopidy-Spotify, an extension for playing Spotify; Mopidy-YouTube for playing music from YouTube (today’s crate digging); Mopidy-Scrobbler to connect to Some are available in Raspbian’s repos, and some I need to install via pip.

- name: Install Mopidy Debian packages
      - mopidy
      - python3-pip
      - mopidy-spotify
      - gstreamer1.0-plugins-bad
    state: latest
  become: yes
  become_user: root

- name: Install Mopidy Python3 packages
    executable: /usr/bin/pip3
      - Mopidy-Iris
      - Mopidy-Youtube
      - Mopidy-Scrobbler
    state: present

Everything is configured via a single config file that lives in /etc/mopidy/mopidy.conf. The configuration contains secrets — passwords and API keys. Since my Ansible config lives in a public GitHub repo I put the config file into a Jinja template and pull the secrets from environment variables.

My template looks like this:

enabled = true
hostname =
port = 6680
zeroconf = Mopidy HTTP server on $hostname
allowed_origins = 
csrf_protection = true
default_app = iris

country = us
locale = en_US

username = becomingyolo
password = {{ lookup('env', 'SPOTIFY_PASSWORD') }}
client_id = {{ lookup('env', 'MOPIDY_SPOTIFY_CLIENT_ID') }}
client_secret = {{ lookup('env', 'MOPIDY_SPOTIFY_CLIENT_SECRET') }}
bitrate = 320

enabled = true

username = becoming-yolo
password = {{ lookup('env', 'LASTFM_PASSWORD') }}

This Ansible block installs it in the right place and sets permissions:

- name: Install /etc/mopidy/mopidy.conf
    src: mopidy.conf.j2
    dest: /etc/mopidy/mopidy.conf
    owner: mopidy
    group: root
    mode: 0640
  become: yes
  become_user: root

Iris needs to run its install script with elevated privileges.

- name: Ensure Iris has access to install itself
    path: /etc/sudoers
    regexp: '^mopidy'
    line: "mopidy ALL=NOPASSWD: /usr/local/lib/python3.7/dist-packages/mopidy_iris/"
  become: yes
  become_user: root

With all of that in place, the only thing left to do is start and enable the mopidy service.

- name: Start and enable mopidy service
    name: mopidy
    state: started
    enabled: yes
  become: yes
  become_user: root

Overall I’ve been happy with Mopidy. Iris has a mature interface that should be familiar to anyone who’s used Spotify. It was simple to set up, and a definite step up from the Bluetooth setup was using before.