⚡ QRchive

The ultimate open-source dashboard for managing Matter devices and their QR codes.

Features • Quick Start • Docker • Tech Stack

---

🚀 Overview

QRchive is a sleek, modern, and lightweight web application designed to help you manage your Matter connectivity devices. Whether you're tracking MAC addresses, pairing codes, or generating/scanning QR data, QRchive provides a clean interface to keep your smart home hardware organized.

✨ Features

• 📱 Matter-Ready: Built specifically for tracking Matter-compatible devices.
• 🔍 QR Scanner: Integrated camera-based and image-upload QR code readers.
• 📊 CSV Management: Seamlessly import and export your device lists.
• 🎨 Modern UI: Clean, responsive dashboard with Dark Mode support.
• 🛠️ Full CRUD: Add, edit, and delete devices with ease.
• 📦 Docker Support: Containerized for instant deployment.

📸 Screenshots

🛠 Tech Stack

• Backend: Python 3.14+ + Flask
• Frontend: HTML5, CSS3, JavaScript (Bootstrap 5 + FontAwesome)
• Package Manager: uv
• Containerization: Docker

---

🚀 Quick Start (Recommended)

Deploy QRchive in seconds using Docker.

🐳 Docker Compose

Create a docker-compose.yml file:

version: '3.8'
services:
  qrchive:
    image: ghcr.io/dsheehan/qrchive:latest
    container_name: qrchive
    ports:
      - "5000:5000"
    volumes:
      - /path/to/qrchive/data:/data
    restart: unless-stopped

volumes:
  qrchive-data:

Run with: docker-compose up -d

🛠 Docker CLI

docker pull ghcr.io/dsheehan/qrchive:latest
docker run -d \
  -p 5000:5000 \
  -v /path/to/qrchive/data:/data \
  --name qrchive \
  ghcr.io/dsheehan/qrchive:latest

---

🛠 Development

Interested in contributing or building from source? See our Development Guide.

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Made with ❤️ for the Smart Home Community