TropoBiblio Logo TropoBiblio
A TropoAtlas application ↗

The bridge between your digital and physical library

TropoBiblio is a free software book collection manager. Synchronize your library from Inventaire.io, enrich your books with custom metadata, and locate them on your shelves with connected LED strips.

TropoBiblio — Collection
TropoBiblio Interface Preview

Designed for serious book collectors

Bring a new dimension to your personal library and rediscover the joy of browsing its shelves.

Custom Metadata

Enrich each book with custom fields: exact shelf location, purchase price, and simplified genres.

Physical LED Locator

Select a book, genres, or authors on the screen, and the corresponding slots on your shelves light up thanks to LED strips.

Modular Architecture

Clean NPM monorepo separating UI components, state management, cache, hardware drivers, and data plugins.

Portable Backups

Export and restore full collection archives with metadata and cover artwork in portable ZIP packages.

Find your books in the blink of an eye

Let TropoBiblio control the LED strips of your bookshelves!

  • Immediate visual indication of the selected book, genres, or authors.
  • Direct HTTP integration with lightweight ESP32 firmware.

💡 Maker-Friendly: All firmware source code and wiring schematics are free software and included in the repository, ready to flash onto an affordable ESP32 microcontroller.

Bookshelf Active LED: 42
Kropotkine L'Entraide
George Orwell 1984
Perec Un homme qui dort
Sartre L'Être et le Néant
Husserl Ideen I
Deleuze L'Anti-Œdipe

Interactive simulation (click any volume)

Clean & decoupled structure

Developed within the TropoAtlas monorepo using modular packages and plugins.

apps/tropobiblio

React Application

Primary client application for browsing your book collection.

packages/core

@tropo/core

State management with Zustand, caching, and normalization.

packages/react

@tropo/react

Reusable UI design system, theme engines, modals, and navigation components.

packages/leds

@tropo/leds

HTTP client for LED controller communication.

plugins/biblio/inventaire

@tropo/inventaire

Inventaire.io API integration plugin.

Quick Start

Run TropoBiblio locally or with Docker, and deploy it behind an Apache/Nginx reverse proxy.

Local development setup Bash
# 1. Clone repository and install dependencies
git clone https://github.com/esaracco/tropoatlas.git
cd tropoatlas
npm install

# 2. Configure environment variables
cp apps/tropobiblio/.env.sample apps/tropobiblio/.env

# 3. Launch development server
npm run dev:biblio