Repository navigation
3.0.0 is the biggest Aurral release yet. You can see what your friends are playing and make Blends with them, publish playlists to Community, and open your Aurral from any browser at music.aurral.org. There's also a full screen player with lyrics, daily mixes and a Playlists page to browse, plugins, a Logs page, and a new navigation. Under the hood, Aurral runs its background work on its own job queue, playlists point at your Library instead of keeping their own copies, and media servers pick up playlists from files instead of API syncing. It also idles lighter than 2.13.
Please update before December 1. That's when the Last.fm API starts needing Last.fm Pro, and 2.x uses it for discovery and Wrapped wherever a key is set. 3.0 drops Last.fm. Every install gets the same discovery, and Wrapped builds from your plays in Aurral, ListenBrainz, and Koito.
Upgrading from 2.x
- Aurral 3 opens databases that finished upgrading on 2.x. If yours is older, Aurral 3 stops without changing anything and tells you so. Start
ghcr.io/lklynet/aurral:2once with the same/config, wait a few minutes, then switch back. - Mount your data at
/config. If the database is only in/app/backend/data, Aurral 3 stops and asks you to move the mount. - On first start, Aurral 3 saves your database as
aurral.pre-job-queue.dbin/config. To go back to 2.x, follow Roll back to Aurral 2. Changes made in 3 are lost. AUTH_USERandAUTH_PASSWORDare no longer read. Manage accounts in Settings > Users. If you're locked out, reset the admin password.DOWNLOAD_FOLDERis nowLIBRARY_FOLDER. The old name still works with a warning.- Aurral runs every Library now, and Lidarr mode is gone. If Lidarr ran yours, Aurral takes it over on first start. It saves your database as
aurral.pre-lidarr-conversion.db, turns Lidarr's folders into read-only folders it plays but never changes, and brings your artists and albums over unmonitored, so nothing starts downloading. The first admin to open Aurral sees a report with Set up Lidarr plugin, which brings back downloads through Lidarr with your old connection. See Lidarr. - Last.fm is gone. On upgrade, Aurral removes saved Last.fm keys, scrobbling connections, and Last.fm usernames, and rebuilds discovery once. Your Last.fm history no longer shapes recommendations or Wrapped, unless you connect Last.fm in your ListenBrainz settings. Last.fm station imports still work. Remove
LASTFM_API_KEYandLASTFM_API_SECRET. See Coming from Last.fm. TICKETMASTER_API_KEYandCONTACT_EMAILstill work with a warning. Save the Ticketmaster key in Settings > Discovery, then remove both. A future release stops reading them.LIDARR_URLandLIDARR_API_KEYare only read by the Lidarr takeover, andLIDARR_TIMEOUT_MSis gone.- Gotify is a webhook now. A saved Gotify setup moves to Settings > Notifications with the same events.
- Aurral no longer syncs playlists to Navidrome, Plex, or Jellyfin through their APIs. On upgrade it deletes the playlists it made there, then writes an M3U file for every flow and playlist to
_playlistsin the Library folder. Navidrome and Jellyfin import those on their own, and Aurral sends them to Plex once you connect it in Settings > Listening > Plex. If Navidrome shows a playlist twice, delete the older copy there once. - Local network auto-login only works for devices that connect straight to Aurral. A request through a reverse proxy or tunnel, or from the Docker host in bridge networking, now asks for sign-in.
AUTH_PROXY_TRUSTED_IPSnow has to list the address your proxy connects to Aurral from. An address further back inX-Forwarded-Forno longer counts.- Requests from another website never sign in through auto-login or proxy auth.
- Sign in with Plex is gone. Users who used it can sign in with a password, Google, or SSO. An admin can set their password in Settings > Users.
- The app API is now version 2. Apps built for version 1 need an update. See the app API contract.
- Without
TRUST_PROXY, Aurral only readsX-Forwarded-Forfrom a proxy on a loopback or private address. If your proxy reaches Aurral from a public address, setTRUST_PROXYto that address, or every client shares one sign-in rate limit. - Settings > Profile now lists every device signed in during the last 30 days, so expect a long list at first. The ones you stop using expire on their own.
What's new
- Friends shows what people on your server are playing, their top plays from the last 30 days, and their most played tracks as a playlist you can save. Link an aurral.org account in Settings > Profile with GitHub or Discord to add friends on other servers by handle. Requests land in your Inbox. Subsonic apps show up in Friends too. See Friends.
- Blends mix your listening with someone on your server or an aurral.org friend, using tracks in your Library. Made for you shows Blends with up to 3 people, the ones you share the most artists with.
- Make any playlist Public from its menu and it shows under Community on Discover with your handle. Anyone can save a copy that stays in sync.
- Add Collaborators to a playlist to build it with people on your server. It shows who added each track.
- music.aurral.org opens your Aurral from any browser at one address, and switches between servers if you have more than one. Choose Open in Settings > Profile to start. Your server needs an HTTPS address. See music.aurral.org.
- Pair a device in Settings > Profile gives you a one-time code to sign in another browser or app, and the list below it signs out any device. You stay signed in while you keep using Aurral.
- A full screen player with lyrics, the queue, and a visualizer. Open it from the player bar or press F. Queue, Lyrics, and Friends share a panel on the right that stays open while you browse. The player also docks, minimizes to the sidebar, shows synced lyrics, levels loud tracks, and has stop and favorite buttons.
- Discovery works the same on every install, with no keys. Similar artists come from Deezer, which stays in an artist's genre far better than ListenBrainz, and from ListenBrainz when Deezer doesn't know them. Top tracks and trending come from Deezer, and the release calendar from ListenBrainz.
- Once your own history fills Discover, the chart picks new users start with go away.
- Start radio from any track, album, or artist, and autoplay keeps going with similar music when the queue ends. Radio matches each track's own genres now, not its artist's broad ones.
- Your queue follows you. Pause on one device and pick up on another, including Subsonic clients like Feishin and Symfonium.
- Your mixes on Library home builds Daily Mixes, On Repeat, Rewind, Rediscover, and more from your plays each day. Made for you sits on Discover, and the Playlists page lets you browse by genre, mood, and decade. Nothing downloads until you save one.
- Plugins add menu actions, events, download sources, playlist imports, and schedules without putting them in core. Install them in Settings > Plugins. See Plugins.
- Settings > Status > Logs shows what went wrong and groups repeated problems. Copy problems gives you something to paste into an issue, and there's a prompt you can hand to an agent to triage your logs.
- The new navigation is the default. Each section gets tabs in the top bar, and the sidebar lists your playlists and flows. Legacy navigation in Settings > Appearance brings back the old one for now.
- Static playlists now point at tracks in your Library instead of owning their own downloads. A track in three playlists is one file.
- qBittorrent is a new download source. It searches your torrent indexers in Prowlarr, and torrents keep seeding after Aurral copies the audio.
- Import M3U playlists and Spotify Liked Songs like any other playlist. Tracks you already own reuse their files. Navidrome favorites can come in too, and favorites now shape recommendations.
- Search finds songs by name and your playlists.
- Album pages are one page whether you own the album or not. Multi-disc albums show disc headings and disc titles from MusicBrainz, which Subsonic clients get too.
- Tracks keep their featured artists, and downloads are tagged with genres. Featured artists missing from existing tracks come back from their tags on upgrade.
- Every user gets their own API key in Settings > Profile > API access.
- Webhooks pick their own events, and there are new events for added artists and tracks.
- Admins set Default permissions for new users in Settings > Users.
- Flow tracks no longer wait in review. Aurral drops a file it can't verify and tries the next one.
- Every Library track has Re-search > Manual. Keep this file is gone. Tracks marked with it become unmonitored, which also stops upgrades.
- Add a cookies file for yt-dlp to get past YouTube's bot check.
- Hide YouTube videos on artist pages from Settings > Appearance. The Blocklist moved to Settings > Listening.
- The installed app feels native on iPhone.
Fixes worth noticing
- Soulseek searches no longer throw away their results or get stuck behind searches Aurral already dropped.
- Large BrainzMash albums finish downloading instead of retrying forever.
- Tracks with no known length no longer pile up in review.
- Album downloads show every track in Activity and one History row.
- Adding hundreds of albums at once no longer fails most of them.
- Release-day downloads start within the hour.
- Tidarr downloads each album once instead of once per quality.
- Albums with more than 100 tracks show every track right away.
- The Library loads up to 5x faster on slow connections.
- Open tabs reload after a server update instead of breaking.
- Long playlist queues no longer freeze the server.
- MP3s with a tag Aurral couldn't save get tagged now.
- Finished plugin runners no longer pile up as zombie processes in Docker.
- An artist or album BrainzMash holds back for hours loads from a fallback server instead of failing until the wait ends.
- Albums BrainzMash returns without any editions can still be added and downloaded.
- New releases show their covers right away instead of waiting on the Cover Art Archive.
- Various Artists compilations stay out of recent and upcoming releases.
- Long Ogg files show their real length.
- Subsonic clients with a bitrate limit get Opus files as they are when they fit, instead of a bigger MP3.
Things to try
- Press F while something plays.
- Open Your mixes on Library home after a day of listening.
- Open Friends in the panel on the right and see who's listening.
- Open music.aurral.org from Settings > Profile on your phone.
- Look at Settings > Status > Logs.
- Start radio from an artist you love.
Full change list
The full change list from 2.13.0 to 3.0.0 includes every pull request and fix.