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.
Folders used:

• local = /mnt/dietpi_userdata/Music
• accessed from file server = /Music

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.
Folders used:

• local = /mnt/dietpi_userdata/Music
• accessed from file server = /Music

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.
Folders used by O!MPD:

• Local = /mnt/dietpi_userdata/Music
• Accessed from file server = /Music

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.
Folders used by Mopidy:

• Local = /mnt/dietpi_userdata/Music
• Accessed from file server = /Music

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

mopidyctl local scan

Mopidy is highly customizable and supports various extensions from Web extensions to Backend extensions. See Extensions for a list.

See Installing extensions for installation details.

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, we need to configure the Music directory:

• Click the Settings button
• Under Media Folders, replace the current music folder entry with /mnt/dietpi_userdata/Music, then select Save
• Select Scan media folders now to update the library

Make sure you have one of DietPi’s File Servers installed.
Folders used by Mopidy:

• Folder = /mnt/dietpi_userdata/Music

The web interface is accessible via port 4040:

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

Make sure you have one of DietPi’s File Servers installed.
Folders used by Mopidy:

• Folder = /mnt/dietpi_userdata/Music

This is a known issue with Subsonic and is out of my control.
If you experience this error while accessing the Subsonic web page, you can resolve the issue by running the following:

systemctl stop subsonic
rm -R /var/subsonic/jetty
systemctl restart subsonic

Many thanks to thechildofroth for his testing and fixes with the Subsonic installation.

The web interface is accessible via port 9000:

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

Make sure you have one of DietPi’s File Servers installed.
Folders used by Mopidy:

• Folder = /mnt/dietpi_userdata/Music

• Run dietpi-services
• Select squeezelite
• Select Edit
• Unset and re-set the ExecStart entry:

ExecStart=
ExecStart=/usr/bin/squeezelite [<your custom arguments>]

The first ExecStart= is required to replace the existing ExecStart entry instead of adding a second one.

• Save changes with Ctrl+O and exit dietpi-services
• Restart the service: systemctl restart squeezelite

To update Logitech Media Server to the current version, execute

dietpi-software reinstall 35

The web interface is accessible via port 9000:

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

Make sure you have one of DietPi’s File Servers installed.
Folders used by Mopidy:

• Folder = /mnt/dietpi_userdata/Music

• Run dietpi-services
• Select squeezelite
• Select Edit
• Unset and re-set the ExecStart entry:

ExecStart=
ExecStart=/usr/bin/squeezelite [<your custom arguments>]

The first ExecStart= is required to replace the existing ExecStart entry instead of adding a second one.

• Save changes with Ctrl+O and exit dietpi-services
• Restart the service: systemctl restart squeezelite

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

There are many AirPlay players available for Android (e.g. AirPlay For Android) and iPad/iPhone (e.g. AirPlay).
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 a PC + Airfoil, you can master the music in real time using the PCs 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.
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.
Folders used by ReadyMedia:

• /Music
• /Pictures
• /Video

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.
Folders used by Ampache:

• audio = /mnt/dietpi_userdata/Music
• videos = /mnt/dietpi_userdata/Video

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 (See the image example below to add your USB drive music folder to Ampache).
• Select the add catalogue button.

Remark: For Ampache to access custom directories, you must ensure read access to the folder, e.g. by:

chmod -R 775 /my/directory

• https://github.com/ampache/ampache/wiki/Transcoding
• E.g. to allow .m4a playback:

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

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.
Folders used by Emby:

• Audio: /mnt/dietpi_userdata/Music
• Videos: /mnt/dietpi_userdata/Video

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.
Folders used by Plex Media Server:

• Audio = /mnt/dietpi_userdata/Music
• Video = /mnt/dietpi_userdata/Video

The web interface is accessible via port 8181:

• URL = http://<your.IP>:8181

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

Can be found there: https://roonlabs.com/
See also YouTube videos from David Snyder

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

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 below), and storing the music on your Roon Server system:
/mnt/dietpi_userdata/Music

Make sure you have one of DietPi’s File Servers installed.
Folders used by Roon Server:

• Music directory = /mnt/dietpi_userdata/Music
• Accessed from file server = /Music

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/faq-how-do-i-use-roon-and-hqplayer-together

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.
Directories used by Koel:

• Local = /mnt/dietpi_userdata/Music
• Accessed from file server = /Music

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

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.

• Use the following folders = /mnt/dietpi_userdata/ebooks and /mnt/dietpi_userdata/comics
• Then use the admin page, to set the above locations for ebook and comic storage
• Run a scan in the admin page to update the database

The web interface is accessible via port 2037:

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

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

File hashing is by default disabled on installs via DietPi, to reduce CPU load for small hardware. The downside is that when moving or renaming media files, Komga won’t be able to keep metadata and read state attached, as the database entry is associated to the file path. The original media entry will remain shown as “unavailable” in the library, so that you can manually copy metadata over to the new entry. To remove the old entry, clear the trash of the library.

With file hashing enabled, database entries and hence metadata and read state are associated to the file hash, so that it stays intact when files are moved or renamed only, with the downside of additional CPU load and resource usage, especially on smaller hardware. To enable file hashing, set the following entry in the configuration file:

file-hashing: true

Read more: https://komga.org/guides/trash.html#file-hashes

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/app-settings/#register-your-app.
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 8096:

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

• 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 1740, which allows you to control volumes for all clients and optionally play audio through your browser:

• URL = http://<your.IP>:1740

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.
OR
2) 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