TropoCine Logo TropoCine
A TropoAtlas application ↗

Organize, explore, and rediscover your film collection

TropoCine is a free software film collection manager. Synchronize your DVDs and Blu-rays from TMDB, enrich them with custom metadata, and locate them on your shelves with connected LED strips.

TropoCine — Collection
TropoCine Interface Preview

Designed for passionate cinephiles

Bring a new dimension to your movie library and rediscover the joy of exploring your film collection.

Custom Metadata

Enrich movie entries with custom comments: exact shelf location, custom genres, and personal ratings.

Physical LED Locator

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

Security & API Proxy

Proxy architecture with Apache/Nginx. Personal API tokens and credentials are never exposed to client browsers.

Decoupled Architecture

A clean NPM workspace 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 films in the blink of an eye

Let TropoCine control the LED strips of your shelves!

  • Immediate visual indication of the selected film, genres, or directors.
  • 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 ESP32 microcontroller.

Shelf Active LED: 42
Stanley Kubrick 2001: A Space Odyssey
David Lynch Mulholland Drive
Alfred Hitchcock Vertigo
Akira Kurosawa Seven Samurai
Andrei Tarkovsky Stalker
F. F. Coppola Apocalypse Now
Agnès Varda Cléo de 5 à 7

Interactive simulation (click any movie case)

Clean & decoupled structure

Built within the TropoAtlas monorepo using modular packages and plugins.

apps/tropocine

React Application

Primary client application for movie collection browsing.

packages/core

@tropo/core

State management with Zustand, caching, and normalizers.

packages/react

@tropo/react

Reusable UI components.

packages/leds

@tropo/leds

HTTP client for LED strip hardware communication.

plugins/cine/tmdb

@tropo/tmdb

The Movie Database API integration plugin.

Quick Start

Run TropoCine 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/tropocine/.env.sample apps/tropocine/.env

# 3. Launch development server
npm run dev:cine