PART2: Cloning AMD64 UEFI Image Disk From Windows

April 26, 2023April 26, 2023 Linux Audio Team

# we assume you have a PC with Windows system and 7zip (or Winrar) installed
# and GParted Live USB stick bootable

# more info on GParted website to create your a bootable Live system)
# and another USB drive for the image disk

WINDOWS PC

# download the distribution from our website/github and extract it with 7zip (or Winrar)
# insert your USB drive and format it using NTFS with for example ‘imgdisk’ name
# then copy the extracted image disk (.img) from Windows to your USB drive
# optional: rename image disk to musiclounge.img or medialounge.img

BAREBONE PC (HTPC)

# insert the the GParted Live USB, the imgdisk usb stick, plug a keyboard (and optionally a mouse)
# and turn the HTPC ON
# quickly hit F10 (NUC) or F12 to show up the boot menu
# boot UEFI:disk corresponding to GParted live USB
# GParted app should be opened so you can identify easily
# your internal hard drive (/dev/sda) and your USB stick ‘imgdisk’ (/dev/sdX)
# in our example:

internal hard drive (ssd): /dev/sda

imgdisk partition 1: /dev/sdb1

# QUIT GParted app

# open terminal with root permissions
# mount your usb imgdisk

```
$ mount /dev/sdX /media
```
```
$ cd /media
```
```
$ ls
```

# IMPORTANT: check the integrity of the image disk

```
$ sha1sum medialounge....img
```

# compare the result with the SHA1 line on website
# if this doesn’t match then your image disk is corrupted, you can’t go further until your img disk is clean
# clone from image disk to your internal disk (/dev/sda)
# ALL DATA IN INTERNAL HARD DRIVE/SSD WILL BE ERASED

$ sudo dd if=musiclounge.img of=/dev/sda bs=2048 status=progress

# then fix gpt backup header/table on the target disk

```
$ sudo sgdisk -e /dev/sda
```

# unmount /media

```
$ cd /
```
```
$ umount /media
```

# now launch GParted app to resize the root partition (3) of your internal disk (/dev/sda3)

# double-check and APPLY all changes

# expand partition 3 (minimum 16GB)

# shutdown your HTPC
# remove both GParted live usb and imgdisk usb drive

# congrats! You are now ready to enjoy your distribution

PART1: Cloning AMD64 UEFI Image Disk From Windows (Rufus)

April 26, 2023April 26, 2023 Linux Audio Team

# we assume you have a PC with Windows system with 7zip (or Winrar) and Rufus installed
# an USB Drive with GParted Live USB bootable

# more info on GParted website to create your a bootable Live system)

# and an USB3 To SATA adapter cable

# if you do not have the cable, follow the instructions of SOLUTION 2

WINDOWS PC

# download the distribution from our website/github and extract it with 7zip or Winrar

# IMPORTANT: check the integrity of the image disk
# and compare the result with the corresponding SHA256 line on website

# run powershell (i.e. Windows Terminal) and type:

Get-FileHash C:\path\to\imagedisk.img

# if this doesn’t match then your image disk is corrupted, you can’t go further until your img disk is clean
# connect your SSD (or 2.5″ Hard drive) to your PC with the Startech USB3 To SATA adapter

# then run Rufus and select the image disk, tick the “List USB Hard Drives” and select your SSD
# clone from image disk to your internal disk
#ALL DATA IN INTERNAL HARD DRIVE/SSD WILL BE ERASED

# After the cloning, close Rufus, disconnect the adapter cable from the PC and mount the SSD inside your Barebone PC/NUC

BAREBONE PC (HTPC)

# insert the the GParted Live USB, plug a keyboard (and optionally a mouse)
# and turn the HTPC ON
# quickly hit F10 (NUC) or F12 to show up the boot menu
# boot UEFI:disk corresponding to GParted live USB
# GParted app should be opened so you can identify easily
# your internal hard drive (/dev/sda)
# Fix the GPT backup header/table if GParted prompts to do so

# resize the root partition of your internal disk (/dev/sda3)

# double-check and APPLY all changes

# expand partition 3 (minimum 16GB)

# shutdown your HTPC
# remove both GParted live usb

# congrats! You are now ready to enjoy your distribution

expand partition with gparted

February 23, 2023April 23, 2023 Linux Audio Team

Expand Your Main Partition With GParted

# Armbian and Raspi OS come with a nice utility to expand your partition (read the Musiclounge installation for more info) but what about Debian/Ubuntu?
# for this distro you need to do it manually but don’t worry

# with the great GParted it’s very easy

# grab the gparted live iso, make a bootable sd card or usb stick to expand your hard drive
https://gparted.org/livecd.php

# so you already created your image disk of MusicLounge audiophile server for amd64 on hard drive, usb stick or SD card

# boot with GParted Live USB key and run GParted (the software should startup automatically)

# select on top-right menu your musiclounge device disk (here it’s /dev/sdc)

# in edition 2023 the root partition is the last.
# so it is very easy, unmount root partition and expand it

# may need to fix the GPT table backup due to the different size of the hard drive.

# if GPT partions table is corrupted, open terminal and fix gpt with

# assuming it is on /dev/sda disk

```
$ sudo sgdisk -e /dev/sda
```

# that’s it!
# your MusicLounge Audiophile Server distro is now ready

# however if your root partition is before the swap do the following

# right-click the main partition to unmount musiclounge device

# click the swap partition and right-click to select Resize/Move

# select Align To Cylinder and
# move the partition to the end (or put zero in free space following)
# then click Resize/Move button

# click the main partition and right-click to select Resize/Move

# resize the partition to the end
# then click Resize/Move button

# apply changes

# that’s it!
# your MusicLounge Audiophile Server distro is now ready

Continue Reading The Musiclounge Installation

Cloning AMD64 UEFI Image Disk From Windows

February 23, 2023April 30, 2023 Linux Audio Team

# cloning large UEFI image disk (5GB+) from Windows to internal hard drive (or SSD) may cause of corrupt installation
# also due to GPT structure, cloning to another disk is not enough, you need to rewrite the GPT backup header/table on the last 33 sectors of your target disk
# finally you really need to resize the root partition to get enough space for using the distribution

# here are the instructions to make this from Windows and with GParted Live on Linux side.

SOLUTION 1 Requirements

This way is very easy but requires to remove the hard drive/SSD from the Barebone PC/NUC and a special USB3.0 to SATA adapter cable (ref. USB3S2SAT3CB from StartTech).

Windows PC with Rufus and 7-Zip (or Winrar) Installed
1 USB Drive with Bootable GParted Live

1 USB3 To SATA adapter cable

SOLUTION 1

SOLUTION 2 Requirements

Windows PC with Rufus and 7-Zip (or Winrar) Installed
1 USB drive for the image disk
1 USB Drive with Bootable GParted Live

SOLUTION 2

MusicLounge: Upgrade Server To Editon 2023

February 2, 2023February 18, 2023 Linux Audio Team

Upgrade MusicLounge Server Editon 2021 To Editon 2023

# Important Notice: The image disk of the 2023 edition for Raspberry PI 4, Odroid C4 and amd64 platform are available for download HERE.
#
# follow the instructions below to upgrade your edition 2021 of MusicLounge. The audiophile server must be already installed and operational.
#
# be sure your data partition is resized
# Odroid C4 with Armbian

$ sudo systemctl enable armbian-resize-filesystem

```
$ sudo reboot
```

