The Rough Guide to the Hifidelio

Organizing Import Tagging Maintenance


This section is a short one as I don't know much about Linux.

The HF runs under Linux.
You can access it and modify the system to your harts content.
In the process you may also ruin it.
So this is the Very rough guide.


Samba: Samba is an Open Source/Free Software suite that provides seamless file and print services to SMB/CIFS clients." Samba is freely available, unlike other SMB/CIFS implementations, and allows for interoperability between Linux/Unix servers and Windows-based clients.

Linux WPA/WPA2/IEEE 802.1X Supplicant: wpa_supplicant is a WPA Supplicant for Linux, BSD, and Windows with support for WPA and WPA2 (IEEE 802.11i / RSN). It is suitable for both desktop/laptop computers and embedded systems. Supplicant is the IEEE 802.1X/WPA component that is used in the client stations. It implements key negotiation with a WPA Authenticator and it controls the roaming and IEEE 802.11 authentication/association of the wlan driver.

FLAC: FLAC stands for Free Lossless Audio Codec. Audio is compressed without any loss in quality. This is similar to how Zip works, except with FLAC you will get much better compression because it is designed specifically for audio.
Metaflac is the command-line .flac file metadata editor. You can use it to list the contents of metadata blocks, edit, delete or insert blocks, and manage padding.

FreeDB : a free CD and music data base service to look up textual metadata about music, audio or data CDs.

TwonkyVision: TwonkyMedia - our DLNA Certified™ MediaServer - enables you to share all your Music, Pictures and Videos with standard UPnP-enabled client devices throughout your home.

CDParanoia retrieves audio tracks from CDDA capable CDROM drives.   The data  can  be  saved  to  a file or directed to standard output in WAV,AIFF, AIFF-C or raw format.  Most ATAPI, SCSI and  several  proprietary CDROM drive makes are supported; cdparanoia can determine if the target drive is CDDA capable.
In addition to simple reading, cdparanoia adds extra-robust data  verification,  synchronization,  error  handling and scratch reconstruction capability.

A nice collection of open source software.

Login – Telnet

To gain access to the HF you need to login using a telnet session.
Before you do, enable Telnet on the HF

Start telnet and connect to the HF using:

Open ip-adres
User: root
Password: root

Logout to end the session.


Information about processes

PS       All processes
TOP    Dynamic list showing the most active processes with all kind of counters like CPU use
JOBS  List your jobs including the jobnumber

CTRL/Z stops the job, typing %jobnumber resumes it.
kill %jobnumber does exactly what it says


Information about networking

There are commands to get information about  the networking on the HF.
Useful in case of debugging network problems.

Ifconfig         network interface
IWconfig       network interface of the Wlan
Netstat          active network connections



CD - Change directory       
CD / (go to the root directory)
CD .. move to the parent of current dir (note the space between CD and ..)
LS – List files and directories
CP – Copy files

more thisfile  – displays the content of a thisfile 1 page at the time. Use spacebar for next page

Cover art

When playing a song, the cover of the album can be displayed in the Leonore and the Veronica interface.
The big trick is as Amazon offers a lot of music for sale, looking up the album there most of the time succeeds. So download the picture and your cover art is there.

See the wiki for more details.

Download the software from
Store it in the import directory of the HF
Start a telnet session and type the following commands:


# If you have artwork already, stop it stop

#  extract the source code
tar -xzf /audio/import/coverart.tgz -C /audio

# Set the environment
source /audio/opt/coverart/bin/

# Install the artwork service install

# Start the atwork service start

# Restart the webserver (Apache)
/etc/init.d/httpd restart


In case of pop music this works fine. In case of classical music it often fails.
But the interface allows for manually editing the search phrases. My experience is that the combination of performer and composer in general work fine.

You need the Leonore interface to add cover art manually
Play a song, if no image pops up after a couple of seconds, double click on the image (the soundtrack of your life)

It will start to look for images at amazon
This fails often in case of classical music.
Change it to performer and composer only often does the job.
Now you can browse the pictures and take your pick.
4 start the search
5 cancel

If this fails or if you want to use a picture of your own, choose 6
Now you can choose any picture on your hard disk (Bladeren=open a directory)

Choose 8 to set the options.


10 images will be resized to 200x200 px
11 when on this will be done while playing a song
12 if the album title is missing, the application uses  to guess the album title using the artist and the name of the song.
13 the images are stored in a database but if on, they are stored in the audio file to (MP3 only)
14 the websites used to look for cover art
15  the websites NOT used. Use drag and drop to transfer them form one to another

16 this are regular expressions to remove words from the search criteria. This allows you to tailor the search phrases.
17 save your settings

The post in the forum.
Documentation in the Wiki

Thanks to shadowman

Making a log file

This is useful for trouble shooting.
Login to the HF by Telnet

Linux command


cd /

Goto the home directory

touch /DEBUG

