Repolode
lklynet

lklynet/aurral

Self-hosted music discovery app with its own music library, recommendations, and playlist flows, with Lidarr as an optional add-on.

Open-source alternative to:SpotifyLast.fm

Stars
1,902
Forks
102
Open issues
30
Last commit
20 hours ago

What is it?

Aurral is a self-hosted music discovery app. It provides personal recommendations, trends, new and upcoming releases, artist news, and nearby shows, and it manages its own music library. Lidarr can be connected to manage the library, but it is optional.

The app covers the full path from discovery to playback. Users can search artists and albums, add them to Aurral or Lidarr, and monitor artists for new releases. Scheduled playlist flows can be created, and playlists can be imported from Spotify, YouTube Music, Last.fm, or ListenBrainz. Downloads run through yt-dlp, slskd, Usenet, or deemix, and the activity view tracks queues and history.

Aurral supports multiple users with separate profiles, permissions, and sign-in methods including local passwords, reverse-proxy SSO, OIDC, Google, and Plex. Music can be played in the browser, served to Subsonic-compatible players, or published to Navidrome, Plex, and Jellyfin.

Key features

  • 01Personal recommendations, trends, and new or upcoming release feeds
  • 02Search for artists and albums and add them to Aurral or Lidarr
  • 03Scheduled playlist flows with imports from Spotify, YouTube Music, Last.fm, and ListenBrainz
  • 04Downloads via yt-dlp, slskd, Usenet, and deemix with queue and history views
  • 05Multi-user profiles with local, OIDC, Google, and Plex sign-in

Use cases

  • Running a home music server that discovers new artists for a household
  • Automatically tracking favorite artists and downloading their new albums
  • Publishing curated playlists to Navidrome, Plex, or Jellyfin
  • Sharing albums or tracks with friends through links

Quick start

  1. 1

    Create a docker-compose.yml file with the Aurral service

  2. 2

    Start Aurral in the background

    docker compose up -d
  3. 3

    Open http://localhost:3001 and create your admin account

Things to know

  • Media volume mounts must be set up carefully so Aurral, Lidarr, download clients and your playback server share the same paths.
  • Nightly image builds can be less stable than releases.

In collections

Topics

#music#self-hosted#music-discovery#recommendations#lidarr#playlists#docker#typescript#jellyseerr#lastfm

FAQ

What is aurral?
Self-hosted music discovery app with its own music library, recommendations, and playlist flows, with Lidarr as an optional add-on. Aurral is a self-hosted music discovery app. It provides personal recommendations, trends, new and upcoming releases, artist news, and nearby shows, and it manages its own music library. Lidarr can be connected to manage the library, but it is optional.
Is aurral free to use? What license does it have?
aurral is open source under the MIT license. Check the license terms before using it in commercial products.
Is aurral still maintained?
Actively maintained. The last commit to aurral was on Nov 6, 2026.
What can I use aurral for?
Running a home music server that discovers new artists for a household Automatically tracking favorite artists and downloading their new albums Publishing curated playlists to Navidrome, Plex, or Jellyfin Sharing albums or tracks with friends through links
How do I install aurral?
Create a docker-compose.yml file with the Aurral service Start Aurral in the background: docker compose up -d Open http://localhost:3001 and create your admin account
Where can I get aurral?
The source code and installation instructions are on GitHub: https://github.com/lklynet/aurral

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects