Instant Search & Sort
Filter and sort your collection in real-time by artist, year, date added, rating, or physical shelf locations.
Features
Designed for serious music collectors
Bring a new dimension to your music collection and rediscover the joy of exploring your vinyl records and CDs.
Custom Metadata
Enrich album entries with custom fields: exact shelf position, purchase price and simplified styles.
Physical LED Locator
Select an album, styles, or artists 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.
Interface
Explore the Interface
A fast and modern interface designed to put your physical music collection at your fingertips.
Collection
Cover browsing with direct access to synchronization, backup, and themes.
Album Details
Shelf number, purchase price, custom styles, and tracklist.
Filtering
Instant multi-criteria filtering by styles, artists, and formats.
About TropoAudio
Version information, links to source code, and free software license.
IoT Hardware
Find your records in the blink of an eye
Let TropoAudio control the LED strips of your shelves!
- Immediate visual indication of the selected album, styles, or artists.
- 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.
Shelf
Active LED: 310
Iron Maiden
Powerslave
Metallica
Master Of Puppets
Emilie Simon
Mue
Léo Ferré
Et... Basta!
Ratt
Out Of The Cellar
Agar Agar
Cardan
Magma
Köhntarkösz
Interactive simulation (click any album)
TropoAtlas Monorepo
Clean & decoupled structure
Built within the TropoAtlas monorepo using modular packages and plugins.
apps/tropoaudio
React Application
Primary client application for browsing a collection of albums.
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/audio/discogs
@tropo/discogs
Discogs API integration plugin.
Deployment
Quick Start
Run TropoAudio 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/tropoaudio/.env.sample apps/tropoaudio/.env
# 3. Launch development server
npm run dev:audio
git clone https://github.com/esaracco/tropoatlas.git
cd tropoatlas
npm install
# 2. Configure environment variables
cp apps/tropoaudio/.env.sample apps/tropoaudio/.env
# 3. Launch development server
npm run dev:audio