Media Systems¶

The web interface is accessible via port 1337:

• URL: http://<your.IP>:1337

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

Simply select the Update DB button from the settings menu in ympd.

• Tweak audio options on the fly with the panel.

• Simply run dietpi-justboom from the command line to launch it.

  

The web interface is accessible via port 1333:

• URL: http://<your.IP>:1333

We have disabled SSL and its redirect by default with the DietPi install. This is to prevent redirects to the hostname.
To re-enable the SSL connection and redirect option:

• Edit /etc/mympd.conf
• Replace ssl = false with ssl = true
• Save changes and exit
• Restart services with systemctl restart mympd
• Use the same URL address above, it will redirect to HTTPS during connection

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

Simply select the Update database option from the settings menu in myMPD.

• Tweak audio options on the fly with the panel.

• Simply run dietpi-justboom from the command line to launch it.

  

• URL: http://<your.IP>/ompd
• Username: admin
• Password: admin

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

Click the settings button (cog, top right).
Click update.

If you did not select CAVA to start from boot:

• CAVA can also be run by typing cava. Use Ctrl+C to terminate.
• You can modify the autostart options in dietpi-autostart.

• Tweak CAVA options on the fly with the panel.

• Simply run dietpi-justboom from the command line to launch it.

  

The web interface uses port 6680:

• URL: http://<your.IP>:6680/musicbox_webclient or just http://<your.IP>:6680

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

This is done automatic, however, you can force an update using the command

mopidyctl local scan

Mopidy is highly customisable and supports various extensions from alternative web clients to backend extensions. See Extensions for a list.

Those can be installed via pip, e.g.:

pip3 install --no-cache-dir -U Mopidy-Jellyfin

or on Stretch:

pip2 install --no-cache-dir -U Mopidy-Jellyfin

Enable support for vast number of codecs like .m4a. Execute the following installation procedure:

apt-get install -y gstreamer1.0-plugins-bad

Many thanks to Roth for this hint.

The web interface uses port 8080:

• URL: http://<your.IP>:8080/airsonic
• Username: admin
• Password: admin

Once connected to the web interface for the first time, we recommend to do the following setup steps:

First we check off the Getting started page and head over to Settings:

On the Media folders tab we change the path to DietPi’s default music directory /mnt/dietpi_userdata/Music, save and scan the new media directory:

On the Credentials tab we add a new admin password, the default bcrypt encoding is very good for secure password storage. Then we delete the initial default password:

The install, config and data directory is located at:

/mnt/dietpi_userdata/airsonic

Since Airsonic-Advanced runs as systemd service, it can be controlled with the following commands:

systemctl status airsonic

systemctl start airsonic

systemctl stop airsonic

systemctl restart airsonic

Since Airsonic-Advanced runs as systemd service, its logs can be viewed via:

journalctl -u airsonic

Airsonic-Advanced can be updated by simply reinstalling it:

dietpi-software reinstall 33

The web interface is accessible via port 9000:

• URL: http://<your.IP>:9000

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

Logs can be viewed with the following command:

journalctl -u logitechmediaserver

Additionally, log files can be found in:

/var/log/squeezeboxserver

Logitech Media Server can be updated to the current version with the following command:

dietpi-software reinstall 35

• Edit /etc/default/squeezelite

• Restart the service:

  systemctl restart squeezelite
  

dietpi-software reinstall 36

rm /etc/systemd/system/squeezelite.service.d/dietpi-services_edit.conf
rmdir --ignore-fail-on-non-empty /etc/systemd/system/squeezelite.service.d
systemctl daemon-reload
systemctl restart squeezelite

Logs can be viewed with the following command:

journalctl -u squeezelite

Squeezelite can be updated to the current version with the following command:

dietpi-software reinstall 36

You can configure Shairport Sync with its config file: /usr/local/etc/shairport-sync.conf
To apply changes, restart the service:

systemctl restart shairport-sync

When searching for an AirPlay device, execute shairport-sync on DietPi.

