Merge pull request #2723 from petruknw/master

Add Aurral addon (v1.76.17)

.github/addon_submitters.json

@@ -1,4 +1,5 @@
 {
+  "aurral": "petruknw",
   "cleanuparr": "PierreNa",
   "gitea": "baldarn",
   "kometa": "akrigator",

aurral/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 1.76.17
+
+- Initial release

aurral/Dockerfile

@@ -0,0 +1,32 @@
+# ==============================================================
+# Home Assistant Add-on: Aurral
+# Wraps the upstream ghcr.io/lklynet/aurral image.
+# ==============================================================
+ARG BUILD_FROM
+FROM ${BUILD_FROM}
+
+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"
+
+ENV DOWNLOAD_FOLDER=/share/aurral/downloads \
+    WEEKLY_FLOW_FOLDER=/share/aurral/downloads/weekly-flow
+
+# Replace the upstream data/downloads dirs with symlinks into HA persistent storage.
+# Must be done at build time — the dirs are owned by a non-root user at runtime.
+RUN rm -rf /app/backend/data && ln -s /config/data /app/backend/data \
+ && rm -rf /app/downloads && ln -s /share/aurral/downloads /app/downloads
+
+COPY rootfs /
+
+RUN chmod a+x /usr/local/bin/docker-entrypoint.sh
+
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
+CMD ["node", "server.js"]

aurral/README.md

@@ -0,0 +1,23 @@
+# 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`. |
+
+## Installation
+
+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` option to your preferred path.
+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,22 @@
+#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,
+  /config/aurral/** 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:1.76.17",
+    "amd64": "ghcr.io/lklynet/aurral:1.76.17"
+  },
+  "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,35 @@
+name: Aurral
+version: "1.76.17"
+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
+
+init: false
+
+ports:
+  3001/tcp: 3001
+ports_description:
+  3001/tcp: Aurral Web UI
+
+webui: http://[HOST]:[PORT:3001]
+
+map:
+  - addon_config:rw
+  - share:rw
+  - media:rw
+
+env_vars:
+  - name: WEEKLY_FLOW_FOLDER
+    description: "Path for Navidrome smart playlist files (weekly flow)"
+    required: false
+
+options:
+  download_folder: /share/aurral/downloads
+
+schema:
+  download_folder: str

aurral/rootfs/usr/local/bin/docker-entrypoint.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+set -e
+
+# Create the real directories in HA persistent storage that the symlinks point to
+mkdir -p /config/data
+mkdir -p "${DOWNLOAD_FOLDER:-/share/aurral/downloads}"
+mkdir -p "${WEEKLY_FLOW_FOLDER:-/share/aurral/downloads/weekly-flow}"
+
+exec "$@"

aurral/updater.json

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