PRICES

Audiolinux lxqt 1 year support with image            $ 59
Audiolinux headless 1 year support with image        $ 59
Audiolinux Raspberry 1 year support with image*      $ 59
Audiolinux lxqt unlimited time support               $ 119
Audiolinux headless unlimited time support           $ 119
Audiolinux all versions unlimited time support**     $ 219
Audiolinux USB stick/SD card with shipping           $ 119
Audiolinux extra year of support                     $ 30
Audiolinux upgrade to version 2.x/4.x                $ 30
Audiolinux additional image***                       $ 30
Audiolinux 10 licenses (with discount) -> contact support

* Both images for Pi3 and Pi4
** You can download headless, lxqt, Raspberry Pi3/Pi4
*** If you have one image and you want another.
For example if you already have lxqt and you want headless

* In the last versions Audiolinux has 7 configuration menus and most of what is reported below can be made directly with menus

--> 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.)

PASSWORDS

user, ssh, NoMachine: audiolinux
sudo, 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

RAM MODE

Ramroot option is the last that should be enabled once your system is fully configured. It is recommended at least 16GB RAM for lxqt version (8 GB for AudioLinux headless)

Before enabling ramroot you should edit as root the file /etc/ramroot.conf For example, if you have 16000 MB total RAM, you could give 4000 to RAM memory and 12000 to ZRAM

To load the entire system at boot, type (as root)
ramroot -E
To disable ramroot
ramroot -D

--> 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 the command ramsave This command will save the system when in ram mode (otherwise all changes will be lost)

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

REMOTE CONNECTION

* In audiolinux lxqt you can connect to graphical Desktop with NoMachine, if you install it in Windows, Linux, smartphone. With NoMachine remote Desktop 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.

* From Audiolinux menu 214 new Web Interface at ipaddress://5001touch screen compatible and with search function.
To install it go to INSTALL menu and select 0 "Install new web interface 2 (beta)"
You can enable/disable it in EXPERT menu selecting 10 "WEB INTERFACE 2 enable/disable"
Search function is very useful: typing main, audio, system, update or expert you can see on the left column the options of classic menu.

You can also connect remotely with a browser at the address http://ipaddress:8500

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

Audiolinuxm has an automatic configuration that will permit to connect immediately after the first boot
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/auto.network from

[Match]
Name=en*

[Network]
DHCP=yes

to

[Match]
Name=enp3s0

[Network]
DHCP=yes

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/auto.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

--> change Address, Gateway and DNS to your preferred values.

For WiFi, provided that your adapter is recognized by linux, a simple how-to can be found here
The relevant wiki section is here:
https://wiki.archlinux.org/index.php/Systemd-networkd#Wireless_adapter
For wpa-supplicant:
https://wiki.archlinux.org/index.php/WPA_supplicant

AUDIO AND OTHER SERVICES

* In audiolinux lxqt MPD, LMS, squeezelite and Spotify (spotifyd) are already installed.

In audiolinux headless Roon and HQPlayer embedded are already installed.
The new Menu is already prepared for MPD, LMS, Squeezelite and Spotify. 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."

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.)
yay -S name-of-application
Example for updating hqplayerd and roon:
yay -S hqplayer-embedded roonserver roonbridge

For updating the system (expert users)
yay -Syu

For system modification and system update you must boot in normal mode answering N to ramroot boot prompt.

OTHER AUDIO APPLICATIONS

* In audiolinux lxqt mpd, logitechmediaserver, Squeezelite and Spotify are already installed

In headless last versions you have the option to install these packages from update menu

Squeezelite + LMS installation:
pamac build logitechmediaserver-git squeezelite-git
Configuration file for squeezelite: /etc/squeezelite.conf
For listing available devices:
squeezelite -l
The systemd service can be started with
systemctl start squeezelite

MPD and UPnP installation:
pamac build mpd upmpdcli
Configuration file for MPD: /home/audiolinux/.mpdconf
The systemd service can be started with
systemctl start my-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

In the last versions you can update kernel from audiolinux update menu

Installing new audiolinux realtime kernel.
Go to https://www.audio-linux.com/ftp/packages/kernel/last//linux-rt-bfq and download at least linux-rt-bfq-* and linux-rt-bfq-headers-*
After install the new kernel with pacman -U followed by the names of the packages.

*** If you are running in ram mode, reboot answering N at boot prompt to boot in normal mode.
-> If you cannot connect to a monitor/keyboard you must disable ramroot before updating the kernel:
1) DISABLE ramroot with
ramroot -D
2) Reboot
3) Install the new kernel
4) Reboot
5) Eventually re-enable it with
ramroot -E
6) Reboot

REALTIME PRIORITY

For testing:
Type
rttest

For checking realtime status:
rtstatus

Manual realtime priority is controlled by rtirq and rtapp. In standard /etc/rtirq.conf priority is given to usb xhci devices:
RTIRQ_NAME_LIST="xhci"
Change xhci to snd if you are using an internal audio card

Suggested realtime configurations:

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

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

Max possible priority is set system-wide at 98. Higher priorit will increase the CPU load.

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