# Raspberry PI 4 with RaspPI OS, simply run raspi-config and select Advanced Options > Expand Filesystem and reboot

```
$ sudo raspi-config
```

# expanding your partition during the boot can take a while (depending the size of your SD Card) so be patient,

# at first boot you should see

Usage of /: 71% of 3.7G

# after expansion on 16GB SD Card

Usage of /: 19% of 14G

# for debian amd64 expand your hard drive if needed using gparted on live distro or from desktop PC is easy
# first move the swap sda2 to end and then resize sda1
# click this link to read the tutorial to expand your disk with GParted

# First, ensure your system is up-to-date in it’s current release.
# update unpncli signature
# go to https://www.lesbonscomptes.com/pages/signatures.html
# download lesbonscomptes.gpg and copy to /usr/share/keyrings/

```
$ cd ~/Downloads/
```

$ sudo cp lesbonscomptes.gpg /usr/share/keyrings/

# update buster (ed. 2021) pkgs, the distro must be up to date

```
$ sudo apt update
```

# now upgrade pkgs, during installation
# keep local smb.conf
# choose the internal hard drive /dev/sda to install grub if needed (and NOT /dev/sda1)
# otherwise select [default=N] reply

```
$ sudo apt upgrade
```

# make a full upgrade to be sure

```
$ sudo apt full-upgrade
```

# run update again and you should read
# All packages are up to date.

```
$ sudo apt update
```

# now update sources list

$ sudo sed -i 's/buster/bullseye/g' /etc/apt/sources.list

$ sudo sed -i 's/buster/bullseye/g' /etc/apt/sources.list.d/*.list

# update to bullseye sources.list with the entries below

```
$ sudo nano /etc/apt/sources.list
```

deb http://deb.debian.org/debian bullseye main contrib non-free
deb-src http://deb.debian.org/debian bullseye main contrib non-free
deb http://deb.debian.org/debian bullseye-updates main contrib non-free
deb-src http://deb.debian.org/debian bullseye-updates main contrib non-free
deb http://deb.debian.org/debian bullseye-backports main contrib non-free
deb-src http://deb.debian.org/debian bullseye-backports main contrib non-free
deb http://security.debian.org/debian-security/ bullseye-security main contrib non-free
deb-src http://security.debian.org/debian-security/ bullseye-security main contrib non-free

# check and update upnpcli source list

```
$ sudo nano /etc/apt/sources.list.d/*
```

deb [signed-by=/usr/share/keyrings/lesbonscomptes.gpg] http://www.lesbonscomptes.com/upmpdcli/downloads/debian/ bullseye main
deb-src [signed-by=/usr/share/keyrings/lesbonscomptes.gpg] http://www.lesbonscomptes.com/upmpdcli/downloads/debian/ bullseye main

```
$ sudo apt clean
```
```
$ sudo apt update
```

# IMPORTANT: on any error fix your sources list before going further

# say YES for restarting services automatically
# for all request (i.e. update conf files) during the upgrade say no
[default=N]

```
$ sudo apt upgrade
```

# may require to remove gcc 8 base if the command failed during upgrade because of libc6-dev

```
$ sudo apt-get remove libgcc-8-dev
```

# for all request during the upgrade say ‘n’
[default=N]
# and obviously keep smb.conf
# make a full upgrade

```
$ sudo apt full-upgrade
```

# run update again and you should read
# All packages are up to date.
# otherwise run $ sudo apt full-upgrade AGAIN

```
$ sudo apt update
```

# cleanup pkgs

```
$ sudo apt autoremove -y
```

# reboot

```
$ sudo shutdown -r now
```

# MPD Upgrade
# check the latest release version available on offical website musicpd.org
# for example to download and extract release 0.23.12 in mpd-0.23.12/

```
$ cd ~/Downloads/
```

$ sudo wget https://www.musicpd.org/download/mpd/0.23/mpd-0.23.12.tar.xz

```
$ sudo tar xf mpd-0.23.12.tar.xz
```

# or get the very latest (unstable dev release) by cloning the MPD git to MPD/

$ sudo git clone https://github.com/MusicPlayerDaemon/MPD.git

# notice: libboost-dev dependency is no longer needed
# read the mpd tutorial to compile and install the latest version of MPD (version 0.23.12 or greater)

# after compilation and installation enable and start the service

```
$ sudo systemctl enable mpd
```
```
$ sudo systemctl start mpd
```
```
$ sudo reboot
```

# check mpd

```
$ sudo systemctl status mpd
```

#
# TROUBLESHOUTING
# in case of error (generally occurs within 5s just after playing) :

alsa_output: Decoder is too slow; playing silence to avoid xrun

# adding the following lines to all your audio output in mpd configuration (/etc/mpd.conf) may help
#

buffer_time "200000"
period_time "5084"

#
# edit mpd.conf and scroll to audio output area to add the 2 lines

```
$ sudo nano /etc/mpd.conf
```

.
.
.
audio_output {
type "alsa"
name "Default"
device "hw:1,0"
mixer_type "none"
dop "no"
buffer_time "200000"
period_time "5084"
}

audio_output {
type "alsa"
name "ALSA DAC DOP"
device "hw:1,0"
mixer_type "none"
dop "yes"
buffer_time "200000"
period_time "5084"
}
.
.
.

#
# in case of non fatal binding error

server_socket: bind to '0.0.0.0:8000' failed (continuing anyway, because binding to '[::]:8000' succeeded): Failed to bind socket: Address already in use

# a binding already exists due to ipv6, however mpd is running correctly. if you do not need ipv6 support follow these instructions to disable it by using sysctl command and by adding the kernel option ipv6.disable=1 https://www.wikihow.com/Disable-Ipv6-on-Linux
# edit your nginx.conf to remove ipv6 listening by
# commenting listen [::]:80 default_server; on server block

$ sudo nano /etc/nginx/sites-available/default

server {
        listen 80 default_server;
#       listen [::]:80 default_server;

# myMPD Upgrade

```
$ cd Downloads/
```

# rename current directory if exists

```
$ mv myMPD/ myMPD-10.1.7/
```

# read the myMPD tutorial on website
# to compile and install the latest version of myMPD (version 10.2.0 or greater)
# after compilation and installation generate the config files

$ sudo systemd-run -t -p DynamicUser=yes -p StateDirectory=mympd -p CacheDirectory=mympd /usr/bin/mympd -c

# change port to 8080

$ sudo nano /var/lib/mympd/config/http_port

# deactivate SSL (false)

```
$ sudo nano /var/lib/mympd/config/ssl
```

# enable and start service

```
$ sudo systemctl enable mympd
```
```
$ sudo systemctl start mympd
```
```
$ sudo reboot
```

# check

```
$ sudo systemctl status mympd
```

# Raspotify Upgrade
# Install latest version of Raspotify on armhf
# before installing purge old version of raspotify

```
$ sudo apt purge raspotify
```

# attention on amd64 you need to remove the Raspotify docker image

```
$ sudo docker stop spot
```
```
$ sudo docker rm spot
```

# list images

```
$ sudo docker images
```

# get IMAGE ID and remove it

```
$ sudo docker rmi IMAGE_ID
```

# if docker is no longer used you can remove it as well
# for more info see the tutorial on page:
# MusicLounge: Spotify Connect (On amd64 Distro Using Docker)
# docker image is now removed
# to install Raspotify type the following command:

$ sudo apt-get -y install curl && curl -sL https://dtcooper.github.io/raspotify/install.sh | sh

# Edit Raspotify configuration:

```
$ sudo nano /etc/raspotify/conf
```

# and change these options only

LIBRESPOT_DEVICE_NAME="MusicLounge"
LIBRESPOT_BITRATE="160"
LIBRESPOT_DEVICE="plughw:1,0"

# CTRL+O to save
# CTRL+X to exit
# now enable and start the service

```
$ sudo systemctl daemon-reload
```
```
$ sudo systemctl enable raspotify
```
```
$ sudo systemctl start raspotify
```
```
$ sudo reboot
```

# check the status

```
$ sudo systemctl status raspotify
```

#
# TROUBLESHOOTING
#
# in case of warning related to libmdns

WARN  libmdns::fsm] dropping truncated packet from 192.168.x.x:5353

# this error is probably due to a bad implementation of mDNS in your router,
# you may update your router firmware or disable zeroconf (librespot discovery) and
# add your credentials to the Raspotify config
# edit conf and enable credential cache, disable discovery
# add your Spotify username and password

```
$ sudo nano /etc/raspotify/conf
```

#LIBRESPOT_DISABLE_CREDENTIAL_CACHE=
...
# Disable zeroconf discovery mode.
LIBRESPOT_DISABLE_DISCOVERY=
...
LIBRESPOT_USERNAME="...."
LIBRESPOT_PASSWORD="...."

# NGINX
# check nginx service

```
$ sudo systemctl status nginx
```

# in case of error

nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument

# make the following changes:

$ sudo mkdir /etc/systemd/system/nginx.service.d

$ sudo nano /etc/systemd/system/nginx.service.d/override.conf

# enter these lines

[Service]
ExecStartPost=/bin/sleep 0.1

# CTRL + X and Y to SAVE

```
$ sudo systemctl daemon-reload
```
```
$ sudo reboot
```

# open the ssh session and check the status

```
$ sudo systemctl status nginx
```

# check the status of minidlna service

```
$ sudo systemctl status minidlna
```

# in case of error related to autofs

/lib/systemd/system/minidlna.service:4: Failed to add dependency on autofs, ignoring: Invalid argument

# edit service to apply this fix

$ sudo nano /lib/systemd/system/minidlna.service

# and replace autofs by autofs.service
# CTRL + X and Y to SAVE

```
$ sudo systemctl daemon-reload
```
```
$ sudo reboot
```

# check your fstab entry and journalctl (sudo journalctl -f )
# in case of error type:

CIFS VFS: Server 192.168.x.x has not responded in xxx seconds. Reconnecting...

# read carefully the SAMBA tutorial chapter “CIFS Mounts Disconnecting Issue – Read More…” (end of the page)
# otherwise disable the cron job (comment line)

```
$ sudo nano /etc/cron.d/smb_v1_fix
```

#*/10 *   *   *   *   root    /home/pi/scripts/smb_v1_fix.sh >/dev/null 2>&1

