View on GitHub

rbibli

A modern personal library management system built in Rust. Catalog your books, track loans, and organize your collection with ease.

Download this project as a .zip file Download this project as a tar.gz file

rbibli

Personal Library Management System

A modern, elegant solution for managing your personal book collection. Built entirely in Rust with a beautiful native interface using Slint.

Perfect for book lovers who want to organize their home library with ease.

✨ What is rbibli?

rbibli helps you catalog, organize, and track your personal book collection. Whether you have dozens or thousands of books, rbibli makes it easy to:

📚 Catalog your books with rich metadata (ISBN, authors, genres, cover images)
📍 Track physical locations with hierarchical storage (Room > Bookshelf > Shelf)
👥 Manage loans to friends and family with automatic due dates
📊 Visualize your collection with insightful statistics and charts
🔍 Search and organize by genre, author, publisher, or location

🎯 Why rbibli?

Simple Yet Powerful

Easy to use - Clean, intuitive interface that makes cataloging enjoyable
Fast and responsive - Native desktop application with instant updates
Flexible - Track multiple copies of the same book, organize by location, manage loans

Smart Features

ISBN Lookup - Automatic book metadata from Google Books
Barcode Support - Quick checkout with volume barcodes
Dewey Classification - Professional library organization
Statistics Dashboard - See your collection at a glance

Built for You

Privacy-focused - Your data stays on your computer
No subscriptions - Free and open-source
Customizable - Organize your way with custom locations and borrower groups

🚀 Key Features

📚 Complete Library Management

Full book metadata (title, subtitle, ISBN, pages, language, summary)
Author and publisher information
Genre and Series categorization
Dewey Decimal Classification
Cover image storage

📖 Multiple Physical Copies

Track multiple volumes of the same title
Individual condition tracking (excellent → damaged)
Unique barcode for each physical copy
Location assignment per volume

📍 Hierarchical Storage

Organize by room, bookshelf, and shelf
Full path display (“Office > Bookshelf A > Shelf 3”)
Easy navigation of your physical space

👥 Smart Loan Management

Simple borrower management
Borrower groups with custom loan policies
Automatic due date calculation
Visual overdue highlighting
Barcode-based checkout/return

📊 Insightful Analytics

Library overview (total books, active loans, overdue items)
Volumes per genre with bar charts
Volumes per location
Loan activity tracking

🔍 Advanced Organization

ISBN metadata lookup via Google Books API
Complete Dewey Decimal Classification system

🎨 Technology

Built with modern, reliable technology:

Rust - Memory-safe, blazingly fast
Slint - Beautiful native UI framework
MariaDB - Reliable data storage
Actix-web - High-performance web framework

📥 Get Started

Prerequisites

Rust (latest stable)
MariaDB/MySQL
SQLx CLI (cargo install sqlx-cli)

Docker

You can run rbibli using Docker. Official images are available on Docker Hub: https://hub.docker.com/r/gcorbaz/rbibli

Example docker-compose.yml:

services:
  rbibli:
    image: gcorbaz/rbibli:latest
    ports:
      - "8080:8080"
    environment:
      # Database Connection
      # Note: Use APP__ prefix (double underscore) for configuration
      - APP__DATABASE__URL=mysql://user:password@db:3306/rbibli

Configuration: The application is configured entirely via environment variables.

Installation

Clone the repository

git clone https://github.com/guycorbaz/rbibli.git
cd rbibli

Set up the database a. Configuration Create a .env file in the project root:

DATABASE_URL=mysql://rbibli:your_password@127.0.0.1:3306/rbibli
HOST=127.0.0.1
PORT=8000

Run migrations

cd backend
sqlx database create
sqlx migrate run

Run the application

Option A: Docker
```
docker compose up --build
```
Option B: Manual Start backend: cargo run --release (in backend/) Start frontend: trunk serve --release (in frontend/)