[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74442":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":16,"starSnapshotCount":16,"syncStatus":14,"lastSyncTime":36,"discoverSource":37},74442,"aurral","lklynet\u002Faurral","lklynet","The best in open-source music discovery.","https:\u002F\u002Faurral.org",null,"JavaScript",1085,48,2,12,0,7,14,76,21,81.67,"MIT License",false,"main",[26,27,28,29,30,31,32],"jellyseerr","lastfm","lidarr","music","musicbrainz","overseerr","seerr","2026-06-12 04:01:15","\u003Cdiv align=\"center\" width=\"100%\">\n  \u003Cimg src=\"frontend\u002Fpublic\u002Farralogo.svg\" width=\"128\" height=\"128\" alt=\"Aurral Logo\" \u002F>\n\u003C\u002Fdiv>\n\n# Aurral\n\n[![Docker](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocker-ghcr.io%2Flklynet%2Faurral-blue?logo=docker&logoColor=white)](https:\u002F\u002Fghcr.io\u002Flklynet\u002Faurral) ![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Flklynet\u002Faurral) ![GitHub License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Flklynet\u002Faurral)\n[![Build](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Flklynet\u002Faurral\u002Frelease.yml?branch=main)](https:\u002F\u002Fgithub.com\u002Flklynet\u002Faurral\u002Factions\u002Fworkflows\u002Frelease.yml) ![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1457052417580339285?style=flat) [![Discussions](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002Flklynet\u002Faurral)](https:\u002F\u002Fgithub.com\u002Flklynet\u002Faurral\u002Fdiscussions) ![GitHub Sponsors](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fsponsors\u002Flklynet)\n\nSelf-hosted music discovery, request management, flows, and playlist importing for Lidarr with library-aware recommendations and Navidrome integration.\n\n## Quick Links\n\n- [Docker image](https:\u002F\u002Fghcr.io\u002Flklynet\u002Faurral)\n- [Contributing guide](CONTRIBUTING.md)\n- [Flows and Playlists guide](flows-and-playlists.md)\n- [Spotify import helper](https:\u002F\u002Faurral.org\u002Faurral-convert)\n- [Discord community](https:\u002F\u002Fdiscord.gg\u002FcpPYfgVURJ)\n\n---\n\n## What Aurral Does\n\n- Search for artists via MusicBrainz and add them to Lidarr with granular monitoring behavior\n- Browse your library in a clean UI and jump into artist details quickly\n- Discover artists using your library, tags, trends, and Last.fm data\n- Track requests plus queue, download, and import progress\n- Build scheduled flows and static playlists without writing directly into your main library\n\nAurral is designed to be safe for your collection. Main library changes go through Lidarr's API, while flows and imported playlists write into their own separate downloads area.\n\n---\n\n## Quick Start\n\nCreate a `docker-compose.yml`:\n\n```yaml\nservices:\n  aurral:\n    image: ghcr.io\u002Flklynet\u002Faurral:latest\n    restart: unless-stopped\n    ports:\n      - \"3001:3001\"\n    environment:\n      - DOWNLOAD_FOLDER=${DL_FOLDER:-.\u002Fdata\u002Fdownloads}\n    volumes:\n      - ${DL_FOLDER:-.\u002Fdata\u002Fdownloads}:\u002Fapp\u002Fdownloads\n      - ${STORAGE:-.\u002Fdata}:\u002Fapp\u002Fbackend\u002Fdata\n```\n\nYou can optionally set `DL_FOLDER` and `STORAGE` in a `.env` file next to your compose file. If you leave them unset, Aurral uses `.\u002Fdata\u002Fdownloads` and `.\u002Fdata`.\n\nStart it:\n\n```bash\ndocker compose up -d\n```\n\nOpen `http:\u002F\u002Flocalhost:3001` and complete onboarding.\n\n---\n\n## Flows And Playlists\n\nFlows are dynamic playlists that refresh on a schedule. Playlists are static tracklists imported from JSON or saved from an existing flow.\n\n- Create multiple flows with custom size, source mix, focus filters, and scheduled update days\u002Fhours\n- Export a generated flow to JSON, then re-import it later as a static playlist, or convert it directly in-app\n- Import shared or hand-built JSON playlists\n- Edit imported playlist names and tracklists directly inside the app\n- Use Navidrome to expose the dedicated Aurral flow library and smart playlists\n- Use the built-in Spotify import button or the [Spotify import helper](https:\u002F\u002Faurral.org\u002Faurral-convert) to convert existing Spotify playlists into an Aurral-friendly JSON playlist\n\nRelevant links:\n\n- [Flows and Playlists guide](flows-and-playlists.md)\n- [Spotify import helper](https:\u002F\u002Faurral.org\u002Faurral-convert)\n- [Exportify](https:\u002F\u002Fexportify.net\u002F)\n\n---\n\n## Feature Overview\n\n### Discovery\n\n- Daily Discover recommendations based on your library, tags, and trends\n\n### Lidarr Management\n\n- Add artists with granular monitor options: None, All, Future, Missing, Latest, First\n- Add specific albums from release groups\n- Review request history and queue state from the UI\n\n### Flows\n\n- Multiple scheduled flows with adjustable Discover, Mix, and Trending balance\n- Weekly or custom-day refresh scheduling with per-flow timing\n- Dedicated download output separate from your main music library\n- Optional Navidrome smart playlists in the `Aurral Weekly Flow` library\n\n### Imported Playlists\n\n- Import exported Aurral playlists, single playlist objects, raw track arrays, or multi-playlist bundles\n- Retry the exact imported tracks on failures instead of replacing them\n- Pause or resume retry cycles for incomplete imported playlists\n- Export static playlists back to JSON for sharing\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Requirements And Recommended Stack\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Required\n\n- Lidarr reachable from Aurral\n- Last.fm API key for metadata, images, and recommendation lookups\n- Last.fm or ListenBrainz account if you want listening-history-based discovery\n- MusicBrainz contact email for the required User-Agent policy\n\n### Recommended stack for new users\n\n- Lidarr Nightly\n- Tubifarry\n- slskd\n- Navidrome\n\n### For flows and playlists\n\n- A downloads directory mounted into the container\n- Navidrome if you want library and smart playlist integration\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Screenshots\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"frontend\u002Fimages\u002Fdiscover.webp\" width=\"900\" alt=\"Aurral UI\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"frontend\u002Fimages\u002Frecommended.webp\" width=\"440\" alt=\"Recommendations\" \u002F>\n  \u003Cimg src=\"frontend\u002Fimages\u002Fartist.webp\" width=\"440\" alt=\"Artist details\" \u002F>\n\u003C\u002Fp>\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Data, Volumes, And Safety\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Downloads and flow library\n\nMount a downloads folder for flows, imported playlists, and optional Navidrome integration.\n\n- Container path: `\u002Fapp\u002Fdownloads`\n- Flow output root: `\u002Fapp\u002Fdownloads\u002Faurral-weekly-flow`\n- Typical flow track path: `\u002Fapp\u002Fdownloads\u002Faurral-weekly-flow\u002F\u003Cflow-id>\u002F\u003Cartist>\u002F\u003Calbum>\u002F\u003Ctrack>`\n\n### Main library safety\n\nAurral does not write to your root music folder directly. Main collection changes happen through Lidarr add, monitor, request, and import actions.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Navidrome Setup\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nIf you want flows to appear as a separate library inside Navidrome:\n\n1. In Aurral, go to `Settings -> Integrations -> Navidrome`\n2. Ensure your compose config maps a host folder into `\u002Fapp\u002Fdownloads`\n3. Set `DL_FOLDER` once and use it for both `DOWNLOAD_FOLDER` and the `\u002Fapp\u002Fdownloads` volume\n\nExample:\n\n- `DL_FOLDER=\u002Fdata\u002Fdownloads\u002Ftmp`\n- Volume: `${DL_FOLDER}:\u002Fapp\u002Fdownloads`\n- Env: `DOWNLOAD_FOLDER=${DL_FOLDER}`\n\nAurral will:\n\n- Create a Navidrome library pointing to `\u003CDOWNLOAD_FOLDER>\u002Faurral-weekly-flow`\n- Write smart playlist files (`.nsp`) into the weekly flow library folder\n\nNavidrome should be configured to purge missing tracks so flow rotations do not leave stale entries:\n\n- `ND_SCANNER_PURGEMISSING=always`\n- `ND_SCANNER_PURGEMISSING=full`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Authentication And Reverse Proxy\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Local users\n\nAurral uses local user accounts created during onboarding. Authentication is HTTP Basic Auth at the API layer, so use HTTPS if you expose it publicly.\n\n### Reset forgotten admin password\n\nSet a specific password:\n\n```bash\nnpm run auth:reset-admin-password -- --password \"new-password\"\n```\n\nGenerate a random password:\n\n```bash\nnpm run auth:reset-admin-password -- --generate\n```\n\nThe `--` after `npm run auth:reset-admin-password` tells npm to pass the remaining flags to the reset script.\n\n### Reverse-proxy auth\n\nIf you want SSO, place Aurral behind an auth-aware reverse proxy and forward the authenticated username in a header.\n\n```bash\nAUTH_PROXY_ENABLED=true\nAUTH_PROXY_HEADER=X-Forwarded-User\nAUTH_PROXY_TRUSTED_IPS=10.0.0.1,10.0.0.2\nAUTH_PROXY_ADMIN_USERS=alice,bob\nAUTH_PROXY_ROLE_HEADER=X-Forwarded-Role\nAUTH_PROXY_DEFAULT_ROLE=user\n```\n\n### Trust proxy\n\nIf you are behind a reverse proxy, set:\n\n```bash\nTRUST_PROXY=true\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Environment Variables\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nMost configuration is handled in the web UI, but these environment variables are still important.\n\n| Variable | Purpose | Default |\n|---|---|---|\n| `PORT` | HTTP port | `3001` |\n| `TRUST_PROXY` | Express trust proxy setting (`true`, `false`, or number) | `1` |\n| `DOWNLOAD_FOLDER` | Flow root folder path used for Navidrome library creation | `${DL_FOLDER:-.\u002Fdata\u002Fdownloads}` in the compose example |\n| `PUID` \u002F `PGID` | Run container as this UID and GID when starting as root | `1001` \u002F `1001` |\n| `LIDARR_INSECURE` | Allow invalid TLS certificates | unset |\n| `LIDARR_TIMEOUT_MS` | Lidarr request timeout | `8000` |\n| `SOULSEEK_USERNAME` \u002F `SOULSEEK_PASSWORD` | Optional fixed Soulseek credentials | autogenerated if missing |\n| `AUTH_PROXY_*` | Reverse-proxy auth options | unset |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Notifications\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAurral can send notifications via **Gotify** and **Webhooks** from `Settings -> Notifications`.\n\n### Webhooks\n\nFor each webhook:\n\n- No body sends a `GET` request\n- A body sends a `POST` request with `Content-Type: application\u002Fjson`\n- Custom headers can be added per webhook\n\nBody templates support two variables:\n\n- `$flowPath` for the music directory, empty for discovery updates\n- `$flowName` for the flow or playlist name\n\nExample:\n\n```json\n{\"src\": \"$flowPath\", \"playlist\": \"$flowName\"}\n```\n\nEvent triggers such as Discover updated and Weekly Flow done apply to all configured webhooks and are invoked sequentially in the order they are defined.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Troubleshooting\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- Lidarr connection fails: confirm the Lidarr URL is reachable and the API key is correct in `Settings -> Integrations -> Lidarr`\n- Discovery looks empty: add artists to Lidarr and configure Last.fm, then give the first recommendation refresh a little time\n- MusicBrainz is slow: MusicBrainz is rate-limited and first runs can take longer\n- Flows do not show in Navidrome: verify `DOWNLOAD_FOLDER` matches your host path mapping and Navidrome purge settings\n- Permission errors writing `.\u002Fdata`: set `PUID` and `PGID` to match your host directory ownership\n\n\u003C\u002Fdetails>\n\n---\n\n## Support\n\n- Community and questions: [Discord](https:\u002F\u002Fdiscord.gg\u002FcpPYfgVURJ)\n- Bugs and feature requests: [GitHub Issues](https:\u002F\u002Fgithub.com\u002Flklynet\u002Faurral\u002Fissues)\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Star History\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=lklynet%2Faurral&type=timeline&legend=bottom-right\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=lklynet\u002Faurral&type=timeline&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=lklynet\u002Faurral&type=timeline&legend=top-left\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=lklynet\u002Faurral&type=timeline&legend=top-left\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003C\u002Fdetails>\n","Aurral 是一个用于 Lidarr 的艺术家发现和请求管理工具。它通过集成 MusicBrainz 和 Last.fm 等服务，提供了强大的音乐搜索、添加与监控功能，并支持创建动态播放列表（称为“flows”）及静态播放列表的导入导出。用户可以浏览自己的音乐库，基于标签、趋势和个人喜好发现新艺术家，同时跟踪请求状态以及下载进度。Aurral 适合那些希望在自托管环境中增强音乐收藏管理和发现体验的音乐爱好者使用，特别是已经在使用或计划使用 Lidarr 作为其音乐媒体服务器一部分的人群。","2026-06-11 03:50:08","high_star"]