# in case of dhcpcd error type

dhcpcd.service: Failed to locate executable /usr/lib/dhcpcd5/dhcpcd: No such file or directory

# check if you have an error in the status of the service

```
$ sudo systemctl status dhcpcd
```

Failed to start DHCP Client Daemon.

# edit the service
# to change ExecStart command to /usr/sbin/dhcpcd -q -w

$ sudo nano /etc/systemd/system/dhcpcd.service.d/wait.conf

[Service]
ExecStart=
ExecStart=/usr/sbin/dhcpcd -q -w

# restart service and check again the status

```
$ sudo systemctl daemon-reload
```
```
$ sudo systemctl restart dhcpcd
```
```
$ sudo systemctl status dhcpcd
```

# check the status of all other services ( airplay, roon, etc.) should be okay

# Congrats!
# Your MusicLounge audiophile server is fully updated to edition 2023
# now update the music library (database)
# use DroidMyMPD or MALP Android client
# or open your browser with http://musiclounge:8080 (or IP address)
# Enjoy!

I2S DAC Support

September 27, 2022July 30, 2023 Linux Audio Team

MusicLounge do not support I2S audio dac by default but it’s really easy to add the support of such cards.

Example 1 with Hifiberry DAC Plus RCA and Hiffiberry DAC+ PRO on Raspberry PI 4

Example 2 with Hifi Shield 2 (RCA) on Odriod C4

1- HIFIBERRY DAC And Raspberry PI 4

Make sure the board is correctly connected to the PI 4 and to the power supply (5V 3A)

# edit config.txt

pi@musiclounge:~ $ sudo nano /boot/config.txt

# add at end

dtoverlay=hifiberry-dacplus

CTRL+X to SAVE

List of Hifiberry device tree overlay:

DAC+ Standard/Pro/Amp2

dtoverlay=hifiberry-dacplus

DAC2 HD

dtoverlay=hifiberry-dacplushd

DAC+ ADC

dtoverlay=hifiberry-dacplusadc

DAC+ ADC Pro

dtoverlay=hifiberry-dacplusadcpro

Digi+

dtoverlay=hifiberry-digi

Digi+ Pro

dtoverlay=hifiberry-digi-pro

Reboot and That’s It!

Now check if card number is 1 using aplay -l

pi@musiclounge:~ $ aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: Headphones [bcm2835 Headphones], device 0: bcm2835 Headphones [bcm2835 Headphones]
Subdevices: 8/8
Subdevice #0: subdevice #0
Subdevice #1: subdevice #1
Subdevice #2: subdevice #2
Subdevice #3: subdevice #3
Subdevice #4: subdevice #4
Subdevice #5: subdevice #5
Subdevice #6: subdevice #6
Subdevice #7: subdevice #7
card 1: sndrpihifiberry [snd_rpi_hifiberry_dacplus], device 0: HiFiBerry DAC+ Pro HiFi pcm512x-hifi-0 [HiFiBerry DAC+ Pro HiFi pcm512x-hifi-0]
Subdevices: 1/1
Subdevice #0: subdevice #0

The trick here is to keep dtparam=audio=on (native headphone) to shift Hifiberry DAC to card number 1 to be dirrectly compatible with MusicLounge audio server settings.

if card number is different go HERE to reconfigure MPD and other audio services

and if you use the alsa equalizer plugin do not forget to change the plughw id in .asoundrc, see the tutorial here

here is a basic setup of the mpd output audio for hifiberry dac

audio_output {
type "alsa"
name "Hifiberry"
device "hw:1,0"
mixer_type "hardware"
mixer_control "Digital"
mixer_device "hw:1"
mixer_index "0"
dop "yes"
}

2- HIFI SHIELD 2 AND ODROID C4

Make sure the board is correctly connected to the C4 and to the power supply ( more info available HERE ).

# Edit /media/boot/config.ini to edit the DTBO settings. Open that file and find the part shown below. The below settings different from the default, it adds a new section named overlay_hifishield (C2) or overlay_hifishield2 (C4) and uses that section by the overlay_profile variable.

@musiclounge:~ $ sudo nano /media/boot/config.ini

For C4 Only:

; Device Tree Overlay
overlay_resize=16384
overlay_profile=hifishield2
overlays="spi0 i2c0 i2c1 uart0"
 
[overlay_custom]
overlays="i2c0 i2c1"
 
[overlay_hktft32]
overlays="hktft32"
 
[overlay_hktft35]
overlays="hktft35"
 
