Documentation

Guides and tutorials to master BiblioGenius

← All guides

Where is my data stored

BiblioGenius is local-first: your library lives in a database on your device, and the app works with no account and no connection. Whatever leaves the device only leaves because you asked for it, and this page says exactly what, when and where to.

On your device

Your books, shelves, collections, tags, copies, loans and contacts are stored locally. You can use the whole app offline: add books by hand, organize them, track your reading.

What leaves the device, and when

  • Searches in external catalogues. When you scan an ISBN or search for a title, the query goes out to the enabled sources (BnF, OpenLibrary, Inventaire and others). Those sources therefore see what you are looking for. You choose which ones to query in Settings > Search sources.
  • Covers and metadata are downloaded from those same sources, then kept on your device.
  • Sharing with your contacts. When a connected library browses your catalogue, your device answers it directly, end-to-end encrypted. On a local Wi-Fi network the exchange never leaves that network. Remotely, it goes through a relay that only ever sees encrypted data.
  • The online directory, if you enable "Make me visible to other libraries". You can require your approval before a new follower reaches your shared books. Your city stays a local preference until you choose to share it.
  • The encrypted account, if you create one. The server then only stores encrypted blocks, unreadable to it. See Encrypted account and multiple devices.

None of this is turned on for you.

The app's permissions

Two Android permissions are classified as "dangerous" by the system. Here is what they are for.

Camera. Scanning barcodes to add a book, and reading the pairing QR codes between libraries.

Microphone. One function only: dictating a reading note or a quote instead of typing it. The microphone button appears in note fields. The permission is declared in the app manifest, but it is only requested the first time you use that button: if you never dictate, the app never asks.

The app records no audio and keeps none. Only the recognized text is inserted into the note field. Turning speech into text, however, is done by the operating system: the app uses the speech recognition the device provides. That processing therefore depends on your device and its settings, and it is outside the app's hands. This is why dictation can be switched off: turning it off in the settings removes the microphone button. It is on by default, except on the bookseller profile.

An independent audit

Exodus Privacy analyses the trackers and permissions of Android apps. Its report on BiblioGenius is public: see the Exodus Privacy report.

Choosing what others see

Enable "Private books" in the settings to unlock the Private option on each book: a private book stays in your library but never shows up to others, neither on your public profile nor in network searches.

To check rather than trust, open "What other libraries see": this list is the exact answer your device sends to a library browsing your catalogue, produced by the same code, with no cosmetic recomputation.

Backups

You can take your data out at any time from Settings > Backup and recovery: portable export, CSV export readable in a spreadsheet, or a restorable encrypted archive. See Exporting and backing up.

Encryption

Exchanges between libraries are end-to-end encrypted. So are the encrypted account and full backups, with a key derived from your passphrase: we have no technical means of reading your data.

Deleting my data

On the device, the settings let you erase your books or start over. To delete an online account, follow the procedure on the Data deletion page.