Asset UPnP for Linux instructions - x86, Raspberry Pi

[PeterP]

[size=5]Installing[/size]
Installing is done through the Linux terminal command-line. For headless devices, install 'Putty' then connect to the device to access command-shell.

Do determine which version of Asset is compatible with your system:

uname -m

Possible output:

• i686 : x86 32-bit
• x86_64 : x86 64-bit (x64)
• armv7, aarch64 : ARM (Raspberry Pi)

Create and enter a folder in which Asset will be downloaded an extracted:

mkdir ~/Asset-Install
cd ~/Asset-Install

To simplify the process, all listed download commands produce a file named asset.tar.gz

Downloading Asset, free version:
Execute one of the following, depending on your machine type:

wget https://www.dbpoweramp.com/install/AssetUPnP-Linux-x86.tar.gz -O asset.tar.gz
wget https://www.dbpoweramp.com/install/AssetUPnP-Linux-x64.tar.gz -O asset.tar.gz
wget https://www.dbpoweramp.com/install/Asset-RaspberryPi.tar.gz -O asset.tar.gz

Downloading Asset, registered version, this must be done to a PC using the registration link in your email receipt, or the link presented after purchase. After downloading transfer the install to your device (perhaps by USB flash drive)

Installing:
Extract the downloaded archive with the tar command below - a folder named Asset-<versiondetails> will be created.
Enter the folder and execute INSTALL.sh:

tar xzf asset.tar.gz
cd Asset-*
./INSTALL.sh

Further details will be shown on screen. When finished, Asset will be running and configured to automatically start on system startup.
To access Asset configuration, type the following URL into your web browser:

http://x.x.x.x:45537/

... replacing x.x.x.x with the IP address of your Linux system.
If you don't know the IP address, type ifconfig into terminal and look for IP address under eth0 / inet.

When done, the Asset-Install folder is no longer needed and can be deleted:

rm -rf ~/Asset-Install

[size=5]Upgrading[/size]
Follow the instructions above. The INSTALL.sh script will upgrade from an older version to newer automatically.

Trial and registered versions:
Registered status is always retained when upgrading. If you install a registered version once, you can then update it with trial or beta packages; they will all function as registered.

[size=5]Uninstalling[/size]
Use the included UNINSTALL.sh script. If you've deleted the Asset-Install folder, you can follow the install procedure above with free version of Asset and run UNINSTALL.sh instead of INSTALL.sh

[PeterP]

Addendum

[size=5]Migrating from old installs[/size]
If you have set up Asset to run root crontab through the previous version of this guide:
First, remove Asset from the root crontab:

sudo crontab -l | fgrep -v AssetUPnP > /tmp/crontab-asset.txt
sudo crontab /tmp/crontab-asset.txt
rm /tmp/crontab-asset.txt

Remove the old Asset application files:

sudo rm -rf /usr/bin/asset

The old way of installing left Asset running as root user. The profile data resides in root home folder.
If you wish to retain the old settings, move the old profile to your home folder from root's home folder, and change the owner (chown) from root to your user account:

export MYUSER="$USER"
export MYHOME="$HOME"
su
mv ~/.dBpoweramp "$MYHOME/.dBpoweramp"
chown -R "$MYUSER" "$MYHOME/.dBpoweramp"
exit

Note: you may need to enter root password after su.

Now proceed with the install instructions above.

[PeterP]

[size=5]Storing your Asset profile in another location[/size]

Asset's profile data, by default stored in ~/.dBpoweramp, can grow pretty huge as it stores a cache of all your album covers.

If your home folder is space-restricted, which happens on some embedded systems or NAS boxes, you can have have it stored in another location.

Prior to running Asset, set an environment var _APPDATA_OVERRIDE pointing it to a folder where you want your Asset data stored.
Example:

_APPDATA_OVERRIDE=/path/to/asset/data ./AssetUPnP

or

export _APPDATA_OVERRIDE=/path/to/asset/data
./AssetUPnP

If you're starting Asset on system startup using crontab, insert the environment var before the command that starts Asset:

@reboot _APPDATA_OVERRIDE=/path/to/asset/data /usr/bin/asset/Asset-R6-Linux-x64-registered/bin/AssetUPnP

If you installed Asset using INSTALL.sh, edit your crontab with:

crontab -e