[overlay_hifishield2]
overlays="hifishield2"

For C2 only:

; Device Tree Overlay
overlay_resize=16384
overlay_profile=hifishield
overlays="spi0 i2c0 i2c1 uart0"
 
[overlay_custom]
overlays="i2c0 i2c1"
 
[overlay_hktft32]
overlays="hktft32"
 
[overlay_hktft35]
overlays="hktft35"
 
[overlay_hifishield]
overlays="hifishield"

Reboot and That’s It!

Now check if card number is 1 using aplay -l

pi@musiclounge:~ $ aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: ODROIDHDMI [ODROID-HDMI], device 0: SPDIF-dit-hifi dit-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
card 1: ODROIDHIFI [ODROID-HIFI], device 0: TDM-B-pcm5102a-hifi multicodec-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0

if card number is different go HERE to reconfigure MPD and other audio services

List of other Raspberry PI device tree overlay (untested):

502-dac
dtoverlay= hifiberry-dacplus
502-dac-pro
dtoverlay= hifiberry-dacplus
503hta-hybrid
dtoverlay= hifiberry-dac
adafruit-max98357
dtoverlay= hifiberry-dac
adafruit-uda1334a
dtoverlay= hifiberry-dac,i2s-mmap
allo-boss-dac
dtoverlay= allo-boss-dac-pcm512x-audio
allo-digione
dtoverlay= allo-digione
allo-katana-dac
dtoverlay= allo-katana-dac-audio
applepi-dac
dtoverlay= applepi-dac
audio-injector-isolated
dtoverlay= audioinjector-isolated-soundcard
audio-injector-ultra
dtoverlay= audioinjector-ultra
audiophonics-es9028q2m-dac
dtoverlay= i-sabre-q2m
bassfly
dtoverlay= hifiberry-dac
bassfly-mic
dtoverlay= googlevoicehat-soundcard
bassowl
dtoverlay= bassowl
es90x8q2m-dac
dtoverlay= es90x8q2m-dac
fe-pi-audio
dtoverlay= fe-pi-audio
generic-dac
dtoverlay= hifiberry-dac
hifibox-dac
dtoverlay= hifiberry-dacplus
iqaudio-amp
dtoverlay= iqaudio-dacplus,unmute_amp
iqaudio-dacplus
dtoverlay= iqaudio-dacplus,unmute_amp
iqaudio-digiplus
dtoverlay= iqaudio-digi-wm8804-audio
justboom-amp
dtoverlay= justboom-dac
justboom-dac
dtoverlay= justboom-dac
justboom-digi
dtoverlay= justboom-digi
mamboberry-dac
dtoverlay= hifiberry-dac
merus-amp
dtoverlay= merus-amp
nanosound-dac
dtoverlay= hifiberry-dacplus
osa-dacberry-one-plus
dtoverlay= hifiberry-dacplus
osa-dacberry-pro
dtoverlay= iqaudio-dacplus
phat-beat
dtoverlay= hifiberry-dac
phat-dac
dtoverlay= hifiberry-dac
piano-dac
dtoverlay= allo-piano-dac-pcm512x-audio
piano-dac-plus
dtoverlay= allo-piano-dac-plus-pcm512x-audio
picade-hat
dtoverlay= hifiberry-dac
pisound
dtoverlay= pisound
raspiaudio
dtoverlay= googlevoicehat-soundcard
raspidacv3
dtoverlay= raspidac3
rpi-dac
dtoverlay= rpi-dac
soekris-dac
dtoverlay= hifiberry-dac
speaker-phat
dtoverlay= hifiberry-dac
st400-dac-amp
dtoverlay= iqaudio-dacplus
taudac
dtoverlay= taudac
terraberry-dac2
dtoverlay= i-sabre-q2m

MISC.: Preparing A Minimal Linux Distro (Odriod C4 Example)

May 14, 2003March 26, 2023 Linux Audio Team

# preparing your linux distro
# before following our tutorials and build your audiophile server

# our ready to use audiophile server distribution image disk (MusicLounge) is available here

# all info below are applicable to Odroid and others boards like raspberry PI or barebone PC
# beware official Odroid Linux Kernel version (v3.16.85) is outdated and do not contains the Native DSD patch
# you need version 4.19.64 or greater to play native DSD,
# however selecting DOP MPD audio output will works with limitation

# To build the MusicLounge Audiophile Server we recommended:
# Armbian Focal or Jammy Linux Distro on Odroid C4,
# RaspiOS lite (Debian) buster or Bulleyes for Raspberry PI 4,
# latest stable Debian Standard or Ubuntu server for amd64 (buster or bullseye)

# MPD version 0.23.12 and 0.22.8 for old distribution
# myMPD version 10.2.0 and 10.7.1 for old distribution

# before building you audiophile server the software requirements are simple:
# pi user must be set
# ssh must be set
# alsa must be installed and should recognize your usb dac (command: aplay -l )

# get the img from repository (armbian, raspberry, debian)
# burn it on SDCARD (8GB is enough) with any tool like Win32DiskImager app on Windows
# connect your usb DAC
# boot
# and start the ssh session
# default login/pass:
# on odroid: root/odroid or root/1234
# on raspberry PI: pi/raspberry
# on amd64 Debian: root password is created during the installation
# on our MusicLounge distro: pi/musiclounge

# the root password needed to be changed immediately
# and a new user (non root) must be created (see below)

New root password: ************************
Repeat password: ************************

Choose default system command shell:

1) bash
2) zsh

Shell: BASH

Creating a new user account. Press  to abort

Please provide a username (eg. your forename): pi
Create password: ************************
Repeat password: ************************

Please provide your real name: Pi

Dear Pi, your account pi has been created and is sudo enabled.
Please use this account for your daily work from now on.

# sanity check

```
$ sudo apt update -y
```
```
$ sudo apt upgrade -y
```

# on armbian ssh is available by default

# on RaspiOS you need to add an empty file named ssh inside the sdcard before booting the OS

# on Ubuntu server amd64 SSH is activated during installation

# on Debian Standard amd64 you need to install openssh-server pkg

# on Debian netinstall you need to install sudo and pi to sudo group

```
~# su - root
```
```
~# apt install sudo
```
```
~# usermod -aG sudo pi
```

# after the first boot add user pi to sudoers on Debian

```
$ su - root
```
```
$ nano /etc/sudoers
```

# find line root ALL=(ALL:ALL) ALL and add this line

pi ALL=(ALL:ALL) ALL

# save
# CTRL+X then type y and enter
# go back to user

```
exit
```

# install ssh server
# not needed on debian netinstall distro as you normally install SSH server during the installation process

```
$ sudo apt install openssh-server -y
```

# active service

```
$ sudo systemctl start ssh
```
```
$ sudo systemctl enable ssh
```

# HEADLESS PC Server (boot without monitor on)
# BEWARE: if you install a distro supposed to work with GUI like Ubuntu/Debian
# and EVEN IF YOU DID NOT INSTALL A USER INTERFACE you may not be able to boot without a monitor!
# fortunately we can fix it by changed a few lines in grub bootloader to get our headless audio server

# edit grub conf

```
$ sudo nano /etc/default/grub
```

# and modify the parameters of GRUB_CMDLINE_LINUX_DEFAULT and GRUB_CMDLINE_LINUX to

GRUB_CMDLINE_LINUX_DEFAULT=""
GRUB_CMDLINE_LINUX="text"

# and obviously uncomment this line

