From 9ef8dca4d55e16a43d5ba0f4898d9150bc87a561 Mon Sep 17 00:00:00 2001 From: rmcrackan Date: Wed, 15 Apr 2026 09:58:36 -0400 Subject: [PATCH] Document Linux runtime dependency --- docs/advanced/troubleshoot.md | 4 ++++ docs/installation/linux.md | 10 ++++++++++ 2 files changed, 14 insertions(+) diff --git a/docs/advanced/troubleshoot.md b/docs/advanced/troubleshoot.md index 7c0e6358..f2280d23 100644 --- a/docs/advanced/troubleshoot.md +++ b/docs/advanced/troubleshoot.md @@ -22,6 +22,10 @@ Hangover is located inside the app bundle. Either: The installer creates shortcuts for `libation`, `libationcli`, and `hangover`. From a terminal, run `hangover`. +### Linux: in-app Audible login or “add account” fails + +Embedded sign-in uses WebKit2GTK (`libwebkit2gtk`). If that native stack is missing, install the packages for your distro or use 'external browser' sign-in in Libation's import/library settings. Details: [Install on Linux](/docs/installation/linux) (section: Runtime dependencies (Audible sign-in)). + ## SQLite Error 10: 'disk I/O error'. There are two possible causes of this error. diff --git a/docs/installation/linux.md b/docs/installation/linux.md index 017029ea..8dad6388 100644 --- a/docs/installation/linux.md +++ b/docs/installation/linux.md @@ -6,6 +6,16 @@ New Libation releases are automatically packed into `.deb` and `.rpm` package and are available from the [Libation repository's releases page](https://github.com/rmcrackan/Libation/releases). +## Runtime dependencies (Audible sign-in) + +The Chardonnay desktop build can log into Audible inside the app when the setting to use Libation's built-in web browser for sign-in is enabled (Import / library settings). On Linux that embedded flow uses WebKit2GTK; the native library is usually exposed as `libwebkit2gtk` (exact package names vary by distro). It is required for in-app OAuth when adding an account or signing in again through that path. + +If WebKit2GTK is not installed, use external browser sign-in instead (turn off the built-in browser option in the same settings area), or install your distribution's WebKit2GTK packages, for example: + +- Arch Linux: `webkit2gtk` or `webkit2gtk-4.1` +- Debian / Ubuntu: WebKit2GTK 4.x packages such as `libwebkit2gtk-4.1-0` (names can differ by release) +- Fedora / RHEL: the `webkit2gtk4` / WebKit2GTK packages provided for your release + Run these commands in your terminal to download and install Libation. **Make sure you replace** `X.X.X` with the latest Libation version and `ARCH` with your CPU's architechture (either `amd64` or `arm64`). ### Debian