A terminal UI for Libby libbui.vinnymac.dev
README.md

libbui #

Try it: in your browser License: Apache-2.0

A calm, keyboard-first terminal UI for Libby, your public library's app for ebooks, audiobooks and magazines. Browse your shelf, search your library's catalogue, borrow, place holds, and download the titles your library offers as files. Written in Rust with ratatui.

libbui showing The Left Hand of Darkness on loan, with its cover, due date and formats

Try it #

libbui.vinnymac.dev runs libbui in your browser with a sample library. Nothing leaves your device.

Install #

libbui needs Rust 1.90 or newer, and no system libraries.

cargo install --locked --git https://tangled.sh/@vinnymac.dev/libbui libbui

Building from source, shell completions and the static RISC-V build are in docs/install.md.

Get started #

  1. In Libby, open the menu and choose Copy To Another Device. Libby shows an eight-digit code.
  2. Run libbui and type the code. libbui signs in like a second phone would, so it never sees your library card PIN.
  3. Your cards, loans and holds appear. Press ? on any screen for its keys.

libbui unpair forgets the pairing on this computer.

Documentation #

Contributing #

Issues and patches are welcome on Tangled. See CONTRIBUTING.md for the layout of the code and the checks every change must pass, and AGENTS.md for project guidelines.

libbui is not affiliated with OverDrive, Libby or any library. Libby is a trademark of OverDrive, Inc.

Licence #

Apache-2.0.