Libros - Personal Book Manager

A terminal-based book management TUI built with Go and Bubble Tea.

Features

• Add, edit, view, and delete books (paperback, hardback, audio, digital)
• 4 color themes with live preview
• Export to JSON or Markdown
• Database backup
• Vim-style navigation (j/k)

Installation

git clone https://github.com/papadavis47/libros.git
cd libros
make build
./libros

Requires Go 1.24.0+

Usage

• ↑/↓ or j/k: Navigate menus
• Enter: Select
• Esc: Go back
• q: Quit

File Locations

All files stored in ~/.config/libros/:

• libros.db - Database
• theme.toml - Theme config
• exports/ - Export files

Development

make test           # Run all tests
make test-unit      # Unit tests only
make test-coverage  # Coverage report
make build          # Build binary
make clean          # Clean artifacts

License

Open source - see LICENSE file.