fix(aurral): apply the download_folder option (#3098)

The download_folder option was never read: the Dockerfile set fixed
DOWNLOAD_FOLDER and WEEKLY_FLOW_FOLDER values. Aurral reads
WEEKLY_FLOW_FOLDER as a deprecated alias that takes precedence over
DOWNLOAD_FOLDER, so downloads always went to
/share/aurral/downloads/weekly-flow. The entrypoint now exports
DOWNLOAD_FOLDER from the option and unsets WEEKLY_FLOW_FOLDER.

Co-authored-by: Paal <paal@Paals-MacBook-Pro-3.local>

aurral/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 2.10.0.1 (03-10-2026)
+- Apply the `download_folder` option; it was ignored and downloads always went to `/share/aurral/downloads/weekly-flow`
+- Stop setting `WEEKLY_FLOW_FOLDER`, which Aurral reads as a deprecated alias that overrides `DOWNLOAD_FOLDER`. Flows go to a subfolder of the download folder; `weekly_flow_folder` has no effect
+- `download_folder` can also point into `/media`
+
  
 ## 2.10.0 (2026-09-24)
 - Update to latest version from lklynet/aurral (changelog : https://github.com/lklynet/aurral/releases)

aurral/Dockerfile

@@ -16,8 +16,7 @@ LABEL \
     io.hass.version="${BUILD_VERSION}" \
     maintainer="petruknw"
 
-ENV DOWNLOAD_FOLDER=/share/aurral/downloads \
-    WEEKLY_FLOW_FOLDER=/share/aurral/downloads/weekly-flow
+ENV DOWNLOAD_FOLDER=/share/aurral/downloads
 
 # 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.

aurral/README.md

@@ -7,8 +7,8 @@ This addon is based on the docker image <https://github.com/lklynet/aurral>
 
 | Option | Default | Description |
 |---|---|---|
-| `download_folder` | `/share/aurral/downloads` | Path where Aurral writes flow downloads. Must be under `/share`. |
-| `weekly_flow_folder` | `weekly-flow` | Subfolder name appended to `download_folder` for weekly flow files. The full path will be `download_folder/weekly_flow_folder`. |
+| `download_folder` | `/share/aurral/downloads` | Path where Aurral writes its downloads, including flows (in a subfolder). Can be under `/share` or `/media`. |
+| `weekly_flow_folder` | `weekly-flow` | No effect: Aurral keeps flows in its own subfolder of `download_folder`. Kept for compatibility. |
 
 ## Installation
 
@@ -19,7 +19,6 @@ This addon is based on the docker image <https://github.com/lklynet/aurral>
 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. Optionally set `weekly_flow_folder` to customise the weekly flow subfolder name.
 6. Start the add-on.
 7. Check the logs of the add-on to see if everything went well.
 8. Open the webUI and complete onboarding.

aurral/config.yaml

@@ -1,5 +1,5 @@
 name: Aurral
-version: "2.10.0"
+version: "2.10.0.1"
 slug: aurral
 description: >-
   Self-hosted music discovery, request management, flows, and playlist

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

@@ -1,8 +1,20 @@
 #!/bin/sh
 set -e
 
+# Use the download_folder option. The Dockerfile only sets a default
+OPTIONS=/data/options.json
+if [ -f "$OPTIONS" ]; then
+    folder=$(node -e 'const o = require(process.argv[1]); process.stdout.write(o.download_folder || "")' "$OPTIONS")
+    if [ -n "$folder" ]; then
+        export DOWNLOAD_FOLDER="$folder"
+    fi
+fi
+
+# Aurral reads WEEKLY_FLOW_FOLDER as a deprecated alias for DOWNLOAD_FOLDER that
+# takes precedence over it, so it must not be set. Flows go to a subfolder of
+# the download folder
+unset WEEKLY_FLOW_FOLDER
+
 mkdir -p /config/data
 mkdir -p "${DOWNLOAD_FOLDER}"
-mkdir -p "${WEEKLY_FLOW_FOLDER}"
-
 exec "$@"