Librius
A smarter way to manage your books.
An open-source, command-line tool to catalog, search, and manage your personal library — fast and elegantly.
What is Librius?
Librius is an open-source CLI application designed for readers, book collectors, and personal librarians.
It helps you quickly add, search, and organize books in your library using ISBN lookup, CSV import, and fast querying.
Whether you manage a small personal collection or a growing archive, Librius keeps everything structured and easy to navigate.
Librius v0.5.0
View full release notes on GitHub →
Released on November 20, 2025 – “Complete test suite & modular CLI refactor”
🧪 Key Features
- Introduced a comprehensive automated test suite for both database and CLI layers.
- Added the
setup_temp_db()utility to create temporary SQLite databases:- Windows →
%TEMP%\librius_test_*.db - macOS / Linux →
/tmp/librius_test_*.db
- Windows →
- All tests now use the real production schema for full consistency and portability.
- Unified the
/testsdirectory with dedicated files for CLI, database, and core module testing.
🔧 CLI Refactor
- Performed a complete refactor of the CLI into a modular architecture:
cli/args.rs— defines all commands, options, and global flagscli/dispatch.rs— handles parsing and subcommand executioncli/mod.rs— unified entry point exportingbuild_cli(),run_cli(), andparse_cli()- Removed the legacy monolithic
cli.rs. - Improved readability, testability, and maintainability in preparation for future integration with
librius_coreand the GUI frontend.
🧱 Internal Improvements
- Removed obsolete
#[cfg(test)]blocks from production files. - Fixed all build and Clippy warnings.
- Verified full cross-platform compatibility (Windows, macOS, Linux).
- Laid the groundwork for upcoming multi-platform CI integration (scheduled for v0.5.1).
🔜 Next release: v0.5.1 — introducing multi-platform CI and advanced search improvements.
Why choose Librius?
ISBN lookup
Automatically retrieves book details using ISBN.
Fast CLI workflow
Manage your library quickly using terminal commands.
CSV import support
Easily import large book collections from CSV files.
Open-source & customizable
Fully transparent, extensible, and community-driven.
See Librius in action
Work faster with a clean and intuitive command-line workflow.
Ready to get started?
Download Librius and start managing your personal library the smart way.