GRUB_TERMINAL=console

# SAVE
# CTRL+X then type y and ENTER key

# now update grub

```
$ sudo update-grub
```

that’s it!

# optional: if bash auto-completion (automatically completing of file names, commands and more) is not installed by default

```
$ sudo apt-get install bash-completion
```

# audio check
# plug your usb DAC and type the cmd below to list soundcard, your dac must be in the list:

```
$ aplay -l
```

# alsa should be already installed (not in ubuntu server no soundcard driver by default)
# if your dac is not visible, install ALSA:

$ sudo apt-get install alsa-utils alsa-tools libasound2

# list devices to see if your DAC is recognized

```
$ aplay -l
```

root@odroid:~# aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: ODROIDHDMI [ODROID-HDMI], device 0: I2S dit-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
card 1: D90 [D90], device 0: USB Audio [USB Audio]
  Subdevices: 1/1
  Subdevice #0: subdevice #0

# your usb DAC should be visible in the list

# if still it’s not visible (no soundcard error)
# list installed alsa pkgs, remove them and reinstall alsa
#
# alsa-base pkg could be omited if not present in repository
”

```
$ sudo dpkg -l alsa*
```

$ sudo apt --purge remove alsa-base alsa-firmware-loaders alsa-oss alsa-source alsa-tools alsa-tools-gui alsa-topology-conf alsa-ucm-conf alsamixergui alsa-utils

$ sudo apt-get install alsa-base alsa-utils alsa-tools libasound2

```
$ sudo reboot
```

# check alsa status

$ sudo systemctl status alsa-utils.service

# if alsa service is masked unmask it

$ sudo rm /lib/systemd/system/alsa-utils.service

```
$ sudo systemctl daemon-reload
```

```
$ sudo systemctl enable alsa-utils
```
```
$ sudo systemctl start alsa-utils
```

# check the status again everything should be okay

$ sudo systemctl status alsa-utils.service

# on a minimal linux distro with only root you need to create a new user ‘pi’ (or other name) which going to be used to build your MusicLounge audiophile server
# if you’re already login as pi user skip the creation below and go to adding groups directly

# create a user pi:

```
$ adduser pi
```

root@odroid:~# adduser pi
Adding user `pi' ...
Adding new group `pi' (1000) ...
Adding new user `pi' (1000) with group `pi' ...
Creating home directory `/home/pi' ...
Copying files from `/etc/skel' ...
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Changing the user information for pi
Enter the new value, or press ENTER for the default
        Full Name []: PI
        Room Number []:
        Work Phone []:
        Home Phone []:
        Other []:
Is the information correct? [Y/n] y

# add new user to all default groups

$ sudo usermod -aG adm,dialout,cdrom,sudo,audio,www-data,video,plugdev,games,users,input,netdev pi

# for Raspberry PI add gpio i2c spi

$  sudo usermod -aG  adm,dialout,cdrom,sudo,audio,www-data,video,plugdev,games,users,input,render,netdev,gpio,i2c,spi pi

```
$ groups pi
```

# reboot, login pi (skip this step if you are already logged in as pi user)

```
$ sudo reboot
```

login as: pi
pi@192.168.1.11's password:
  ___      _           _     _    ____ _  _
 / _ \  __| |_ __ ___ (_) __| |  / ___| || |
| | | |/ _` | '__/ _ \| |/ _` | | |   | || |_
| |_| | (_| | | | (_) | | (_| | | |___|__   _|
 \___/ \__,_|_|  \___/|_|\__,_|  \____|  |_|

Welcome to Armbian 21.05.2 Focal with Linux 5.10.34-meson64

System load:   45%              Up time:       0 min
Memory usage:  4% of 3.73G      IP:            192.168.1.11
CPU temp:      42°C             Usage of /:    10% of 14G
RX today:      31.0 MiB

[ 0 security updates available, 4 updates total: apt upgrade ]

To run a command as administrator (user "root"), use "sudo ".
See "man sudo_root" for details.

pi@odroidc4:~$

# your linux distro is now ready

# click the link below to follow our tutorials and build the MusicLounge Audiophile Server

BUILD THE MUSICLOUNGE AUDIOPHILE DISTRO

Multi Room Audio Configuration

May 14, 2003April 4, 2023 Linux Audio Team

Multi Room Audio Configuration

# if you intend to create a multi-room audiophile configuration sharing the same music library on your LAN network
# Use the script below to configure your audio server very easily.
# change the hostname manually

```
$ sudo nano /etc/hosts
```
```
$ sudo nano /etc/hostname
```
```
$ sudo nano /etc/minidlna.conf
```
```
$ sudo nano /etc/upmpdcli.conf
```
```
$ sudo nano /etc/shairport-sync.conf
```
```
$ sudo nano /etc/raspotify/conf
```

# in Edition 2021 raspotify config (/etc/default/raspotify)
# and docker spot image must be changed as well, see the script 2021 below

# change hostname by script
# create the script in scripts directory

$ sudo nano ~/scripts/musicloungerenamer2023.sh

# SCRIPT EDITION 2023
# insert these lines (copy then right-click on ssh session)

#!/bin/bash

# File: musicloungerenamer.sh
# Author: Linux Audio Foundation
# Requirements: MusicLounge Audiophile Distro
# Link: https://linuxaudiofoundation.org/musiclounge-multi-room-audio-configuration/
#
# get current arch
arch=$(dpkg --print-architecture)

# check if run as root
if [ "$(id -u)" -ne 0 ]; then
echo "This script must be run by root" >&2
exit 1
fi

CURR_HNAME=$(cat /etc/hostname)

NEW_HOSTNAME=$1
NEW_HOSTNAMELOW=${NEW_HOSTNAME,,}
echo "current hostname: ${CURR_HNAME}" >&2
echo "new hostname: ${NEW_HOSTNAME}" >&2

# empty new hostname
if [ -z "${NEW_HOSTNAME}" ]; then
echo "error: hostname (first parameter) is empty!" >&2
exit 1
fi

# no change
if [ "${CURR_HNAME}" == "${NEW_HOSTNAME}" ]; then
echo "Same host name exit with no change." >&2
exit 1
fi


# mini dlna cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/minidlna.conf
echo "minidlna service changed to: ${NEW_HOSTNAME}" >&2

# upmpdcli (upnp)cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/upmpdcli.conf
echo "upnp service changed to: ${NEW_HOSTNAME}" >&2

# air play cfg
# nothing to do as general section contains name = "%H" which is current hostname
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/shairport-sync.conf
echo "AirPlay service changed to: ${NEW_HOSTNAME}" >&2

# spotify connect amd64 cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/raspotify/conf
echo "Spotify Connect (armhf/arm64) service changed to: ${NEW_HOSTNAME}" >&2

# hostname cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAMELOW/g" /etc/hostname

# hosts
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAMELOW/g" /etc/hosts

echo "hostname and hosts changed to: ${NEW_HOSTNAMELOW}" >&2

# ask before rebooting
while true; do
read -p "Hostname and services have been changed for ${NEW_HOSTNAME}, reboot for the change to take effect (y / n)? " yx
case $yx in
[Yy]* ) sudo reboot; break;;
* ) exit;;
esac
done

# CTRL+O to save
# CTRL+X to exit
# change permision

$ sudo chmod +x ~/scripts/musicloungerenamer2023.sh

# SCRIPT EDITION 2021
# change hostname by script
# create the script in scripts directory

