Hardcover TUI

An unofficial terminal user interface (TUI) client for Hardcover.app — Social discovery for serious book lovers. Browse your library, track your reading and manage your books without leaving the terminal.

Installation

From Release Binaries

Download the latest binary for your platform from the Releases page.

AUR Package

paru -S hardcover-tui-bin

From Source

git clone https://github.com/NotMugil/hardcover-tui.git
cd hardcover-tui
go mod tidy
go build -o hardcover-tui ./cmd

Go Install

go install github.com/NotMugil/hardcover-tui/cmd/hardcover-tui@latest

Usage

./hardcover-tui

On first launch, you'll be prompted to enter your Hardcover API key. Visit hardcover.app/account/api to get your API key and then copy and paste it into the app when prompted.

Contributing

Contributions are welcome! Whether it is opening an issue, bug fixes, new features, documentation improvements or document translations — all help is appreciated.

Please read the Contributing Guide before getting started.

Resources

• Hardcover Website
• Hardcover API Docs
• Kameleon21/oku

Related Libraries

• Bubble Tea
• Bubbles
• Lip Gloss
• go-graphql-client
• go-keyring

Disclaimer

This is an independent, community-developed client and is not affiliated with, sponsored by, or endorsed by Hardcover. It connects to the Hardcover GraphQL API using your personal API key and acts on your behalf.

License

This project is licensed under the GNU Affero General Public License v3.0.