Files
bookhoard/docs/user/profile-guide.md
T
John O'Keefe 9e2f216af5 docs(user): dashboard, browsing, profile rewrites + new podcasts guide; trash stubs
Ground-truthed against the templates this pass:
- dashboard.md: real section kinds (system shelves incl. Continue
  Series, user collections, custom sections via /custom-section
  builder), Customize Dashboard panel semantics (per-library, drag,
  switches, 10-50 items, Save Changes), Refresh, This Week widget,
  per-item Read/Listen and progress-conflict resolve actions. The old
  page listed a wrong shelf set and never mentioned custom sections.
- library-browsing.md: the file was secretly titled 'Saving Custom
  Filters' and covered nothing else. Now the browsing page: All Books
  toolbar (search, Sort, Filters -> drawer hand-off, Save/Load/Clear
  saved filters), book detail as hub, series pages, podcasts split.
- profile-guide.md: field table ground-truthed from profile_form.templ
  (username/email DO remain editable there), audio defaults (speed,
  resume rewind, keep awake), timezone rendering contract, both theme
  doors (7-pick select vs 37-theme Appearance panel), Change Password
  with live checks, Danger Zone/Remove My Account + last-admin rule.
- podcasts.md NEW: the Podcasts page had zero documentation. Subscribing
  (Add Feed -> RSS URL, library, back-catalog download, download order,
  Add & Subscribe), Continue/All Feeds, Download All, player + Play as
  Sequence cross-link.
- Trashed user-areas.md, frontend-guide.md, settings-guide.md: stubs
  whose planned content now exists as real pages (or duplicates
  profile-guide). user-guide.md rewritten as the plain-language front
  door with a go-here-when table; index.md rows updated to match.
- ui-controls.md: 10 new gate-checked entries for every newly cited
  control (Add & Subscribe via templ-entity fragment).
2026-11-02 10:07:28 -05:00

2.1 KiB

Your profile

Your profile page holds everything that is about you rather than your books: account details, playback preferences, your password, and — if you ever need it — account deletion.

Open it from the sidebar: click your username at the bottom, then Profile.

Account information

Field What it does
Username Your login name — must stay unique
Email Address Must stay unique
First Name / Last Name Optional display names
Theme A quick theme picker (seven favorites — see below for the full set)
Default Playback Speed The speed audiobook playback starts at
Resume Rewind Jumps back a few seconds when you resume playback (Off (exact resume), 5, or 10 seconds)
Keep Screen Awake Stops the screen sleeping during playback
Timezone All times the server shows you (activity, stats, history) are rendered in this zone

Changes save from the form's save button and apply immediately.

About the two theme doors: the profile's Theme select offers seven quick picks. The sidebar's Appearance panel offers the full collection — Themes and Wood Paneling covers it, including the bookshelf wood textures, which are per-browser and not part of your account.

Changing your password

On the same page, the Change Password section asks for your Current Password, a New Password, and Confirm New Password. The requirements are checked as you type; click Update Password to save.

Deleting your account

The Danger Zone at the bottom holds Remove My Account. Deletion removes your account and everything personal to it — profile, reading progress and history, device registrations, your collections — and keeps the libraries themselves, since books belong to the library, not to you. It cannot be undone.

The last administrator cannot delete their own account — one admin must always remain.

Administrators can also edit other users' profiles (including resetting a password without the current one) from the admin area; that is covered with the rest of the admin docs.