euphony installation involves several steps:

  1. Download compressed euphony system image: DOWNLOAD euphony IMAGE
  2. Unzip it to get the uncompressed file (It will be in the form: euphony2016xxxx.img)
  3. Write above image file to an empty USB drive (min 4GB)
    • On Windows you can use free program: Win32 Disk Imager (DOWNLOAD)
    • On MAC you can use free program ApplePi Baker (DOWNLOAD)
    • On Linux you can use Clonezilla (DOWNLOAD)
  4. Insert that USB into your target miniPC device and power it on (Make sure that USB is first bootable device. Use F2 to enter BIOS and check that if euphony is not accessible after boot)
  5. After approximately 30sec euphony system is available at address: euphony.local
  6. Attach your DAC via USB and you are ready to play. (DAC can also be attached before boot)



Main control/playback interface to euphony is the euphony Web Application. It is available at:

http://euphony ( for MAC: http://euphony.local )

If euphony is not accessible on these links you can try:

For playback control, beside our web application, you can use your favorite MPD client: i.e. MPDroid for Android, MPoD/MPaD for iOS or Cantata as desktop solution.

We offer customized MPDroid version named euphony remote adapted to work closely with euphony system: (DIRECT DOWNLOAD or PLAYSTORE LINK).

To manage your songs and files on disk use euphony File Manager. Access it on web address:

http://euphony:8080 ( or http://euphony.local:8080 on MAC ). Link to this address is also available in euphony Web App (menu: Tools) and in euphony remote main menu.

Music library

euphony system includes couple of songs for quick testing. To add more songs to music library you can:

  • Attach external USB storage
  • Add network shares (NFS or SMB) via euphony Web Application

Attached USBs and network shares will by default appear under root directory – use File Manager to move desired songs/directories to /Euphony Drive directory where Music Service will scan them and add to Music library.

euphony Web App

euphony Web Application allows you to control playback and adjust some settings to match your current setup. It is mobile friendly and can be easily used on tablet or smartphone.

It has several typical screens:


Displays the song that is currently playing (or paused). It also offers album information with cover photo and some details about playback.



Displays songs in queue. You can add or remove songs, create or load playlists and control playback.



Here you can  search songs by various criteria and add them to queue. (Note that songs without embedded meta information can be searched only by filename.)



Here you can browse Music library by tags (Album, Artist, Genre, Playlist) or by Filename (browsing file structure inside Music directory). From here you can add to queue entire collection of songs at once (whole album or all songs of particular artist or genre).



Place to change system settings with subsections related to various system aspects:

  • Playback
  • Music Library
  • euphony system
  • Install
  • Update
  • Change Audio system


All settings will be explained in detail in separate article.


A little icon on Menu bar is there to provide visual indication of server status. If green, everything is online and working. If red, something is offline: either Music Service or Web Server.  euphony-indicator


Power submenu is labeled with simple power icon  and gives you options to reboot euphony system or power it off.  euphony-power-icon


Unregistered version has limited functionality: playback service is stopped after 15 minutes, and some settings are not available.


Playback options


You must choose appropriate option depending on the way your DAC supports native DSD play.

You can choose between:

  • Native
  • DOP (DSD Over PCM
  • Convert to PCM


For Native and DOP DSD playback this will be forced to: ‘None’ but if you choose DSD option: ‘Convert to PCM’ then you can choose between:

  • Hardware
  • Software
  • None

Every DAC has it’s own quirks so choose what works best for yours.

Start Playback Service in paused mode

If not checked then Playback will resume after startup or after Playback Service is restarted (Playback Service needs to be restarted when you change any options in this section)

Gapless mp3 playback

Only needs to be unchecked if you encounter problems while playing mp3 music files.

Auto update MPD database

If checked, system will actively monitor Music folder and all new songs will be immediately added to Music Library. If unchecked you can always manually request database update via command: ‘Update music library’  in Tools menu.

Buffer before play = 100%

We recommend checking this option for best performance and audio quality. Disable only if you encounter problems with playback.

Music Library

In this section there are 3 subsections:

  • Linked Network Shares
  • Block devices and partitions

(If you are ever in doubt what certain button does, just hover your mouse over it to view explanation in tooltip.)

Linked Network Shares

Here you can add network shares to the music library and you can see listing of shares you added before. Existing shares can be added directly to Music library (attached to /data/Music folder) removed back from it (attached to /data folder) or deleted altogether (Naturally, only link is deleted, content on network share remains untouched.)
(Note that songs from network shares will be removed from Playing Queue if network share is not available at Music Service startup.)

Block devices and partitions

Here are listed your block devices (disks, usb/ssd drives and their partitions). You can see whether they are attached to /data/Music (in Music library) or /data (not in Music library). Of course, you can attach them at either location or detach (eject) them.

(Only partitions can be attached, disks are listed for informational purpose.)

euphony system

If you prefer so, you can change the name of euphony system as it appears on network.

You need to do that if you have multiple euphony installations running at the same network.  If you change it to ie.: ‘euphony-bedroom’ then you must access euphony Web App via: http://euphony-bedroom.

After changing this option, euphony system will be restarted. Access it at the appropriate web address after approximately 30 seconds.


Install option is not available for unregistered installations.

If your first euphony installation came to you as USB image and you have a dedicated miniPC for use as euphony system then you will probably want to have it boot from your miniPC’s hard disk.

You may also want to show euphony to a friend and put it on his usb.  You can perform that installation here. (Note that installation from euphony Web Application is faster and simpler than writing original euphony image file)

Install section will not be shown if there are no possible target devices attached (you cannot install it on disk from which you booted the system up).

Important: after starting installation don’t leave the Install screen until installation is finished.

WARNING: Install procedure erases all data on selected disk (all partitions). This means that if you do this on a disk that already has euphony installation, all your data there will be lost (including Music Library).

To update your existing euphony installation it is better to use Update option.


Update option is not available for unregistered installations.

Use this to update your existing euphony installation. This option appears only if there is a new version available for download. To be able to see this your device has to be connected to internet before boot.

Update procedure:

  1. Backs up important configuration and state files
  2. Overwrite your system disk partition with new euphony image
  3. Restore backed up files

Update procedure does not touch euphony drive and your Music Library on it.

Change audio system

Here is the place to say more about internals of euphony system.

Previously mentioned ‘Music Service’ or ‘Music Player’ is by default a ‘Music Player Daemon’ or MPD – renowned server side application for playing music: read more about it on original site: LINK.

euphony system actually support three music players:

  • MPD
  • Squeezelite
  • Networkaudio


MPD or Music Player Daemon is both a Player and a Library, both controlled by euphony Web Application. Music Player options and Music Library options of this article are applicable only when MPD is selected.

Other two audio systems have Music Library and Playback control on another system leaving euphony to perform only a role of audio streamer..


Squeezelite is one of several software clients available for Logitech Media Server. Squeezelite does not have any user interface of its own and must be controlled via Logitech Media Server’s web interface or another Logitech Media Server client.

One of notable clients is Roon which is tested to work with euphony system.


Network Audio Adapter or NAA is a way to expose remote audio devices to HQPlayer over asynchronous network link. It is just an audio “renderer” with support for number of different audio endpoint devices. Playback by NAA is completely clocked by the audio endpoint device and NAA performs only buffering, no decoding or processing at all.

installation and use