Make a directory, this instructs the HF to make a log file (Don't forget to use uppercase)

fidelio restart

Reboot the system



tail -f /tmp/Fidelio.log

Display the log file on screen

cp /tmp/Fidelio.log /data/import

Copy it to the import folder so you can access it over the network

rm /tmp/Fidelio.log

Delete the log file (it can become quite big)


After a restart, logging will stop


Thanks to Musikuss

No conversion to FLAC (task list)

Converting to FLAC is a big task for a slow computer like the HF.
It might happen that the system hangs during conversion and after a reboot refuses to convert to FLAC
This can be solved by removing the task list.
The task list is stored in: /data/db/job.db


Conversion to FLAC should be working again.
You can now safely remove job.backup: rm /data/db/job.backup

Network access to the music folder

If you update your Hifidelio to 2.3.28 and activate the Sonos option,the musicfolder is accessable.


Older versions

The music folder is hidden by default.
You need access to it if you want to make a backup over the network.
The full procedure is described here
This is about configuring Samba so in principle you can make any folder visible, writable, etc.

Login on the HF
Go to the directory with the samba configuration file:
CD /opt/samba/lib/
Make a local of the original smb.conf so you have a fall back in case you ruin it:
CP smb.conf smb.old

If you are familiar with Linux you now can edit smb.conf in place.
If you are not, copy it to the import directory and access it over the network:
CP /opt/samba/lib/smb.conf   /audio/import/
At the bottom there is the section [Record]
Copy and paste this section so you have it two times
Chance all occurrences of Record into Music (beware of the upper/lower case)


      comment = Music
      path = /audio/music
      public = yes
      only guest = yes
      writable = no
      printable = no
      create mask = 0666
      force create mode = 0666
      directory mask = 0777
      force directory mode = 0777
      force group = fidelio
      force user = fidelio


Copy it back:
CP /audio/import/smb.conf   /opt/samba/lib/
And in a short while the music folder should become visible in your network environment.

Meaningful names in the music folder

Differences in file name conventions between Linux and Windows sometimes yield completely nonsensical names in the windows environment (see Windows Explorer). This is called “mangled names” in the Samba world.

Go to the directory with the samba configuration file:
CD /opt/samba/lib/
Make a local of the original smb.conf so you have a fall back in case you ruin it:
CP smb.conf smb.old
Add the following line to the global section in smb.conf

mangled names = no

You probably need a reboot to get

You might be unable to open some of these directories. Known problems are:

Thanks to Shadowman

Output Volume

Some users are having troubles when controlling the HF and an amplifier by remote control (see Remote Control).
It is possible to set output level of the HF with the following command:

/opt/alsa-utils/bin/amixer sset Master 30 > /dev/null

Include this line in the “watchdog” script : /opt/Fidelio/bin/watchdog

And every time this script executes, output level is set to the max.
See: for more details

Playing from a USB device

This is a translation of a post in the forum made by  Bergi

Until today I haven't copied a compilation CD to the HF, to avoid hundreds of artists with only one or two tracks to lengthen the artist-list to something unbearably long.

Well, since HF 2.2 it's become possible (idea of gigi/fred) to make a new dir on the HF and 'mount' it as a USB device.

If this dir is made available on the network, you can dump your compilations there from any Mac/PC and they'll appear in the HF-selection lists as compilation.

Short manual:

- put the smb.add, rc.add and skripts from into the Import folder.

Then by Telnet:
chmod 755 /audio/import/ /audio/import/

This generates the folder 'Sampler', gives write permissions, makes backup copies of smb.conf and rc.local, adds the necessary lines to both and reboots the HF.

Now from your Mac or PC you can generate a new folder 'Sampler' and fill it with material that will become playable from within the HF immediately (without import; there'll be a new menu entry 'Sampler' above 'Interpreten').

Thanks to Bergi

Symbolic linking

If you want to make a backup of the libraries of the HF using the windows environment, you need to copy them to a location which ia accessible over the network.
A more elegant solution is to make a symbolic link.
- open aTelnet session
- make the link: ln -s /data/db /data/import/.db
- all the libraries should be visible now in windows explorer.

TwonkyVision configuration

If UPnP is enabled on the HF you see

Hifidelio Pro UPnP is the configuration page of TwonkyVision Media Server, the one who does the UPnP on the HF.
You can get access to the configuration page:

  1. Switch of the UPnP service on the HF
  2. Starts a Telnet session
  3. Goto  /opt/upnp
  4. Make a copy of twonkyvision-mediaserver.ini just to make sure
  5. Using a editor, change the line enableweb=0 into enableweb=2
  6. Restart the UPnP service

I don't think this affect the way the HF Works but it affects the way clients read information from the HF.

If you want a more recent version of Twonky on the HF: see the Wiki.
This again won't affect the HF but might be useful when using today’s clients.


You have done you’re nifty Linux things and now the system is not functioning proper any more.
Reinstall the system might help but Hifidelio will probably tell you that the latest version is already installed.

In the root of the HF there is a file VERSION

Now you can use the regular upgrade procedure to undo the things you have done.