Stores

Development These docs follow the development version and change with every merge.

Last updated View as Markdown

Bookclerk works with four audiobook stores today. Each store you connect adds the books you bought there to your one library.

Store How you sign in What you get
Audible Amazon sign-in in your browser Your Audible library, downloaded as audiobook files
Libro.fm Your Libro.fm email and password Your Libro.fm library, as M4B files or the store's ZIP
Chirp Your Chirp email and password Your Chirp purchases
GraphicAudio Your GraphicAudio email and password Your GraphicAudio purchases

Connect a store

Each person connects their own store accounts, on the Accounts page.

  1. Choose Connect next to the store.
  2. Sign in:
    • For Audible, you go to Amazon's own sign-in page. Enter your two-step verification code there if Amazon asks for one.
    • For the other stores, type your email and password for that store.
  3. The store appears under Connections. Its books show up in the library after the next scan.

If a store is missing from Accounts, the operator has not turned it on yet. See Turn on your stores.

Your store passwords are stored encrypted in the library's database. They are never shown again, and nobody else in your household can see them.

Download pace

Bookclerk downloads from each store account at a gentle pace, so the store doesn't see a burst of downloads. Under each connection on Accounts a line shows the pace, how many downloads started in the last day, and when the next automatic one can start.

  • The pace only slows downloads Bookclerk starts on its own, such as auto-acquire. A book you choose to download starts right away.
  • If the store asks Bookclerk to slow down, the account pauses for a while (a day for Audible, an hour for the others). Clear pause ends it early.
  • Change pace picks the store's default, your own limits, or no limit.

Disconnect a store

On Accounts, remove the connection. Books you already downloaded stay where they are.

Store by store

Audible

Bookclerk signs in the way Amazon's own phone apps do. If downloads stop working after a while, connect Audible again from Accounts to refresh the sign-in.

Libro.fm

Books download as M4B audiobook files by default. The operator can switch to the store's ZIP download instead.

Chirp

Bookclerk signs in with your Chirp email and password. It does not need your browser.

GraphicAudio

GraphicAudio sells several kinds of access. By default, Bookclerk uses the web player access, so it does not use up one of your download attempts or app devices. The operator can choose the ZIP download or the app's streams instead.

More stores

Other stores may come later, as plugins. Anyone can write a store plugin; see Plugins.

For operators, every store setting and its command-line equivalent is in the Stores reference.

Source: docs/guide/stores.md at main · View as Markdown