Instant Search & Filter
Filter and sort your collection in real-time by artist, year, date added, rating, or physical shelf location.
Features
Designed for serious music collectors
A responsive, modular manager built for large vinyl and CD collections.
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 shelf 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, tactile, and modern interface designed to put your physical music collection at your fingertips.
Collection
Instant grid browsing with quick access to sync, backup, LEDs, and themes.
Album Details
Shelf location index, purchase price, custom styles, and tracklist.
Filtering
Live filtering by custom styles, artists, formats, and rating.
Settings
Discogs field mapping, formats filter, and LED hardware options.
About TropoAudio
Version information, source links, 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, filtered styles, or filtered artists.
- Direct HTTP integration with lightweight ESP32 firmware.
Shelf
Active LED: 310, 314
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
LED-based location simulation
Monorepo Packages
Clean & decoupled structure
Modular components organized as independent NPM packages and data 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