# libbui [![Try it: in your browser](https://img.shields.io/badge/try_it-in_your_browser-e8a33d.svg)](https://libbui.vinnymac.dev) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) A calm, keyboard-first terminal UI for [Libby](https://libbyapp.com), 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](https://ratatui.rs). [![libbui showing The Left Hand of Darkness on loan, with its cover, due date and formats](docs/screenshot.png)](https://libbui.vinnymac.dev) ## Try it [libbui.vinnymac.dev](https://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. ```sh 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](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 - [Downloads](docs/downloads.md): which formats libbui can save as files - [Using the interface](docs/interface.md) and its default keys - [Reading](docs/workflows.md): tags, history, notes, magazines and availability across libraries - [Command line](docs/cli.md): commands, JSON output and exit codes - [Configuration](docs/configuration.md), themes and accessibility - [Files and privacy](docs/privacy.md): what libbui stores and where - [Troubleshooting](docs/troubleshooting.md) ## Contributing Issues and patches are welcome on [Tangled](https://tangled.sh/@vinnymac.dev/libbui). See [CONTRIBUTING.md](CONTRIBUTING.md) for the layout of the code and the checks every change must pass, and [AGENTS.md](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](LICENSE).