Guides

Grimmory setup

Morrow can connect to a Grimmory server using the same address and account you use with the Grimmory web interface. A compatible legacy Booklore server also works: select the Grimmory type for it.

Connection checklist

Add Grimmory to Morrow

  1. Open Morrow and go to the Settings tab.
  2. Choose Add Server.
  3. Select Grimmory.
  4. Enter the server address.
  5. Sign in with your username and password, or with your server's single sign-on (see below).
  6. Save the connection.

Grimmory has no API key or magic link option. Grimmory servers also have no separate search or pagination endpoint, so Morrow loads the whole audiobook library list in one request.

Sign in with SSO

If your Grimmory server signs in through an identity provider (OpenID Connect, for example Pocket ID, Authentik, Authelia or Keycloak), Morrow can sign in the same way. Morrow 1.13 or later is required.

Google works for Grimmory's website, but not for app sign-in. Grimmory sends an app's sign-in straight back to the app's own address, and Google only returns to web addresses. If your server uses Google, Morrow says so on the server form; sign in to Morrow with a Grimmory password account instead.

For the server admin (once)

  1. In Grimmory, open Settings > OIDC and set up your provider. Leave Client Secret empty for a public client.
  2. Under Allowed Mobile Redirect URIs, add morrow://oauth. Keep the existing entries.
  3. In your sign-in server (for example Pocket ID or Authentik), open the client you created for Grimmory and add morrow://oauth to its callback URLs, beside Grimmory's own web callback. In Pocket ID: OIDC Clients > Grimmory > Callback URLs. That client should be Public with PKCE on.

Grimmory matches a sign-in to an existing account by the claim set in Username Claim. If accounts were created with a password, turn on Link Existing Local Accounts until each person has signed in once with SSO.

In Morrow

  1. Add (or edit) your Grimmory server and enter its address.
  2. Under Account, choose your provider (for example Pocket ID), then Sign in with Pocket ID.
  3. Sign in on your provider's page. When it closes, the server is saved and connects.

Good to know:

Problems connecting

See Troubleshooting. When reporting a problem, include the Morrow version, device operating-system version, server version, and the exact error text. Remove credentials and private tokens first.