$ sudo nano ~/scripts/musicloungerenamer2021.sh

# insert these lines (copy then right-click on ssh session)

#!/bin/bash

# File: musicloungerenamer.sh
# Author: Linux Audio Foundation
# Requirements: MusicLounge Audiophile Distro
# Link: https://linuxaudiofoundation.org/musiclounge-multi-room-audio-configuration/
#
# get current arch
arch=$(dpkg --print-architecture)

# check if run as root
if [ "$(id -u)" -ne 0 ]; then
echo "This script must be run by root" >&2
exit 1
fi

CURR_HNAME=$(cat /etc/hostname)

NEW_HOSTNAME=$1
NEW_HOSTNAMELOW=${NEW_HOSTNAME,,}
echo "current hostname: ${CURR_HNAME}" >&2
echo "new hostname: ${NEW_HOSTNAME}" >&2

# empty new hostname
if [ -z "${NEW_HOSTNAME}" ]; then
echo "error: hostname (first parameter) is empty!" >&2
exit 1
fi

# no change
if [ "${CURR_HNAME}" == "${NEW_HOSTNAME}" ]; then
echo "Same host name exit with no change." >&2
exit 1
fi

# hostname cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAMELOW/g" /etc/hostname

# hosts
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAMELOW/g" /etc/hosts

echo "hostname and hosts changed to: ${NEW_HOSTNAMELOW}" >&2

# mini dlna cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/minidlna.conf
echo "minidlna service changed to: ${NEW_HOSTNAME}" >&2

# upmpdcli (upnp)cfg
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/upmpdcli.conf
echo "upnp service changed to: ${NEW_HOSTNAME}" >&2

# air play cfg
# nothing to do as general section contains name = "%H" which is current hostname
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/shairport-sync.conf
echo "AirPlay service changed to: ${NEW_HOSTNAME}" >&2

# spotify connect armhf & arm64 cfg
if [ "amd64" != "$arch" ]; then
# armhf and arm64
sudo sed -i "s/$CURR_HNAME/$NEW_HOSTNAME/I" /etc/default/raspotify
echo "Spotify Connect (armhf/arm64) service changed to: ${NEW_HOSTNAME}" >&2
fi

# docker spot container on amd64 cfg
if [ "amd64" == "$arch" ]; then
# read -p "Press any key to stop Spotify Connect service"
sudo docker ps -q --filter "name=spot" | grep -q . && docker stop spot && docker rm -fv spot
# read -p "Press any key to change the new of Spotify Connect to ${NEW_HOSTNAME}"
export SPOTNAME=$(echo "NAME=${NEW_HOSTNAME}")
sudo docker run -d --restart unless-stopped \
--name "spot" \
--env $SPOTNAME \
--volume /tmp \
--group-add audio \
--device /dev/snd \
--net host \
--cap-drop ALL \
--read-only \
dubodubonduponey/librespot \
--backend alsa \
--device plughw:1,0 \
--disable-audio-cache \
--initial-volume=100
echo "Spotify Connect (Docker amd64) service changed to: ${NEW_HOSTNAME}" >&2
fi

# ask before rebooting
while true; do
read -p "Hostname and services have been changed for ${NEW_HOSTNAME}, reboot for the change to take effect (y / n)? " yx
case $yx in
[Yy]* ) sudo reboot; break;;
* ) exit;;
esac
done

# CTRL+O to save
# CTRL+X to exit

# change permision

$ sudo chmod +x ~/scripts/musicloungerenamer2021.sh

# we suggest a name which identify the room easily like a Music or Audio prefix + the room name (e.g MusicBedroom, MusicLivingroom, MusicKitchen,…)
# run the script with the audio server name in parameter, example:

```
$ cd scripts/
```

$ sudo ./musicloungerenamer.sh MusicKitchen

# type y to reboot the server
# that’s it!

Install Kodi 20.1 On Debian 11/12 (Bullseye/Bookworm)

May 14, 2003April 9, 2023 Linux Audio Team

# KODI Installation version 20.1 Nexus on Debian 11/12 (Bullseye/Bookworm)

# Kodi is a multi-platform home-theater PC (HTPC) application.
# official repository: https://github.com/xbmc/xbmc
# website: http://kodi.tv/

# update all pkgs

```
$ sudo apt update
```

# if need run upgrade

```
$ sudo apt upgrade
```

# all pkgs must be up to date before going further

# edit source list to add testing repo

```
$ sudo nano /etc/apt/sources.list
```

# add the line below at end

deb http://deb.debian.org/debian testing main non-free contrib

# CTRL+X and Y to SAVE
# get testing packages list

```
$ sudo apt update
```

DO NOT UPGRADE

# install kodi 20.1

```
cd ~/Downloads
```

# AMD64

```
$ sudo apt install kodi
```

# or
# download/install Kodi 20.1 manually (not recommended)

$ wget -O  kodi_20.1+dfsg-1_amd64.deb http://ftp.us.debian.org/debian/pool/main/k/kodi/kodi_20.1+dfsg-1_amd64.deb

# in case of dependencies error, download and install all pkgs

$ for x in {'kodi-repository-kodi_20.1+dfsg-1_all.deb','kodi-data_20.1+dfsg-1_all.deb','kodi-bin_20.1+dfsg-1_amd64.deb','kodi_20.1+dfsg-1_amd64.deb'}; do wget $x http://ftp.us.debian.org/debian/pool/main/k/kodi/$x; done

# install Kodi 20.1 manually

$ sudo apt install ./kodi-data_20.1+dfsg-1_all.deb ./kodi-bin_20.1+dfsg-1_amd64.deb ./kodi_20.1+dfsg-1_amd64.deb ./kodi-repository-kodi_20.1+dfsg-1_all.deb

# ARM64 Raspberry PI 4

```
$ sudo apt install kodi
```

# or
# download/install Kodi 20.1 manually (not recommended)

$ for x in {'kodi-repository-kodi_20.1+dfsg-1_all.deb','kodi-data_20.1+dfsg-1_all.deb','kodi-bin_20.1+dfsg-1_arm64.deb','kodi_20.1+dfsg-1_arm64.deb'}; do wget $x http://ftp.us.debian.org/debian/pool/main/k/kodi/$x; done

$ sudo apt install ./kodi-data_20.1+dfsg-1_all.deb ./kodi-bin_20.1+dfsg-1_arm64.deb ./kodi_20.1+dfsg-1_arm64.deb ./kodi-repository-kodi_20.1+dfsg-1_all.deb

# official repo should be automatically installed but if you want to install it manually

$ $ sudo apt install kodi-repository-kodi

# add current user to all needed groups

$ sudo usermod -aG adm,dialout,cdrom,sudo,audio,www-data,render,video,plugdev,games,users,dip,input $USER

# for Raspberry PI add gpio i2c spi

$  sudo usermod -aG  adm,dialout,cdrom,sudo,audio,www-data,video,plugdev,games,users,input,render,netdev,gpio,i2c,spi pi

# edit source list to comment testing repo

```
$ sudo nano /etc/apt/sources.list
```

# comment testing repo

#deb http://deb.debian.org/debian testing main non-free contrib

# CTRL+X and Y to SAVE
# get main packages list

```
$ sudo apt update
```

# Kodi Power Menu

# SUSPEND/RESUME (amd64 platform)
# enable suspend services

$ sudo systemctl unmask sleep.target suspend.target hibernate.target hybrid-sleep.target