There are many AirPlay players available for Android and iOS, e.g. AirPlay For Android & TV and AirPlay on iOS.
Download and use the player of your choice.

Airfoil is an application that will let you stream audio playback directly to any Shairport Sync device. Press play on your favourite music player (e.g.: Winamp/Spotify) and click the speaker next to the DietPi device.
By using Airfoil, you can master the music in real time using the CPU. This will allow all your Shairport Sync devices to sound even better without any performance hit on the device.

If you are planning to use multiple Shairport devices on the same network, please make sure the hostname of each device is unique. The hostname will also effect the shairport-sync name, if you do not actively set the name setting in the general block of the config file.
This can be completed in dietpi-config > Security Options > Change Hostname.

Soxr interpolation will improve the output audio quality on Shairport. However, it is extremely CPU intensive.
Enable Soxr:

sed -i '/interpolation = /c\interpolation = "soxr";' /usr/local/etc/shairport-sync.conf
systemctl restart shairport-sync

Disable Soxr:

sed -i '/interpolation = /c\\/\/interpolation = "soxr";' /usr/local/etc/shairport-sync.conf
systemctl restart shairport-sync

If you have choppy playback using Soxr:
Increasing the shairplay-sync process priority (nice) may resolve the issue.

• Run dietpi-services from the terminal
• Select shairport-sync via up/down buttons then press Enter
• Select CPU Nice via up/down buttons then press Enter
• Select -20 : (Highest priority) via up button, then press Enter

DietPi will then automatically apply and set the nice level.

If the choppy playback continues, the CPU most likely is insufficient for the processing required for Soxr. Then Soxr should be disabled.

The web interface is accessible via port 8200:

• URL: http://<your.IP>:8200

Make sure you have one of DietPi’s File Servers installed.
Default media directories:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba
• Video: /mnt/dietpi_userdata/Video, /Video from NFS/Samba
• Images: /mnt/dietpi_userdata/Pictures, /Pictures from NFS/Samba

The database can be refreshed with this command:

