--> For general support consult first the wiki at
https://wiki.archlinux.org
--> If you have installed to internal drive, you should have also audiolinux on a USB stick, in case of operations that cannot be made from inside (boot problems, hard disk check, etc.)

* For audiolinux lxqt please look inside the directory "Start here" on the Desktop and read all the... read-me files.
You can also configure this version as headless selecting the appropriate default (see below CHANGING BOOT DEFAULT). In this case you can minimize the system removing completely gvfs with
pacman -R gvfs gvfs-afc gvfs-nfs gvfs-smb
and eventually disabling samba:
systemctl disable smb
systemctl disable nmb
--> Also in headless mode you can connect to lxqt desktop with NoMachine and return to headless with a logout, see section REMOTE CONNECTION

PASSWORDS

user, ssh, NoMachine: audiolinux
root, samba: audiolinux0

hqplayerd web interface:
user: audiolinux
password audiolinux (or audiolinux0)

FILE EDITING

* In audiolinux lxqt you can use pcmanfm-qt file explorer (click on the red icon on the bottom bar for root editing)

An easy method to work with files for edit, copy etc. is to use Midnight Commander. Type
mc
for starting it

otherwise you can use nano
nano full-file-path
Example:
nano /etc/fstab

ROOT USER

How to switch to root user:
Type
su
and give the password audiolinux0
You can return to normal user with
exit

For poweroff and reboot, you can use sudo in a user (not root) terminal:
sudo poweroff
sudo reboot
* In audiolinux lxqt you can use the usual shortcuts

RAM MODE

* In audiolinux lxqt you can find special shortcuts in
/Start here/Expert/Ramroot/

To load the entire system at boot, type (as root)
ramroot -F enable
To disable ramroot
ramroot remove

--> if you are using Roon, please take into account that Roon database will take some space, please be sure that the drive and ram size are enough

When in ram mode you can use these commands (the first 2 as root):
ramsave --> save the system when in ram mode (otherwise all changes will be lost)
For system modification we suggest however to boot in normal mode answering N to ramroot boot prompt. Modifications to the file /etc/fstab will be saved only in normal mode
clean --> remove trash files, pacman and system cache
memorytest --> check memory speed

For reducing ramroot timeout default at boot, you can edit as root /usr/bin/ramroot and change
LOAD_TIMEOUT_DEFAULT=15
from 15 seconds to the value you want

REMOTE CONNECTION

* In audiolinux lxqt you can connect to graphical Desktop with NoMachine, if you install it in Windows, Linux, smartphone. With NoMachine remote Dektop you can start headless without graphical Desktop and access AudioLinux in a virtual Desktop identical to the default one. After your configuration is finished, you can switch back to headless with a simple logout.

You can access audiolinux headless from another

computer with ssh:
ssh audiolinux@ip-address
If you want to use a file browser from another pc, you can use the protocol sftp
sftp://audiolinux@ip-address

--> you can check the ip address for audiolinux with
ip addr show

--> From Windows you can use Putty
--> From Android JuiceSSH

UNIFIED REMOTE

* In audiolinux lxqt you can control your system from your smartphone or tablet with unified remote. See https://www.unifiedremote.com/

To enable it, start lxqt configuration, go to Session settings/Autostart and enable "Unified Remote"
Unified remote is started with the command:
opt/urserver/urserver --daemon

NETWORK

* In audiolinux lxqt you can configure the network with the icon on the bottom bar (right). What is written below only concerns audiolinux headless

You can change from DHCP to a static address modifying the file /etc/systemd/network/en.network or  /etc/systemd/network/eth.network

from

[Match]
Name=en*

[Network]
DHCP=yes

to

[Match]
Name=en*

[Network]
Address=192.168.1.5/24
Gateway=192.168.1.1
DNS=8.8.8.8

For WiFi, provided that your adapter is recognized by linux, the relevant wiki section is here:
https://wiki.archlinux.org/index.php/Systemd-networkd#Wireless_adapter
However, you must also configure and install wpa-supplicant
https://wiki.archlinux.org/index.php/WPA_supplicant

