GLOSSA LISTEN SERVER · PART 3

Administer a Glossa Listen server

Applies to Glossa Listen v1.0.0

Use these tools to manage the shared library, listener accounts, integrations, and server data. For installation and everyday listening, see the setup guide and standard-use guide.

Manage accounts and access

Open Administration → Users & access to create accounts and QR invitations, reset passwords, unlock accounts, change roles, and remove users. Use tag access controls to decide which audiobooks each listener can browse and play. Account deletion also removes that user's collections and playback history.

Set the Public Listen URL before sending invitations or password-reset links.

Configure email

Open Administration → Email to configure SMTP for invitations and password resets. Enter the mail host, port, encryption mode, sender, and credentials if needed. Send a test message before depending on delivery. A saved password is not displayed again.

Upload and maintain books

Use Audiobooks → Upload audiobook for one audio file, grouped chapter files in the same format, an MP3 chapter ZIP, or a book folder. Confirm chapter order before upload. Folder uploads use a named cover when available and skip hidden sidecar files and extra artwork.

Enter details manually or search Open Library and AudioSilo Meta by ISBN or title and author. Review each match before applying it. Administrators can edit metadata, covers, and tags later. Tags also control listener access.

Manage series and badges

Assign books to a series and set each book's position to define listening order. Series can have a description, square cover, wide web background, and portrait mobile artwork. Create series progress badges from the series page. Use Administration → Badges for server-wide book, series, or series-filter achievements.

Manage podcasts

Use Podcasts → Find podcasts to search Podcast Index, add a show, and download episodes. If the credentials panel is empty, configure a Podcast Index API key and secret there. Administrators can upload episodes to a show and remove shows or episodes. The separate Podcast Index setup guide covers credentials.

Pair servers

In Administration → Paired servers, create a source token with stream-only or read-only sync access. Restrict the books, series, and badges the token can expose. Connect from the receiving server using the source HTTPS URL and token. Stream-only content stays on its source; read-only sync can copy approved content. Removing a pairing does not delete copies already made.

Review automatic imports

Glossa Listen scans /data/import every 30 seconds and waits for files to remain unchanged for 60 seconds. Add one complete audiobook or one folder per book. Embedded metadata is used when it identifies a title; otherwise only one exact AudioSilo title-and-author match is imported automatically. Ambiguous or incomplete items wait in Administration → Auto import → Needs review. Source files stay in the inbox after import; remove them when no longer needed.

Back up and restore the library

Administration → Backups provides local snapshots and optional S3-compatible storage. Backups include database, user data, audiobooks, podcast downloads, and artwork. SHA-256 checks verify chunks; optional backup passwords use AES-256-GCM encryption.

  1. Configure the S3 endpoint, region, bucket, access credentials, prefix, and schedule if using S3.
  2. Keep encryption passwords safe; an encrypted snapshot requires its original password to restore.
  3. Verify a snapshot before applying it. A restore replaces active library data and restarts the server.

Keep data and audiobook storage backed up, and test restores on an isolated instance.

Review Aegis notices and device reporting

Aegis can deliver version-targeted news and service alerts to the web notification inbox and updated iOS app. The current Android app does not yet display Aegis notices. These are in-app messages, not operating-system push notifications.

The dashboard reports registered mobile installations and those active within the past five minutes. They are installation and recent-activity counts, not open connections. Aegis also manages banner artwork for supported mobile clients.

Maintain the server data

Keep the Docker host's persistent data, audiobooks, and backup folders when rebuilding or moving the container. The watched inbox is mounted separately. The Docker guide lists the exact paths, ownership, configuration variables, health check, and update commands.

Need to reinstall or move the container?Open Docker setup