# 2 way to enable power policy for pi user
# 1. if /etc/polkit-1/localauthority exists

$ sudo nano /etc/polkit-1/localauthority/50-local.d/50-kodi.pkla

[Allow consolekit]
Identity=unix-group:plugdev
Action=org.freedesktop.upower.suspend;org.freedesktop.consolekit.system.*
#Action=org.freedesktop.consolekit*
ResultAny=yes
ResultInactive=no
ResultActive=yes
[Allow login1]
Identity=unix-group:plugdev
Action=org.freedesktop.login1*
ResultAny=yes
ResultInactive=no
ResultActive=yes
[Allow Upower]
Identity=unix-group:plugdev
Action=org.freedesktop.upower.suspend
ResultAny=yes
ResultInactive=no
ResultActive=yes

# CTRL + X the Y to SAVE

# 2. alternative
# or create rules in /usr/share/polkit-1/rules.d/

$sudo nano /usr/share/polkit-1/rules.d/10-kodi.rules

polkit.addRule(function(action, subject) {
    polkit.log("action=" + action);
    polkit.log("subject=" + subject);
    if (action.id.indexOf("org.freedesktop.login1.") == 0) {
        return polkit.Result.YES;
    }
    if (action.id.indexOf("org.freedesktop.udisks.") == 0) {
        return polkit.Result.YES;
    }
    if (action.id.indexOf("org.freedesktop.upower.") == 0) {
        return polkit.Result.YES;
    }
});

# CTRL + X the Y to SAVE

# run kodi to check the power menu

```
$ kodi-standalone
```

# create kodi service

$ sudo nano /lib/systemd/system/kodi.service

[Unit]
Description = Kodi Media Center
After = remote-fs.target network-online.target
Wants = network-online.target
[Service]
User = pi
Group = pi
Type = simple
ExecStart = /usr/bin/kodi-standalone
Restart = on-abort
RestartSec = 5
[Install]
WantedBy = multi-user.target

# CTRL + X the Y to SAVE

```
$ sudo systemctl daemon-reload
```

```
$ sudo systemctl enable kodi
```

```
$ sudo systemctl start kodi
```

```
$ sudo systemctl status kodi
```

# add kodi smb share points

# insert lines at the end of conf

```
$ sudo nano /etc/samba/smb.conf
```

[kodi]
path = /home/pi/.kodi
read only = no
public = yes
writable = yes
browseable = yes
guest ok = yes
create mask = 0777
directory mask = 0755
force user = pi

[userdata]
path = /home/pi/.kodi/userdata
read only = no
public = yes
writable = yes
browseable = yes
guest ok = yes
create mask = 0777
directory mask = 0755
force user = pi

# CTRL + X the Y to SAVE

```
$ sudo systemctl restart smbd
```

```
$ sudo reboot
```

# Adding media source to Kodi

# IMPORTANT NOTICE for Windows network SMB share in Kodi 20
# make sure to configure your NAS with shared folders using SMB v2 or v3 and with
# access to everyone (no user/pass)
# setup KODI SMB service with minimum version SMBv2 and maximum SMBv3
# browse the network from a PC and check if you have a full access to shared
# folders without needing to enter your credential
# then in Kodi create your movies, TV shows, etc. source points (i.e. //MYSERVER/Video ) with
# a dummy username and password (like username: srcmedia and paswd: srckodi)

# OPTIONAL: create Video and TV Shows folders if you store the media on the server (not recommended)

```
$ cd ~/
```

```
$ mkdir Video
```

```
$ mkdir "TV Shows"
```

# setup HDMI CEC

# on raspberry PI 4 HDMI CEC is already managed,
# however some keys of remote control must be adjusted like the back and contextual menu key.
# use the Keymap Editor addon (already installed) to make your changes in >global>navigation.

# on amd64 platform

# do not forget to add the Pulse Heigh CEC adapter ( https://www.pulse-eight.com ) to be able to use the TV remote control even with the Intel NUC which have a poor CEC implementation.
you may need to deactivate internal IR Receiver and HDMI CEC in Intel NUC Bios.

# install rc6 mce IR remote control with Kodi 20

# by default Kodi manages the RC6 MCE remote control if your usb dongle is installed or the built in extended IR receiver is set in your bios
# you may need to activate internal IR Receiver in Intel NUC Bios.
# unfortunately some essential buttons of the remote control do not work like BACK (KEY_BACK) and OK (KEY_OK) for example. Read the instructions below to fix it.
# open SSH session
# install ir-keytable

```
$ sudo apt install ir-keytable
```

# check if remote control is recognized

```
$ sudo ir-keytable
```

# result for usb dongle (mceusb)

Found /sys/class/rc/rc0/ with:
        Name: Media Center Ed. eHome Infrared Remote Transceiver (147a:e03e)
        Driver: mceusb
        Default keymap: rc-rc6-mce
        Input device: /dev/input/event6
        LIRC device: /dev/lirc0
        Attached BPF protocols: Operation not supported
        Supported kernel protocols: lirc rc-5 rc-5-sz jvc sony nec sanyo mce_kbd rc-6 sharp xmp imon rc-mm
        Enabled kernel protocols: lirc rc-6
        bus: 3, vendor/product: 147a:e03e, version: 0x1201
        Repeat delay = 500 ms, repeat period = 125 ms

# example with build IR (cir)

Found /sys/class/rc/rc0/ with:
        Name: ITE8708 CIR transceiver
        Driver: ite-cir
        Default keymap: rc-rc6-mce
        Input device: /dev/input/event4
        LIRC device: /dev/lirc0
        Attached BPF protocols: Operation not supported
        Supported kernel protocols: lirc rc-5 rc-5-sz jvc sony nec sanyo mce_kbd rc-6 sharp xmp imon rc-mm
        Enabled kernel protocols: lirc rc-6
        bus: 25, vendor/product: 1283:0000, version: 0x0000
        Repeat delay = 500 ms, repeat period = 125 ms

# Important Info are:

 system device: rc0 (Found /sys/class/rc/rc0/)
driver: mceusb or ite-cir
protocol: rc-6

# copy the rc6 mce keymap rc6_mce.toml from /lib/udev/rc_keymaps/ to /etc/rc_keymaps/

$ sudo cp /lib/udev/rc_keymaps/rc6_mce.toml /etc/rc_keymaps/

# edit the keymap to fix it

$ sudo nano /etc/rc_keymaps/rc6_mce.toml

# replace entries 0x800f0412, 0x800f0413, 0x800f0418, 0x800f0422 and 0x800f0423 with:

.
.
0x800f0412 = "KEY_PAGEUP"
0x800f0413 = "KEY_PAGEDOWN"
.
0x800f0418 = "KEY_PLAY"
.
.
0x800f0422 = "KEY_ENTER"
0x800f0423 = "KEY_BACK"

# CTRL+X then Y to save
# edit /etc/rc_maps.cfg to add our custom keymap for mceusb and ite-cir driver

```
$ sudo nano /etc/rc_maps.cfg
```

# add these lines at end

mceusb	*			/etc/rc_keymaps/rc6_mce.toml
ite-cir	*			/etc/rc_keymaps/rc6_mce.toml

# CTRL+X then Y to save
# now we are going to create a service to load our keymap at startup

$ sudo nano /etc/systemd/system/rc6mce-ir-keytable.service

# rc-6 protocol and sys/class/rc rc0 is reported and obviously the path to our keymap

