a personal library in the terminal. scan, edit, search. the world is your banana
runa is a terminal UI book catalog, built in Go on the Charm stack (Bubble Tea, Lip Gloss, Bubbles). scan a book with a handheld barcode scanner, or just type in the ISBN, and runa pulls metadata from Open Library. no account, no subscriptions. local first and free.
a personal library tool that is actually mine: terminal-native, no subscriptions, no tracking, and a good excuse to learn Go and the Charm stack.
check back later for updates. this is a personal project, and i don't have a lot of time to work on it outside of my day job and my cs degree.
- Language: Go
- UI Framework: Bubble Tea v2
- Styling: Lip Gloss v2
- Components: Bubbles v2
- Metadata source: Open Library API
- Input: handheld barcode scanner or manual ISBN entry
- Storage: undecided (JSON or SQLite)
v0.1 - walking skeleton TUI shows a hardcoded book list, navaigate up and down, No scanner, no API, so storge yet. Win: it runs, it renders, you can move around.
v0.2 — live metadata Type an ISBN manually, fetch from Open Library, show the result. Still no persistence. Win: real book data appears.
v0.3 — it remembers Add persistence so books survive a restart. Storage decision (JSON vs SQLite) gets made here. Win: the library is real now.
v0.4 — the scanner Wire in the barcode scanner for ISBN input. Win: scan a book, it lands in the catalog.
v0.5+ — make it nice Search, filter, edit, delete. Styling pass with Catppuccin Frappé and Departure Mono.
not ready yet. check back after v0.3 <3
MIT License. See LICENSE file for details.