How hectordoesgorug/bookledger works
BookLedger is an offline-first desktop inventory manager with an Android capture companion. The principal workflow is desktop cataloging: users enter a book manually or look up metadata, then manage bibliographic records and physical copies, including photos, condition, location, price, and status. The phone can send ISBN or no-ISBN captures and cover photos to the desktop over a local network for cataloging. Reports, sales history, posters, currency conversion, backups, and updates are distinct product capabilities. Some service links are documented only by README or source-index references; unsampled implementation details are not inferred.
Main entry points: app.py Desktop app · mobile_connection.py Desktop mobile connection · catalog.py Books and copies · metadata.py Metadata lookup
Components 22
Desktop catalog
- Desktop app
src/bookledger/app.py - Catalog forms
src/bookledger/ui/forms.py
Domain services
- Books and copies
src/bookledger/services/catalog.py - Library database
src/bookledger/db/database.py - Copy photos
src/bookledger/services/photos.py - Metadata lookup
src/bookledger/services/metadata.py - Provider registry
src/bookledger/provider_registry.py - Metadata providers
src/bookledger/services - Currency conversion
src/bookledger/services/currency.py - Sales history
src/bookledger/services/catalog.py - Reports
src/bookledger/services/reports.py - Copy posters
src/bookledger/services/posters.py
Mobile companion
- Android companion
mobile/android/app/src/main/kotlin/com/bookledger/mobile/MainActivity.kt - Desktop mobile connection
src/bookledger/services/mobile_connection.py - Incoming captures
src/bookledger/services/mobile_incoming.py - Pairing setup
src/bookledger/ui/mobile_app_setup.py
Library maintenance
- Backup and restore
src/bookledger/services/backups.py - Update flow
src/bookledger/services/updates.py - App configuration
src/bookledger/config.py - Provider settings
src/bookledger/provider_settings.py
Other components
- BookLedger user
- Phone user
Connections 22
- BookLedger user → Desktop app: uses
README.md - Desktop app → Catalog forms: opens forms
src/bookledger/app.py - Catalog forms → Metadata lookup: requests lookup
src/bookledger/ui/forms.py - Desktop app → Books and copies: manages inventory
src/bookledger/app.py - Books and copies → Library database: reads and writes
src/bookledger/services/catalog.py - Books and copies → Copy photos: imports photos
src/bookledger/services/catalog.py - Desktop app → Metadata lookup: uses lookup
src/bookledger/app.py - Metadata lookup → Provider registry: builds providers
src/bookledger/services/metadata.py - Provider registry → Metadata providers: registers providers
src/bookledger/provider_registry.py - Desktop app → Currency conversion: converts currency
README.md - Desktop app → Sales history: manages sales
README.md - Desktop app → Reports: generates reports
src/bookledger/app.py - Desktop app → Copy posters: creates posters
src/bookledger/app.py - Desktop app → Backup and restore: backs up library
src/bookledger/app.py - Desktop app → Update flow: checks updates
src/bookledger/app.py - Desktop app → App configuration: loads settings
src/bookledger/app.py - Desktop app → Provider settings: configures providers
src/bookledger/app.py - Phone user → Android companion: captures books
README.md - Android companion → Desktop mobile connection: sends captures
README.md - Pairing setup → Desktop mobile connection: pairs devices
src/bookledger/ui/mobile_app_setup.py - Desktop mobile connection → Incoming captures: dispatches captures
src/bookledger/services/mobile_connection.py - Desktop mobile connection → Desktop app: transfers captures
README.md