--> change Address, Gateway and DNS to your preferred values.
--> you can delete /etc/systemd/network/21-wired.network if you have only one network card.

AUDIO AND OTHER SERVICES

* In audiolinux lxqt you can find some nice shortcuts for enabling/starting/disabling services inside Start here. MPD, LMS and squeezelite are already installed.

* For audio services and other options there is a new configuration Menu (from version 0.4)



In audiolinux headless Roon and HQPlayer embedded are already installed.
The new Menu is already prepared for MPD, LMS and squeezelite.
Squeezelite + LMS installation:
yaourt -S logitechmediaserver-git squeezelite-r2-git
Configuration file for squeezelite: /etc/conf.d/squeezelite

MPD and UPnP installation:
yaourt -S mpd upmpdcli
Configuration file for MPD: /home/audiolinux/.mpdconf

With systemctl you can stop, start, restart or enable the services at boot. In the commands where there is not "--user" you must switch to root user (see above)

Examples:

Starting and enabling hqplayerd:
systemctl --user start hqplayerd
systemctl --user enable hqplayerd

Starting and enabling Roon:
systemctl start roonserver
systemctl enable roonserver

Starting and enabling naa:
systemctl --user start networkaudio
systemctl --user enable networkaudio

You can stop or disable, changing start to stop and enable to disable.

If you need to enable samba:
systemctl enable smb
systemctl enable nmb
and reboot
Note: the directories /home/audiolinux/Downloads and /home/audiolinux/Music are already set as samba share

--> For showing enabled systemd services:
systemctl list-unit-files | grep enabled
For user services:
systemctl --user list-unit-files | grep enabled

Note 1: You can add some delay in starting hqplayerd or networkaudio. For this, go as root to
/usr/lib/systemd/user/networkaudio.service
or
/usr/lib/systemd/user/hqplayerd.service
and take out the # in front of the line
# ExecStartPre=/bin/sleep 30
Default is 30 seconds, you can change this to a different value.

Note 2: When configuring hqplayerd at http://localhost:8088/auth or http://localhost:8088/config please be sure to select Scope --> user at top left, since audiolinux is using the user directory /home/audiolinux/.hqplayer/ for configuration files and license

UPGRADING THE SYSTEM

For updating a single application:
pacman -Sy (update the database)
pacman -S name-of-application
if this application is in AUR database (as HQPlayer, Roon, etc.)
yaourt -S name-of-application
Example for updating hqplayerd and roon:
yaourt -S hqplayer-embedded roonserver roonbridge

For updating the system (expert users)
pacman -Syu
after this, you can update the AUR packages with
yaourt -Syua

OTHER AUDIO APPLICATIONS

* In audiolinux lxqt mpd, logitechmediaserver and  squeezelite are already installed

For installing logitechmediaserver + squeezelite:
yaourt -S logitechmediaserver-git squeezelite-r2-git

For installing mpd
yaourt -S mpd

Please note that these commands will install the application and many dependencies, so audiolinux size will increase and as a consequence boot time in ram mode.

INSTALLING NEW KERNEL

* audiolinux lxqt is configured only for linux-rt (not bfq) kernel. To install a new kernel go to https://www.audio-linux.com/ftp/packages/kernel/last/ with Chromium, download the files and install with pacman -U as reported below

Installing new audiolinux realtime kernel.
First install lftp package with:
pacman -S lftp
After type
lftp https://www.audio-linux.com/ftp/packages/kernel/last/
Show available images with
ls
Download to /home/audiolinux with the command get followed by the names of the packages. You should download at least linux-rt-bfq-* and linux-rt-bfq-headers-* or linux-rt-* and linux-rt-headers-*
Finally type
exit
and install the new kernel with pacman -U followed by the names of the packages.

In audiolinux headless you can install this way rt or rt-bfq kernels.
For standard archlinux kernel:
pacman -Sy
pacman -S linux linux-headers

