feat(navidrome): create playlists library when settings save

[lklynet]

Summary

Create the Aurral Playlists library automatically when Navidrome settings are saved, request a library scan, and update setup documentation to reflect the new workflow.

Linked issues

None

Validation

• CI passes
• Tested using the ghcr.io/lklynet/aurral:pr-<number> preview image, or not required
• Upgrade, migration, and rollback notes are updated where applicable

Test plan

• Affected area(s): Navidrome integration, settings, documentation
• Automated coverage: Updated Navidrome settings integration test to verify library creation and connection testing
• Manual steps and expected result: Save Navidrome settings and verify that the Aurral Playlists library is created and a library scan is requested.

Release impact

• Major: incompatible change
• Minor: backward-compatible feature
• Patch: backward-compatible fix
• None: documentation, CI, tests, or internal-only change

Summary by CodeRabbit

• New Features

  • Navidrome settings now automatically create or update smart playlists and trigger a library scan.
  • Aurral now creates the Navidrome library and playlists after connection.

• Documentation

  • Updated Navidrome setup instructions to clarify shared media paths, download paths, and connection requirements.
  • Removed obsolete manual library and scan configuration steps.

[github-actions]

Aurral preview image ready

This image was rebuilt from the latest push to this pull request. It will be replaced when you push another change.

docker pull ghcr.io/lklynet/aurral:pr-548

To test it with your existing Docker Compose setup:

1. Back up your Aurral config.
2. Temporarily change the Aurral service image to ghcr.io/lklynet/aurral:pr-548.
3. Run docker compose pull aurral && docker compose up -d aurral.
4. Exercise the behavior changed by this pull request.
5. Restore the image reference that was configured before testing.

View the preview workflow run · Report a problem

[coderabbitai]

📝 Walkthrough

Walkthrough

Navidrome settings saves now update weekly-flow playlist configuration, create smart playlists, and trigger an immediate library scan. Integration tests now verify library POST requests and structured ping requests. Documentation now describes shared storage mounts, Aurral connection, download-path configuration, and automatic Navidrome library and playlist setup.

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.tests/auth/navidrome-settings.int.test.js:
- Around line 53-62: Update the mock request handling and assertions around the
library creation flow to capture and parse the POST body, return the expected
successful library-creation response, and verify the request uses the “Aurral
Playlists” library name and configured path. Keep the existing login and GET
/api/library behavior unchanged.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 297ab33c-d68a-4339-9fa6-2e6fe2a40c54

📥 Commits

Reviewing files that changed from the base of the PR and between 99fffdf and b5bc463.

📒 Files selected for processing (4)

• .tests/auth/navidrome-settings.int.test.js
• backend/routes/settings/handlers/general.js
• docs/src/content/docs/getting-started/storage.mdx
• docs/src/content/docs/integrations/navidrome.mdx

[github-actions]

Included in stable release 2.1.0

This change is included in the Aurral 2.1.0 release.

docker pull ghcr.io/lklynet/aurral:2.1.0

View the release