Updated Raspberry install docs.

docs/src/installation/Raspberry-Pi-32.md

@@ -0,0 +1,123 @@
+# Raspberry Pi install guide
+
+This guide will help you to install `spotifyd` on a Raspberry Pi and have it always running.
+
+## Download
+
+1. Download the latest ARMv6 from <https://github.com/Spotifyd/spotifyd/releases> (use `wget`)
+2. Unzip the file: `tar xzf spotifyd-linux-arm6*`
+You will now see a file called `spotifyd`. You can run it with `./spotifyd --no-daemon`
+The binaries on the download site are all 32 bit binaries, you cannot easily run them on a current 64-bit Raspberry Pi OS.
+Trying to run them will result in 'cannot execute: required file not found'
+To run on a 64 bit Raspberry Pi OS, see `Raspberry-Pi-64.md`.
+
+It is recommended to copy the file to usr/bin, so that everyone can run it or use it for a daemon:
+
+```bash
+sudo cp ./spotifyd /usr/bin
+```
+
+## Systemd daemon file
+
+Create a systemd service file and copy the [default configuration](https://github.com/Spotifyd/spotifyd/blob/master/contrib/spotifyd.service) into it. Change **ExecStart** to where you unzipped the `spotifyd` binary.
+
+```bash
+sudo nano /etc/systemd/system/spotifyd.service
+```
+
+If you want to run as user instead of root or have some `Failed to get D-Bus connection: Connection refused`, you define `spotifyd.service` in your home directory:
+
+```bash
+mkdir -p ~/.config/systemd/user/
+nano ~/.config/systemd/user/spotifyd.service
+systemctl --user daemon-reload
+```
+
+Or in the user diretcory of systemd:
+
+```bash
+sudo nano /etc/systemd/user/spotifyd.service
+```
+
+## Configuring spotifyd
+
+Spotifyd comes pre-configured with defaults that should be working in most cases, but if you want to tweak it further to your needs, have a look at File.md at the [configuration section](../config/) of this book.
+
+## Start the service
+
+As user daemon
+
+```bash
+systemctl --user start spotifyd.service
+```
+
+As system daemon
+
+```bash
+sudo systemctl start spotifyd.service
+```
+
+Now see if you can find it in the normal Spotify client (Devices in right bottom corner). Retry the above steps if you can't find it.
+
+## Starting spotifyd at boot
+
+As system daemon:
+
+```bash
+sudo systemctl enable spotifyd.service
+```
+
+As user daemon is not recommended, it crashes currently with Message: called 'Result::unwrap()' on an 'Err' value: DnsSdError(Os { code: 19, kind: Uncategorized, message: "No such device" }):
+
+```bash
+sudo loginctl enable-linger <username>
+systemctl --user enable spotifyd.service
+```
+
+The first command is required to enable your user to run long-running services. Without it `systemd` would kill the `spotifyd` process as soon as you log out, and only run it when you log in.
+
+Now `spotifyd` is always running on the Pi, so you can use it as a listening device remotely!
+
+## Starting with dbus enabled at boot
+
+If you have dbus enabled, you need to to configure spotifyd to use the system dbus as it can't register services on the session dbus at boot.
+You need to have a config file and configure to use the system dbus, see `Configuring spotifyd`, you can delete everything you don't need to use the standard values. But you need to configure 2 values:
+
+```config
+use_mpris = true
+dbus_type = "system"
+```
+
+In the standard DBus config, no one is allowed to register services on the system dbus, so you need to configure it. Create a configuration file under /usr/share/dbus-1/system.d/, eg. spotifyd-dbus.conf (must end with .conf)
+
+```bash
+sudo nano /usr/share/dbus-1/system.d/spotifyd-dbus.conf
+```
+
+Add the following content:
+
+```content
+<!DOCTYPE busconfig PUBLIC
+ "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
+ "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
+
+<busconfig>
+    <policy user="root">
+        <allow own_prefix="org.mpris.MediaPlayer2.spotifyd"/>
+        <allow send_type="method_call" log="true"/>
+    </policy>
+    <policy context="default">
+    </policy>
+</busconfig>
+```
+
+If you try to run as user, replace root with the user account name.
+
+## Known issues / Logging
+Logging in files is currently not possible for the daemon setup, the daemon crashes without the --no-daemon argument (redirects the output to stdout).
+Without the parameter it tries to output at syslog, but even with syslog installed it crashed.
+To get at least the latest output run
+
+```bash
+sudo systemctl status spotifyd.service
+```

docs/src/installation/Raspberry-Pi-64.md

@@ -0,0 +1,84 @@
+# 64 bit Raspery OS build guide
+
+To run spotifyd on a 64 bit Raspberry Pi OS, you have two possiblities. Compile the 64 bit binary by yourself or add the 32 bit architecture as 
+an additional architecture to your 64 bit Raspberry Pi OS.
+
+Let's start with compiling the 64 bit version, as it offers you more possibilities like adding the DBus feature for controlling the service with
+DBus commands.
+
+## Option 1: Compiling the 64 bit version
+
+### Uninstall the preinstalled rust compiler
+
+spotifyd may require a newer rust toolchain than the one which is delivered with Raspberry Pi OS.
+
+```bash
+sudo apt remove rustc
+```
+
+### Install the rust toolchain
+
+To install the latest rust toolchain, follow the installation instructions on [rustup.rs][rustup].
+
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+Chose simply option 1.
+
+After installation finished, enter
+
+```bash
+source "$HOME/.cargo/env"
+```
+
+### Clone the repository
+
+E.g. in your Downloads Directory. If it does not exist, create it or do it somewhere else.
+
+```bash
+cd /home/user/Downloads
+git clone https://github.com/Spotifyd/spotifyd.git
+```
+
+### Building spotifyd
+
+This takes a while...
+
+```bash
+cd spotifyd
+cargo build --release
+```
+
+This will build a basic version, but you can add additional features like the mentioned DBus or other sound backends by adding additional flags.
+
+E.g. with DBus support
+
+```bash
+cd spotifyd
+cargo build --release --features dbus_mpris
+```
+
+The resulting binary will be placed in `./target/release/spotifyd` and you can run it using `./target/release/spotifyd`.
+Now you can go on with the instructions in `Raspberry-Pi-32.md`, the other instructions are the same once you have the binary running.
+
+## Option 2: Add the 32 bit architecture
+
+### Adding architecture and dependency packages
+
+These commands add the architecture and install the required packages for the architecure:
+
+```bash
+dpkg --add-architecture armhf
+sudo apt update
+sudo apt install libasound2-plugins:armhf
+```
+
+Now you can go on with the instructions in `Raspberry-Pi-32.md`, but download the `armhf-slim.tar.gz` file instead of the armv6 file.
+The other instructions are the same once you have the binary running.
+Downloading other variants like full or default may require further armhf packages to be installed with the command like above:
+
+```bash
+sudo apt install packagename:armhf
+```
+