PRICES:

Audiolinux lxqt 1 year support with image            $ 49
Audiolinux headless 1 year support with image        $ 49
Audiolinux BBB 1 year support with image             $ 29
Audiolinux Pi3 64 bit 1 year support with images*    $ 29
Audiolinux extra year of support                     $ 20
Audiolinux all versions unlimited time support**     $ 149
Audiolinux additional image***                       $ 20
Audiolinux lxqt or headless unlimited time support   $ 99
Audiolinux USB stick/SD card with shipping           $ 99 
             
* 2 images, one with Raspberry kernel
** You can download headless, lxqt, BBB, Pi3
*** If you have one image and you want another.
For example if you already have lxqt and you want headless.

--> 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 NoMachine:
systemctl disable nxserver
--> 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/

It is recommended at least 16GB RAM for lxqt version (8 GB for AudioLinux headless)

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)
clean --> remove trash files, pacman and system cache
memorytest --> check memory speed

For system modification and system update 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. For kernel update you must disable ramroot, see section
UPGRADING THE SYSTEM

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. If you want to switch to systemd network you can type as root user:
systemctl disable NetworkManager
systemctl enable systemd-networkd
and reboot
This will be necessary if you have a license for hqplayer embedded

Audiolinux headless 0.5 has an automatic configuration that will permit to connect immediately after booting the first time.
However, for a more stable network configuration, follow the steps reported below.
---> if you have more than one card, add a second configuration file in /etc/systemd/network/

Look for your network name with
networkctl
Example:
[audiolinux@archlinux ~]$ networkctl
 1 lo               loopback           carrier     unmanaged 
 2 enp3s0           ether              routable    configured

If your network is enp3s0 (yours will be most probably different) change as root /etc/systemd/network/en.network from

[Match]
Name=en*

[Network]
DHCP=yes

to

[Match]
Name=enp3s0

[Network]
DHCP=yes

Delete (as root) /etc/systemd/network/eth.network with
rm /etc/systemd/network/eth.network
and reboot

DHCP=yes will allow both ipv4 and ipv6
See wiki at https://wiki.archlinux.org/index.php/systemd-networkd

You can change from DHCP to a static address modifying the file /etc/systemd/network/en.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.

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) and also a monitor Menu (from version 0.6)





In audiolinux headless Roon and HQPlayer embedded are already installed.
The new Menu is already prepared for MPD, LMS and squeezelite. For installing these applications, go to the section OTHER AUDIO APPLICATIONS

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

Note 3: If you are using Roonbridge in more than one computer take into account that: "RoonBridge generates and writes out a unique id into its data directory on first run and uses that to identify itself to RoonServer. Clear out /var/roon on the second device (or hunt down and delete the RAATServer/Settings/unique_id file) and it will generate itself a new one next time it starts up."

Note 4 for lxqt version: If hqplayerd is changing hardware signature after reboot, you must change network manager to systemd network. Contact support for directions.

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

For system modification and system update we suggest to boot in normal mode answering N to ramroot boot prompt.
You must disable ramroot before installing a new kernel with
ramroot remove
and reboot
After, if you want, you can re-enable it with
ramroot -F enable

OTHER AUDIO APPLICATIONS

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

Squeezelite + LMS installation:
yaourt -S logitechmediaserver-git squeezelite-r2-git
Configuration file for squeezelite: /etc/conf.d/squeezelite
For listing available devices:
squeezelite -l

If you want to install the standard git version of Squeezelite, download the package from here and install it with
pacman -U squeezelite-git-1.9.0-1-x86_64.pkg.tar.xz
Take into account that the new configuration file will be /etc/squeezelite.conf and and that the systemd service can be started with
systemctl start squeezelite
(before it was squeezelite@audiolinux, so audiolinux shortcuts or menu option will not work, you must start/enable it manually)

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

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

* In audiolinux lxqt go to https://www.audio-linux.com/ftp/packages/kernel/last/linux-rt-bfq/ with Chromium, download the files and install with pacman -U followed by the names of the packages

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//linux-rt-bfq
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.

*** You must disable ramroot before installing:
1) Boot in normal mode answering N at boot prompt
2) Remove ram mode with
ramroot remove
3) Reboot
4) Install the new kernel
5) If you want, you can re-enable ram mode with
ramroot -F enable

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:
audiolinuxBFQcl (headless command line boot)
audiolinuxEXTREMEcl.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. High CPU temperature)
default audiolinuxEXTREME2 (as EXTREME but with an additional kernel parameter for exceptional cpu latency.  Very high CPU temperature)

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