Something went wrong. Try again.
A terminal UI for Libby libbui.vinnymac.dev
Something went wrong. Try again.
Personal library workflows #
Press 5 or F6 for Reading: tags, history, notices,
magazines, annotations, and availability. Press t on a selected title to
manage it, open its publisher sample, compare libraries, or browse its
magazine issues. The command palette and help list these actions too.
- Search all libraries: in the workspace's Availability section, press
ato search all linked libraries. Each library has its own next-page action. Open a result to select its card and show the title. A title's Compare action shows availability and estimated waits at each library. - Tags and wishlists:
ncreates a local tag,wa local wishlist, andNa regular Libby tag. Libby tags are read from your paired account; regular tags can be renamed, deleted, and have titles added or removed. Libby smart tags are read-only so their automatic behaviour is preserved. Local collections are explicitly labelled and do not sync to Libby. Libby can return cached tag lists after an edit; a recently deleted tag can remain in a later CLI listing until the service updates its cache. - History: the workspace records observed shelf changes and explicit
reading states. Actual checkout timestamps are retained when supplied;
a title leaving the shelf is not guessed to be a return or expiration.
Import Libby's Timeline CSV with
i, or use the command line to select the export device's time zone. Imported entries without catalogue IDs stay readable without being sent to the catalogue as invented title IDs. - Notices: follow a title, author, or series from its title menu. Press
rin Notices to check manually. Ready holds and loans due within three days are included. Author and series checks inspect the newest 24 matching search results per library. These are local observations, not Libby push notifications, and they never borrow anything automatically. - Magazines: subscribe locally from an issue's title menu, then open the subscription to browse its library's back issues. More pages can be loaded on demand. Manual notice checks include the latest issue.
- Annotations: import a Reading Journey JSON export with
iin Annotations, then open notes, bookmarks, and highlights in a scrollable view. Personal notes can also be added from a title menu. Pressxto export annotations or history as Markdown into libbui's data directory; the command line also supports JSON and CSV exports.
Common command-line workflows:
libbui search 'dune' --all-libraries --json
libbui compare TITLE_ID
libbui sample TITLE_ID # print the publisher's sample link
libbui sample TITLE_ID --open
libbui cloud-tag list --json # actual paired-account Libby tags
libbui tag create 'Want to read' --wishlist
libbui history import libbytimeline.csv --time-zone America/New_York
libbui history export --format json
libbui follow add author 'Ursula K. Le Guin'
libbui notices refresh
libbui magazine issues TITLE_ID
libbui annotations import reading-journey.json
libbui annotations export --format markdown > highlights.md
Run a command with --help for its full options. Local lists, edits, and
imports work without pairing. Catalogue and account operations use the normal
paced clients. No feature adds background polling.