Guides on Aether

Libraries

Mon, 01 Jan 0001 00:00:00 +0000

Libraries#

A library is what you browse: a named, saved filter over everything that was scanned — not a directory. The same album can sit in several libraries, and deleting a library never deletes music. Subsonic apps see each library as a music folder.

Create one under Settings → Libraries → Add library. Besides a name and an icon, a library sets:

which views it offers — Discover, Artists, Albums — and the one it opens on;
whether the sidebar gives it one entry or one per view;
whether its artists are hidden from the main Artists page;
up to 20 filters.

The library dialog: views, sidebar entries and filters, with the live match count

Filters#

Filter	Matches tracks…
Scan folder	indexed under one of the chosen scan folders
Folder path	stored under one of the chosen directories
File format	with one of the chosen extensions (`flac`, `mp3`, …)
Release type	on an album of one of the chosen types; “(none)” means untyped albums
Compilation	on a compilation album (Yes) or on any other album (No)
Genre	tagged with one of the chosen genres

A track must pass every filter; within one filter, any of its values is enough. A library without filters is the whole catalog. While you edit, the dialog shows how many tracks and albums the filters match.

Connecting apps

Mon, 01 Jan 0001 00:00:00 +0000

Connecting apps#

Aether speaks the OpenSubsonic API, so any Subsonic or OpenSubsonic app can use it — Symfonium, DSub, play:Sub and many more. In the app, enter your server’s address, e.g. https://music.example.com or http://192.168.1.10:8075, and the credentials below.

Credentials#

With authentication off (Auth.Method: none), the API asks for nothing: any username and password work.

With authentication on, your own password never works in an app. Each app gets its own credentials instead, so you can revoke one without touching the others. Open User settings → Connected apps from your account menu:

Authentication

Mon, 01 Jan 0001 00:00:00 +0000

Authentication#

Auth.Method in the config picks one of three modes:

Method	Who signs you in
`none`	nobody — no users, no login. Trusted networks only. The default.
`native`	Aether: users live in its database and it shows its own login page
`proxy-header`	your reverse proxy (Authelia, Authentik, oauth2-proxy), which passes the user on in headers

In both authenticated modes, users are either admins or regular users. Admins get Settings — libraries, tasks, users — and the metadata editor; everyone gets their own playlists, stars, play queue and history. Apps never use the login password, see Connecting apps.