[Unit]
Description=RC6 MCE Keymap Fix
After=network.service kodi.service
[Service]
Type=oneshot
ExecStart=/usr/bin/ir-keytable -c -p rc-6 --write=/etc/rc_keymaps/rc6_mce.toml --sysdev=rc0
[Install]
WantedBy=default.target

# CTRL+X then Y to save
# activate the service

$ sudo systemctl enable rc6mce-ir-keytable.service

# start service

$ sudo systemctl start rc6mce-ir-keytable.service

# now the pause, back and OK buttons work and to get info select the item on Kodi and do a long press on OK
# reboot

```
$ sudo reboot
```

# to test your remote control or get the correct scancode

```
$ sudo ir-keytable -t
```

# Backup / Restore Kodi Data

# backup

```
$ cd ~/
```

$ tar cvzf ~/Downloads/"kodi_backup-$(date +'%m-%d-%y').tar.gz" --exclude=.kodi/temp .kodi

# restore

```
$ cd ~/
```
```
$ sudo systemctl stop kodi
```
```
$ tar xzvf kodi_backup-xx-xx-xx.tar.gz
```
```
$ sudo systemctl start kodi
```

# UNINSTALL KODI SERVICES

# if for some reason you no longer need the Home Theater service and want to keep the server for the audio system only (in short using it as the MusicLounge server) do the following

```
$ sudo systemctl stop kodi
```

```
$ sudo systemctl disable kodi
```

# edit /etc/samba/smb.conf to remove or comment SMB Share kodi

```
$ sudo nano /etc/samba/smb.conf
```

#[kodi]
#path = /home/pi/.kodi
#read only = no
#public = yes
#writable = yes
#browseable = yes
#guest ok = yes
#create mask = 0777
#directory mask = 0755
#force user = pi

#[userdata]
#path = /home/pi/.kodi/userdata
#read only = no
#public = yes
#writable = yes
#browseable = yes
#guest ok = yes
#create mask = 0777
#directory mask = 0755
#force user = pi

# CTRL + X and Y to save

```
$ sudo reboot
```

# you can remove kodi user data and configuration files if needed

```
$ cd ~/
```
```
$ sudo rm -r .kodi
```

# Congrats! The audiophile server and the Kodi Home Theater are ready

# setup the Kodi SYSTEM > AUDIO > and choose the correct number of speakers
# activate the passthrough to take benefit of Dolby, DTS, trueHD, etc.

TIDAL Connect Installation

May 12, 2003March 9, 2023 Linux Audio Team

# OPTIONAL: install Tidal Connect For Raspberry PI 4 only,

# for amd64 and odroid platform use an upnp client with Tidal plugin (see upnp renderer tutorial for more info)

# using your DAC to listen music from Tidal

Tidal Connect is a service similar to Spotify Connect. Using the Tidal app to play a song you can easily click the device selector icon (top right) to select the Musiclounge Streamer audio server.

We are going to install it on MusicLounge Audio Server for Raspberry PI 4 as Tidal connect linux binary seems to be only available on arm 32bit (Raspberry PI). This installation is based on https://github.com/shawa github repo.

# if install pkg ends with error:
# “Failed to start The PHP 7.3 FastCGI Process Manager”
# type the cmd below to create the missing directory:

```
$ sudo mkdir /var/run/php
```

# add stretch repo to sources list
# we need to temporary add it to install old libavformat.so.57

# add line:

deb http://archive.raspbian.org/raspbian stretch main

```
$ sudo nano /etc/apt/sources.list
```

CTRL+X and y to save

# update pkgs list

```
$ sudo apt update
```

# install dependencies

$ sudo apt install -y libavformat57 libportaudio2* libflac++6v5*

# edit again /etc/apt/sources.list to disable (place # to comment) debian stretch repo after the installation of the libs

```
$ sudo nano /etc/apt/sources.list
```

#deb http://archive.raspbian.org/raspbian stretch main

# CTRL+X and Y to Save

# install other dependencies

$ sudo curl -k -O -L http://security.debian.org/debian-security/pool/updates/main/o/openssl/libssl1.0.0_1.0.1t-1+deb8u12_armhf.deb

$ sudo apt install -y ./libssl1.0.0_1.0.1t-1+deb8u12_armhf.deb

$ sudo curl -k -O -L http://security.debian.org/debian-security/pool/updates/main/c/curl/libcurl3_7.38.0-4+deb8u16_armhf.deb

$ sudo apt install -y ./libcurl3_7.38.0-4+deb8u16_armhf.deb

# create working folder

```
$ sudo mkdir /usr/ifi
```

# enter directory

```
$ cd /usr/ifi
```

# clone git repo inside the directory

$ sudo git clone https://github.com/shawaj/ifi-tidal-release

# fix file permissions

$ sudo chmod +x /usr/ifi/ifi-tidal-release/play

$ sudo chmod +x /usr/ifi/ifi-tidal-release/bin/tidal_connect_application

$ sudo chmod +x /usr/ifi/ifi-tidal-release/pa_devs/run.sh

# deploy tidal service

$ sudo ./ifi-tidal-release/file-deploy.sh

# get your device name

```
$ aplay -l
```

# in this example the USB DAC detected is a Topping D90 MQA on card 1

card 0: Headphones [bcm2835 Headphones], device 0: bcm2835 Headphones [bcm2835 Headphones]
  Subdevices: 8/8
  Subdevice #0: subdevice #0
  Subdevice #1: subdevice #1
 ...
card 1: MQA [D90 MQA], device 0: USB Audio [USB Audio]
  Subdevices: 1/1
  Subdevice #0: subdevice #0

# edit the tidal connect service to update your device name

# change parameter -f and –model-name with Musiclounge Streamer
# if your DAC supports MQA set parameter –codec-mqa and –enable-mqa-passthrough to true
# and change (or add) parameter –playback-device with your USB DAC name followed by “: USB Audio (hw:x,0)”
# x corresponding to the card number: (hw:1,0) for card 1

$ sudo nano /lib/systemd/system/ifi-streamer-tidal-connect.service

[Unit]
Description=RasPi Streamer Tidal Connect Service
[Service]
Restart=on-failure
ExecStart=/usr/ifi/ifi-tidal-release/bin/tidal_connect_application \
                                --tc-certificate-path "/usr/ifi/ifi-tidal-release/id_certificate/IfiAudio_ZenStream.dat" \
                                -f "Musiclounge Streamer" \
                                --codec-mpegh true \
                                --codec-mqa true \
                                --model-name "Musiclounge Streamer" \
                                --disable-app-security false \
                                --disable-web-security false \
                                --enable-mqa-passthrough true \
                                --log-level 3 \
                                --enable-websocket-log "0"
                                --playback-device "D90 MQA: USB Audio (hw:1,0)"

User=root
Group=root
RestartSec=1
KillMode=control-group
[Install]
WantedBy=multi-user.target

# CTRL+X and Y to Save

# start service and check on status

```
$ sudo systemctl daemon-reload
```

# enable service at startup

$ sudo systemctl enable ifi-streamer-tidal-connect.service

# start service

$ sudo systemctl start ifi-streamer-tidal-connect.service

# Check the status

# the status is very important to check if the service is enabled and run correctly

# also useful to get the correct name of valid device(s)
# see the instructions above to change the –playback-device parameter

$ sudo systemctl status ifi-streamer-tidal-connect.service