BrickTracker 🧱

Un catalogueur de collection LEGO self-hosted, avec suivi des sets, des pièces, de l'inventaire et de la valeur de marché.

Métadonnée	Valeur
Site web	https://bricktracker.app/
GitHub	https://github.com/nicolasthreatt/bricktracker
License	MIT
Langage principal	Python (Flask)
Étoiles GitHub	⭐12
Dernière MAJ	2026-02-08
Catégorie	cat-tracking

Description

BrickTracker est un gestionnaire de collection LEGO auto-hébergé, conçu pour les AFOLs (Adult Fans Of Lego) qui veulent savoir précisément ce qu'ils possèdent, ce qu'il leur manque pour compléter un set, et combien leur collection vaut. L'application s'appuie sur les données de Rebrickable (la base de données LEGO la plus complète) pour identifier sets, pièces et minifigs par leur numéro.

L'architecture est volontairement simple : Flask côté backend, SQLite côté base, et des templates Jinja2 pour le rendu. On scanne ou on entre manuellement le code des pièces, l'application fait le matching avec Rebrickable, et l'inventaire se constitue progressivement. Le suivi inclut les sets en cours de construction, les instructions manquantes, et la valeur (prix catalogue vs prix du marché secondaire BrickLink).

La recherche de pièces détachées est la killer feature : « de combien de briques 2x4 rouges est-ce que je dispose ? » est une question que tout AFOL se pose, et BrickTracker y répond. Export CSV des inventaires pour partage ou backup.

⚠️ Projet jeune, bus factor 1 — un seul mainteneur actif, rythme de publication irrégulier. La fonctionnalité de scan est encore basique (saisie manuelle du code, pas de webcam).

Installation

Via Docker (recommandé)

services:
  bricktracker:
    container_name: bricktracker
    image: ghcr.io/nicolasthreatt/bricktracker:latest
    restart: unless-stopped
    ports:
      - "8088:5000"
    volumes:
      - bricktracker-data:/data
    environment:
      - SECRET_KEY=changez-moi-32-chars
      - REBRICKABLE_API_KEY=votre-cle-rebrickable
      - DATABASE_URL=sqlite:////data/bricktracker.db

volumes:
  bricktracker-data:

Installation manuelle

Pré-requis : Python 3.11+, SQLite.
Cloner : git clone https://github.com/nicolasthreatt/bricktracker.git
cd bricktracker && pip install -r requirements.txt
Configurer .env (clé secrète, clé API Rebrickable).
flask db upgrade puis flask run ou via Gunicorn en production.

Configuration

Obtenir une clé API Rebrickable gratuite sur https://rebrickable.com/api/.
Créer le premier utilisateur via flask create-user.
Configurer les listes (en stockage, à construire, à revendre).
Définir le stockage des photos de sets/pièces (volume Docker persistant).
Activer l'intégration BrickLink pour les prix du marché (optionnel).

Alternatives

Open source

Rebrickable (propriétaire) — la base de référence, mais cloud
BrickLists — apps mobiles, non self-hosted
app-koillection — générique (collections de tout type), adaptable aux LEGO
Grocy — gestion d'inventaire, pas spécifique LEGO

Propriétaires

Rebrickable — base de données + apps, freemium
BrickLink (propriétaire, mais marketplace) — pour acheter/revendre, pas un catalogueur
Brickset — base de données + wishlist, freemium

Sécurité

Changer SECRET_KEY par une valeur aléatoire forte.
HTTPS obligatoire (reverse proxy Traefik/Caddy) pour protéger la session.
Sauvegarder la base SQLite régulièrement (le volume bricktracker-data).
Clé Rebrickable : limitée à l'API publique, ne pas confondre avec la clé premium.
En multi-utilisateur (famille), créer des comptes distincts plutôt que partager un login.

Ressources

Site officiel : https://bricktracker.app/
Dépôt GitHub : https://github.com/nicolasthreatt/bricktracker
API Rebrickable : https://rebrickable.com/api/
selfh.st : https://selfh.st/apps/

4.4 KiB Raw Permalink Blame History