Merge pull request #1 from petruknw/feat/aurral-addon

Add Aurral Home Assistant addon

aurral/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.76.12-1
+
+- Initial Home Assistant add-on release
+- Wraps upstream `ghcr.io/lklynet/aurral:v1.76.12`
+- Exposes `download_folder` and `data_folder` as configurable paths in the add-on UI
+- Supports HA Ingress (sidebar access without port forwarding)
+- Supports amd64 and aarch64

aurral/Dockerfile

@@ -0,0 +1,20 @@
+# ==============================================================
+# Home Assistant Add-on: Aurral
+# Wraps the upstream ghcr.io/lklynet/aurral image.
+# ==============================================================
+FROM ghcr.io/lklynet/aurral:latest
+
+ARG BUILD_VERSION
+ARG BUILD_ARCH
+
+LABEL \
+    io.hass.name="Aurral" \
+    io.hass.description="Self-hosted music discovery and request management for Lidarr" \
+    io.hass.arch="${BUILD_ARCH}" \
+    io.hass.type="addon" \
+    io.hass.version="${BUILD_VERSION}" \
+    maintainer="petruknw"
+
+COPY rootfs /
+
+RUN chmod a+x /etc/services.d/aurral/run

aurral/README.md

@@ -0,0 +1,28 @@
+# Aurral
+
+[Aurral](https://github.com/lklynet/aurral) is a self-hosted music discovery, request management, flows, and playlist importing app for Lidarr with library-aware recommendations.
+This addon is based on the docker image https://github.com/lklynet/aurral
+
+## Configuration
+
+| Option | Default | Description |
+|---|---|---|
+| `download_folder` | `/share/aurral/downloads` | Path where Aurral writes flow downloads. Must be under `/share`. |
+| `data_folder` | `/share/aurral/data` | Path for Aurral's database and persistent config. Must be under `/share`. |
+
+## Installation
+
+---
+
+The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.
+
+1. Add my add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA)
+
+[![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons)
+
+2. Install this add-on.
+3. Click the `Save` button to store your configuration.
+4. Set the `download_folder` and `data_folder` options to your preferred paths.
+5. Start the add-on.
+6. Check the logs of the add-on to see if everything went well.
+7. Open the webUI and complete onboarding.

aurral/apparmor.txt

@@ -0,0 +1,21 @@
+#include <tunables/global>
+
+profile aurral flags=(attach_disconnected,mediate_deleted) {
+  #include <abstractions/base>
+
+  file,
+  signal (send) set=(kill,term,int,hup,cont),
+
+  /init ix,
+  /bin/** ix,
+  /usr/bin/** ix,
+  /usr/local/bin/** ix,
+  /run/{s6,s6-rc*,fix-attrs.d}/** ix,
+
+  /share/aurral/** rwk,
+  /media/** rk,
+  /app/** rwk,
+
+  deny /proc/*/net/if_inet6 r,
+  deny /proc/*/net/ipv6_route r,
+}

aurral/build.json

@@ -0,0 +1,15 @@
+{
+  "build_from": {
+    "aarch64": "ghcr.io/lklynet/aurral:latest",
+    "amd64": "ghcr.io/lklynet/aurral:latest"
+  },
+  "squash": false,
+  "labels": {
+    "io.hass.name": "Aurral",
+    "io.hass.description": "Self-hosted music discovery and request management for Lidarr",
+    "io.hass.arch": "{arch}",
+    "io.hass.type": "addon",
+    "io.hass.version": "dev",
+    "maintainer": "petruknw"
+  }
+}

aurral/config.yaml

@@ -0,0 +1,42 @@
+name: Aurral
+version: "1.76.12-1"
+slug: aurral
+description: >-
+  Self-hosted music discovery, request management, flows, and playlist
+  importing for Lidarr with library-aware recommendations.
+url: https://github.com/alexbelgium/hassio-addons/blob/master/aurral/README.md
+arch:
+  - aarch64
+  - amd64
+
+image: ghcr.io/lklynet/aurral
+
+init: false
+
+ports:
+  3001/tcp: 3001
+ports_description:
+  3001/tcp: Aurral Web UI
+
+webui: http://[HOST]:[PORT:3001]
+
+ingress: true
+ingress_port: 3001
+ingress_stream: false
+
+map:
+  - addon_config:rw
+  - share:rw
+  - media:rw
+
+options:
+  download_folder: /share/aurral/downloads
+  data_folder: /share/aurral/data
+
+schema:
+  download_folder: str
+  data_folder: str
+  port: int?
+
+panel_icon: mdi:music-box-multiple
+panel_title: Aurral

aurral/rootfs/etc/services.d/aurral/run

@@ -0,0 +1,23 @@
+#!/usr/bin/with-contenv bashio
+# ==============================================================
+# Start Aurral with configuration from HA add-on options.
+# ==============================================================
+
+DOWNLOAD_FOLDER=$(bashio::config 'download_folder')
+DATA_FOLDER=$(bashio::config 'data_folder')
+
+# Ensure host-side directories exist
+mkdir -p "${DOWNLOAD_FOLDER}" "${DATA_FOLDER}"
+
+# Symlink HA share paths into the locations Aurral expects internally
+rm -rf /app/downloads
+ln -sf "${DOWNLOAD_FOLDER}" /app/downloads
+
+rm -rf /app/backend/data
+ln -sf "${DATA_FOLDER}" /app/backend/data
+
+bashio::log.info "Starting Aurral"
+bashio::log.info "  Downloads : ${DOWNLOAD_FOLDER}"
+bashio::log.info "  Data      : ${DATA_FOLDER}"
+
+exec node /app/backend/server.js

aurral/updater.json

@@ -0,0 +1,8 @@
+{
+  "last_update": "20-05-2026",
+  "repository": "alexbelgium/hassio-addons",
+  "slug": "aurral",
+  "source": "github",
+  "upstream_repo": "lklynet/aurral",
+  "upstream_version": "1.76.12"
+}