rm -r /mnt/dietpi_userdata/.MiniDLNA_Cache/* && systemctl restart minidlna

• URL: http://<your.IP>/ampache
• Username: admin
• Password: dietpi

Make sure you have one of DietPi’s File Servers installed.
Default media directories:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba
• Video: /mnt/dietpi_userdata/Video, /Video from NFS/Samba

DietPi will automatically add various catalogue directories to Ampache during installation. You can modify these directories as needed before running your first scan.
To start the scan and import your media into Ampache:

• Select the admin button.
• Select show catalogues from the left hand side.
• Select Update all.

• Select the admin button.
• Select add a catalogue from the left hand side.
• Enter the details of your path.
• Select the add catalogue button.

chmod -R a+r /my/directory

Since Debian Bullseye (Ampache v5), the main configuration file is located at:

/mnt/dietpi_userdata/ampache/config/ampache.cfg.php

Until Debian Buster (Ampache v4), the main configuration file is located at:

/var/www/ampache/config/ampache.cfg.php

E.g. to allow .m4a playback:

• Since Debian Bullseye (Ampache v5):

  G_CONFIG_INJECT 'transcode_m4a[[:blank:]]' 'transcode_m4a = allowed' /mnt/dietpi_userdata/ampache/config/ampache.cfg.php
  

• Until Debian Buster (Ampache v4):

  G_CONFIG_INJECT 'transcode_m4a[[:blank:]]' 'transcode_m4a = allowed' /var/www/ampache/config/ampache.cfg.php
  

More info: https://github.com/ampache/ampache/wiki/Transcoding

To update Ampache to the current version, execute

dietpi-software reinstall 40

The web interface is accessible via port 8096:

URL: http://<your.IP>:8096

Once connected to the web interface, simply follow the on screen instructions.
When you reach Setup your media libraries:

/mnt/dietpi_userdata/Music
/mnt/dietpi_userdata/Video

You can also mount Samba/NFS shares by running dietpi-drive_manager and selecting Mount network drive from the menu.

Make sure you have one of DietPi’s File Servers installed.
Default media directories:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba
• Video: /mnt/dietpi_userdata/Video, /Video from NFS/Samba

To view Emby server logs, run the following command from console:

journalctl -u emby-server

To update the Emby Server version simply reinstall Emby Server to update it to newest version. It will preserve any existing data and settings:

dietpi-software reinstall 41

The web interface uses port 32400:

URL: http://<your.IP>:32400/web

Please follow the onscreen instructions to complete the setup wizard:

• Create your Plex account by signing up.
• Give your server a name (e.g.: DietPi-Plex)

• Click library to setup your media locations:

  /mnt/dietpi_userdata/Music
  /mnt/dietpi_userdata/Video
  

You can also mount Samba/NFS shares by running dietpi-drive_manager and selecting Mount network drive from the menu.

Make sure you have one of DietPi’s File Servers installed.
Default media directories:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba
• Video: /mnt/dietpi_userdata/Video, /Video from NFS/Samba

The web interface is accessible via port 8181:

• URL: http://<your.IP>:8181
• After first run setup, select “SIGN IN WITH TAUTULLI” and enter the username and password you chose before. On our own tests, authentication via plex.tv account did not work, it may however depend on the subscription.

When accessing to the web interface for the first time, go through the following steps to setup Tautulli:

1. Click “Next”
2. Enter a username and password for future web interface logins and click “Next”.
3. Click “Sign In with Plex” and log in with your plex.tv account in the new window, then click “Next”.
4. Enter the IP address or hostname of your Plex Media Server, use 127.0.0.1 if it runs on the same machine, then click “Next”.
5. Choose the activity logging ignore interval and click “Next”.
6. Click “Next” and “Finish”.
7. When logging in to the Tautulli web interface, first select “SIGN IN WITH TAUTULLI” and enter the username and password you chose before. On our own tests, authentication via plex.tv account did not work, it may however depend on the subscription.

Logs can be viewed from the web interface, using the gear button at the top right corner. Log files are stored on the server in the following directory:

/mnt/dietpi_userdata/tautulli/logs/

The server is accessible via port 64738:

• URL: http://<your.IP>:64738
• Password: No password required
• Superuser Password: dietpi

You will need to edit the Murmur config file:

nano /etc/mumble-server.ini
systemctl restart mumble-server

• Roon on another system (e.g.: Windows PC) to control the player.
• Roon license (free trial is also available).

The Roon Bridge installation can be found at:

/opt/roonbridge

Its configuration and data can be found at:

/mnt/dietpi_userdata/roonbridge

The Roon Bridge by default is started as systemd service and can hence be controlled with the following commands:

systemctl status roonbridge

systemctl stop roonbridge

systemctl start roonbridge

systemctl restart roonbridge

Service logs can be reviewed with the following command:

journalctl -u roonbridge

More detailed logs from the individual Roon Bridge components can be found at the following location:

/var/log/roonbridge

The Roon Bridge can be updated by reinstalling it, which preserves your data and configs:

dietpi-software reinstall 121

You can use the Roon Remote apps to control and configure the Roon Server: https://roonlabs.com/downloads

When configuring your Roon Server, we highly recommend using the DietPi user data directory. This will allow you to transfer music over the network easily (see Transfer music tab), and storing the music on your Roon Server system:

/mnt/dietpi_userdata/Music

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba

The Roon Server installation can be found at:

/opt/roonserver

Its configuration and data can be found at:

/mnt/dietpi_userdata/roonserver

The Roon Server by default is started as systemd service and can hence be controlled with the following commands:

systemctl status roonserver

systemctl stop roonserver

systemctl start roonserver

systemctl restart roonserver

Service logs can be reviewed with the following command:

journalctl -u roonserver

More detailed logs from the individual Roon Server components can be found at the following location:

/var/log/roonserver

The Roon Server comes with an internal updater which should be used. If the installation is broken in a way, you can repair it with the following commands:

rm -R /opt/roonserver
dietpi-software reinstall 154

Roon Extension Manager data and configs can be found at the following location:

/mnt/dietpi_userdata/roon-extension-manager

This will allow you to stream audio from your Windows PC, to the NAA Daemon on the DietPi device.

• Download and install HQPlayer Desktop for Windows:
  https://www.signalyst.eu/consumer.html
• Run the program
• To configure HQPlayer to use the NAA Daemon on the DietPi device:
  • Select File then Settings
  • Under Backend, select NetworkAudioAdapter. The DietPi device should be detected automatically.
  • Click OK to save changes

Guide: https://help.roonlabs.com/portal/en/kb/articles/hqplayer

DietPi will attempt to detect mic input during installation, and apply to DarkIce. If a microphone was not available, or you experience issues, check available microphones with:

arecord -l

• Then edit the device entry in /etc/darkice.cfg, or

• Simply copy and paste:

  sed -i "/^device[[:blank:]]/c\device = hw:$(arecord -l | mawk -F'[ :]' '/card/{print $2;exit}'),0" /etc/darkice.cfg
  

• Restart the DarkIce service:

  systemctl restart darkice
  

We create systemd services for both, IceCast and DarkIce, automatically started by DietPi. You can check their status by running the following command:

systemctl status icecast2
systemctl status darkice

The web interface is accessible via port 8000:

• URL: http://<your.IP>:8000
• Admin user: admin
• Admin password: <your global password> (default: dietpi)
• Source password: <your global password> (default: dietpi)
• Relay password: <your global password> (default: dietpi)

This is disabled by default.

• A recording of the stream can be enabled by edit of /etc/darkice.cfg, then uncomment

  localDumpFile = /mnt/dietpi_userdata/darkice_recording.ogg
  

• Restart the DarkIce service:

  systemctl restart darkice
  

• A recording will then be saved in the following location: /mnt/dietpi_userdata/darkice_recording.ogg

• IceCast: /etc/icecast2/icecast.xml
• DarkIce: /etc/darkice.cfg

Run the following commands on a console to view logs for IceCast and DarkIce:

journalctl -u icecast2
journalctl -u darkice

IceCast additionally creates access and error log files at: /var/log/icecast2/

IceCast and DarkIce are installed from the Debian APT repository and hence can be updated by running the following commands:

apt update
apt install icecast2 darkice

The web interface is accessible via port 8003:

• URL: http://<your.IP>:8003
• Email address: admin@koel.dev
• Password: KoelIsCool

We strongly recommend to change the admin users email address and password:

1. Login to the web interface
2. Select “Users” at the bottom of the left-sided navigation panel
3. However over the user tile and select “Update Profile”
4. Change name and credentials and select “Save”

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• Audio: /mnt/dietpi_userdata/Music, /Music from NFS/Samba

To view Koel service logs, run the following command from console:

journalctl -u koel

To update Koel to the recent version, simply reinstall it:

dietpi-software reinstall 143

• Edit /etc/default/gmediarender

• Restart the service:

  systemctl restart gmediarender
  

dietpi-software reinstall 163

rm /etc/systemd/system/gmediarender.service.d/dietpi-services_edit.conf
rmdir --ignore-fail-on-non-empty /etc/systemd/system/gmediarender.service.d
systemctl daemon-reload
systemctl restart gmediarender

Logs can be viewed with the following command:

journalctl -u gmediarender

The web interface uses port 2038 resp. 2039:

• Admin page: http://<your.IP>:2038/admin
• Library view page: http://<your.IP>:2039

Make sure you have one of DietPi’s File Servers installed.
Default directories:

• ebooks: /mnt/dietpi_userdata/ebooks, /ebooks from NFS/Samba
• Comics: /mnt/dietpi_userdata/comics, /comics from NFS/Samba

Use the admin page to set the above locations for ebook and comic storage, then run a scan to update the database.

The web interface is accessible via port 2037:

• URL: http://<your.IP>:2037

Make sure you have one of DietPi’s File Servers installed.
Default directories:

• ebooks: /mnt/dietpi_userdata/ebooks, /ebooks from NFS/Samba
• Comics: /mnt/dietpi_userdata/comics, /comics from NFS/Samba

Variable data and configs are stored in the following directory:

/mnt/dietpi_userdata/komga

The configuration file can be found at the following location:

/mnt/dietpi_userdata/komga/application.yml

You need to restart the service for changes to take effect:

systemctl restart komga

Logs are stored in the system journal and can be viewed by running the following command:

journalctl -u komga

If you require file logging, set a path via config file, e.g.:

logging:
  file:
    name: "/var/log/komga/komga.log"

Assure that the directory exists and the komga user or group has write permissions.

To update Komga to the latest version, simply reinstall it via DietPi-Software:

dietpi-software reinstall 179

Raspotify should work straight out of the box. However, you can change the available options in:

• /etc/default/raspotify

Then restart the service with:

systemctl restart raspotify

The service is started automatically at boot, but you can control it manually as well:

• Manually start the service:

  systemctl start raspotify
  

• Manually stop the service:

  systemctl stop raspotify
  

• Manually restart the service:

  systemctl restart raspotify
  

View the service logs via:

journalctl -u raspotify

The web interface is accessible via port 4000:

• URL: http://<your.IP>:4000

The generation of the spotify_appkey.key is required to grant the application access to Spotify API using your account.

Fill out the application form https://developer.spotify.com/documentation/general/guides/authorization/app-settings/.
Wait for it to be “accepted”.

Make sure you have one of DietPi’s File Servers installed.
Copy the spotify_appkey.key to the following directory:

• Directory: /mnt/dietpi_userdata/spotify-connect-web
• Accessed from file server: /spotify-connect-web

The service is started automatically at boot, but you can control it manually as well:

• Manually start the service:

  systemctl start spotify-connect-web
  

• Manually stop the service:

  systemctl stop spotify-connect-web
  

• Manually restart the service:

  systemctl restart spotify-connect-web
  

View the service logs via:

journalctl -u spotify-connect-web

Spotifyd should work straight out of the box. However, you can change the available options in:

• /mnt/dietpi_userdata/spotifyd/spotifyd.conf

Then restart the service with:

systemctl restart spotifyd

The service is started automatically at boot, but you can control it manually as well:

• Manually start the service:

  systemctl start spotifyd
  

• Manually stop the service:

  systemctl stop spotifyd
  

• Manually restart the service:

  systemctl restart spotifyd
  

View the service logs via:

journalctl -u spotifyd

The web interface is accessible via port 8097:

• URL: http://<your.IP>:8097

• Service:

  journalctl -u jellyfin
  

• Binary: /var/log/jellyfin/

/mnt/dietpi_userdata/jellyfin

Code: Select all

apt update
apt install jellyfin jellyfin-ffmpeg

Start by typing beet in the command line. All the options and commands will be made available.

You could start using Beets by importing music with beet import and then query the library with ‘beet list’. For example next command line shows all Tangos in the year 2010

beet ls year:2010 genre:Tango

You can change the Beets configuration, by editing next file: /mnt/dietpi_userdata/beets/config.yaml.

The Snapcast server provides a web interface on port 1780, which allows you to control volumes for all clients and optionally play audio through your browser:

• URL: http://<your.IP>:1780

DietPi-Software installs the Snapcast server nearly with default configs, as shipped with the official package. Only the JSON RPC, which listens by default on port 1705, is disabled. To enable and configure it, check the [tcp] section of the config file (see “Changing options” tab).

• /etc/snapserver.conf

Then restart services with:

systemctl restart snapserver

If you have MPD installed you can use it as an input source.

First you need to ensure that MPD outputs to a pipe you can do this in two ways:

1. Install CAVA from the DietPi software list.

2. OR: Add the following to /etc/mpd.conf and restart with systemctl restart mpd

   audio_output {
       type "fifo"
       enabled "yes"
       name "snapcast"
       path "/tmp/mpd.fifo"
       format "48000:16:2"
   }
   

Once you have done that you then need to add the following to /etc/snapserver.conf under [stream]. The name is the name as it will appear to Snapcast clients here I have called it myMPD. Check the Snapcast server docs for additional parameters you can pass in: https://github.com/badaix/snapcast/blob/master/doc/configuration.md#pipe

source = pipe:///tmp/mpd.fifo?name=myMPD&mode=read

If you have Mopidy installed you can use it as an input source.

First you need to ensure that Mopidy outputs to a pipe. Add the following to /etc/mopidy/mopidy.conf and restart with systemctl restart mopidy

[audio]
output = audioresample ! audioconvert ! audio/x-raw,rate=48000,channels=2,format=S16LE ! wavenc ! filesink location=/tmp/mopidy.fifo

Once you have done that you then need to add the following to /etc/snapserver.conf under [stream]. The name is the name as it will appear to Snapcast clients here I have called it myMopidy. Check the Snapcast server docs for additional parameters you can pass in: https://github.com/badaix/snapcast/blob/master/doc/configuration.md#pipe

source = pipe:///tmp/mopidy.fifo?name=myMopidy&mode=read

If you have Raspotify installed you can use it as an input source.

Add the following config under [stream]. The name is the name as it will appear to Snapcast clients here I have called it mySpotify. The devicename is the name that will be shown when connecting in Spotify. Check the Snapcast server docs for additional parameters you can pass in: https://github.com/badaix/snapcast/blob/master/doc/configuration.md#librespot. I have disabled the audio cache to protect the SD card.

source = librespot:///usr/bin/librespot?name=mySpotify&devicename=SnapcastSpotify&disable_audio_cache=true

First install shairport-sync.

Then (at the moment - see: MichaIng/DietPi#4470) we need to replace the Shairport Sync binary with one that supports stdout. To do this we need to compile a new binary - you will find details here:
https://github.com/mikebrady/shairport-sync/blob/master/INSTALL.md#build-and-install

You need to use this line when configuring instead of the line from the docs:

./configure --sysconfdir=/etc --with-alsa --with-soxr --with-avahi --with-ssl=openssl --with-systemd --with-metadata --with-stdout

Don’t forget to run make and make install.

Then add the following config under [stream]. The name is the name as it will appear to Snapcast clients here I have called it myAirport. The devicename is the name that will be shown when searching for Airport devices. Check the Snapcast server docs for additional parameters you can pass in: https://github.com/badaix/snapcast/blob/master/doc/configuration.md#airplay

source = airplay:///usr/local/bin/shairport-sync?name=myAirport&devicename=SnapcastAirport&params=--configfile=/usr/local/etc/shairport-sync.conf

You will then either need to mask the original Shairport Sync service

systemctl mask shairport-sync

or you can try to run one of them on a different port - Snapcast docs shows how to do this here: https://github.com/badaix/snapcast/blob/master/doc/configuration.md#airplay

It should just work but, you can change the available options in:

• /etc/default/snapclient

Then restart services with:

systemctl restart snapclient

The web interface uses port 4533:

• URL: http://<your.IP>:4533

Navidrome doesn’t support multiple music folders out of the box. The feature is still being developed.

Related GitHub issue: navidrome/navidrome#192

The install, config and data directory is located at:

/mnt/dietpi_userdata/navidrome

Since Navidrome runs as systemd service, it can be controlled with the following commands:

systemctl status navidrome

systemctl start navidrome

systemctl stop navidrome

systemctl restart navidrome

Since Navidrome runs as systemd service, its logs can be viewed via:

journalctl -u navidrome

Navidrome can be updated by simply reinstalling it:

dietpi-software reinstall 204

Make sure you have one of DietPi’s File Servers installed.
Default music directory:

• /mnt/dietpi_userdata/Music, /Music from NFS/Samba

Navidrome has a Subsonic-compatible server built in, so there should be plenty of clients for different platforms available. See:

• https://www.navidrome.org/docs/overview/#apps
• http://www.subsonic.org/pages/apps.jsp