In audiolinux headless however we suggest to install only one kernel (possibly linux-rt-bfq), otherwise the system boot time will increase.

Session example:

[audiolinux@archlinux ~]$ lftp https://www.audio-linux.com/ftp/packages/kernel/last/
cd ok, cwd=/ftp/packages/kernel/last                                 
lftp https://www.audio-linux.com:/ftp/packages/kernel/last> ls
...
lftp https://www.audio-linux.com:/ftp/packages/kernel/last> get linux-rt-bfq-4.18.7.5-3-x86_64.pkg.tar.xz linux-rt-bfq-headers-4.18.7.5-3-x86_64.pkg.tar.xz
86728716 bytes transferred in 29 seconds (2.90 MiB/s)                                                 
Total 2 files transferred
lftp https://www.audio-linux.com/ftp/packages/kernel/last/ :/ftp/packages/kernel/last> exit
[audiolinux@archlinux ~]$ pacman -U linux-rt-bfq-4.18.7.5-3-x86_64.pkg.tar.xz linux-rt-bfq-headers-4.18.7.5-3-x86_64.pkg.tar.xz

CHANGING BOOT DEFAULT

* In audiolinux lxqt you have 2 more options:
audiolinuxclBFQ (headless command line boot)
audiolinuxclEXTREME.conf (headless command line boot, extreme mode)

For changing boot default you can edit as root the file
/boot/loader/loader.conf
and change the line
default audiolinuxBFQ
to
default archlinux (standard archlinux kernel, if installed)
default audiolinux-fallback (realtime kernel bfq, if you have problems at boot because of missing drivers)
default audiolinux  (standard rt kernel, if installed)
default audiolinuxEXTREME (realtime kernel bfq with some parameters that prevent cpu sleep. In this case please check the temperature. For exceptional cpu latency)

REALTIME PRIORITY

* In audiolinux lxqt you can find some shortcuts in /Start here/Expert/Realtime Priority/ for changing Realtime priority

For testing:
Type
rttest

For checking realtime status:
rtstatus

For checking audio cards parameters and irq assignements:
rtcards

Manual realtime priority is controlled by rtirq and rtapp. In standard /etc/rtirq.conf priority is given to all usb devices:
RTIRQ_NAME_LIST="usb"
but, if checking with rtstatus and rtcards shows that your dac is using xhci_hcd, you can change it to:
RTIRQ_NAME_LIST="xhci_hcd"

Suggested realtime configurations:

1) Standard
/etc/rtirq.conf
RTIRQ_PRIO_HIGH=90
RTIRQ_PRIO_DECR=5
/etc/rtapp/rtapp.conf
MAX_PRIORITY="85"

2) Extreme
/etc/rtirq.conf
RTIRQ_PRIO_HIGH=95
RTIRQ_PRIO_DECR=2
/etc/rtapp/rtapp.conf
MAX_PRIORITY="90"

Max possible priority is set system-wide at 98

HOW TO INSTALL NVIDIA PROPRIETARY DRIVERS

* In audiolinux lxqt you can install all the nvidia packages with
pacman -S nvidia-dkms nvidia-settings nvidia-utils opencl-nvidia

--> This is necessary for enabling CUDA acceleration in HQPlayer, if you have a nvidia card.

You can install the nvidia proprietary drivers with
pacman -Sy
pacman -S nvidia-dkms nvidia-utils opencl-nvidia
After you should add the section "Device" to /etc/X11/xorg.conf.d/xorg.conf

Section "ServerFlags"
      Option "BlankTime" "0"
      Option "StandbyTime" "0"
      Option "SuspendTime" "0"
      Option "OffTime" "0"
EndSection

Section "Device"
        Identifier "Nvidia Card"
        Driver "nvidia"
        VendorName "NVIDIA Corporation"
        Option "NoLogo" "true"
        Option "Coolbits" "4"
EndSection

Optionally you could blacklist the open source driver "nouveau" creating the file /etc/modprobe.d/blacklist.conf with the following content:
blacklist nouveau