Open-source IoT weighing scale for 3D printer filament spools, with RFID tag detection, OLED display, automatic spool tracking, and TigerTag cloud sync.

Plug in your ESP32 → click Install → done. No toolchain, no command line.

TigerScale is a DIY smart scale that knows which spool sits on it. Drop a spool with a TigerTag (NFC sticker) on the platform — the scale reads the tag, weighs the spool, computes the net filament weight (subtracting the empty cardboard/plastic spool), and syncs the result to your TigerTag account in real time.

It is designed to be 3D-printable, hackable, and cheap (~30 € BoM). The cloud service that synchronises your inventory across devices is provided by TigerTag — an account is free.

• 🏷️ Dual RFID readers (RC522 13.56 MHz) for twin-tag spools
• ⚖️ Precision weighing via HX711 + 5 kg load cell
• 📺 Live OLED display with weight, rack position, and spool metadata
• ⚙️ Continuous servo that gently rotates the spool to find the second tag
• ☁️ Real-time cloud sync (Firestore) — see your inventory from any device
• 🔐 Google Sign-In via OAuth bridge (no passwords stored on device)
• 📱 Modern web UI served by the ESP32 itself, mobile-friendly — with live workflow badge (Scanning / Stabilizing / Sending / Ready)
• 🌍 9-language UI (EN / FR / DE / ES / IT / PL / PT-BR / PT / ZH) with flag-based switcher in header and login modal, locale files in data/www/locales/
• 🔐 Full in-modal auth — Google Sign-In, email/password sign-in, account creation and password reset directly in the UI (no redirect)
• 📟 Firmware version + uptime always visible under the TigerScale title, uptime advances client-side between WebSocket frames
• 👤 Account avatar with user initials + display name, collapsible account card
• 🧰 Toolbox toggle — collapse all settings below TARE for a cleaner read-only interface
• 🗄️ Local brand & material DB (LittleFS) — RFID lookups are instant, no internet required per scan; auto-updated from GitHub every 24 h
• 🔄 Auto-tare, EMA + median filtering, twin-tag pairing (§6.1 spec)
• ⚡ WebSocket delta compression — only changed fields broadcast at 10 Hz; full snapshot on connect
• 🛠️ No closed binary blobs — everything compiles from source

Plug your ESP32 in via USB and click Install. The browser flashes the firmware and the filesystem in 60 seconds. No Arduino IDE, no PlatformIO, no command line.

git clone https://github.com/TigerTag-Project/Tiger-Scale.git
cd Tiger-Scale
pio run -t upload     # firmware
pio run -t uploadfs   # web UI (LittleFS)
pio device monitor    # serial console

1. Open src/main.cpp in Arduino IDE 2.x (rename it to TigerScale.ino first)
2. Install the libraries listed in docs/INSTALLATION.md
3. Board: ESP32 Dev Module · Partition: Default 4MB with spiffs
4. Compile + upload + use the LittleFS uploader for data/

Detailed instructions: docs/INSTALLATION.md

Full Bill of Materials: hardware/BOM.md (with affiliate links) Wiring diagram: docs/HARDWARE.md Print settings: hardware/3d-models/README.md

Download Tiger_Scale_V2.3mf — a single .3mf file pre-configured for your slicer (Bambu Studio / PrusaSlicer / Orca). It contains four build variants, pick the one that matches your hardware:

Open the file, select your variant plate, and hit Slice. No manual orientation or support setup needed.

💡 Buy a kit — the Web Installer page includes a one-click shopping list of every component with Amazon affiliate links. Buying through them at no extra cost supports the project and keeps the TigerTag cloud free.

When you boot a fresh TigerScale, it creates a Wi-Fi access point named Setup-TigerScale-XXXX.

1. Connect your phone to that network (no password)
2. Captive portal opens automatically → enter your home Wi-Fi credentials
3. Scale reboots, joins your network, displays its local IP + mDNS name (tigerscale-XXXX.local) on the OLED
4. Open http://tigerscale-XXXX.local (or the IP) in your browser
5. Login modal opens — sign in with Google (one click), email/password, or create a new account directly in the UI
6. ✅ You're done — start placing TigerTagged spools on the scale

Detailed walkthrough: docs/INSTALLATION.md

┌─────────────────────────────────────────────────────────────┐
│                      TigerScale Hardware                    │
│   ESP32 ←→ 2× RC522 (SPI shared) ←→ HX711 ←→ Load Cell      │
│       ↘ OLED (I²C)        ↘ Servo (PWM)                     │
└─────────────────────────────────────────────────────────────┘
                            │
              Wi-Fi + HTTPS │ Firebase REST API
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  TigerTag Cloud (Firebase) — central service                │
│   • Firebase Auth (Google, Apple, Email)                    │
│   • Firestore (per-user inventory + scale state)            │
│   • OAuth bridge at tigertag-cdn.web.app/scale-auth.html    │
└─────────────────────────────────────────────────────────────┘
                            │
                   any phone or browser
                            ▼
            View your filament inventory anywhere

Architectural details: docs/FIRMWARE.md

TigerScale ships with a Claude Code skill that makes any AI agent a TigerScale integration expert — generating connection code, sending remote commands, and keeping documentation in sync with the firmware.

Install it in Claude Code:

Drag agents/tigerscale-integration.skill into Claude Code, or go to Settings → Skills → Install from file.

Once installed, just ask Claude to integrate your app with the scale, debug a connection, or add a new command — it reads CLAUDE.md automatically and knows the full API.

→ Details in agents/README.md

Contributions are welcome! Whether you want to:

• Report a bug or suggest an improvement → open an issue
• Submit a code/documentation PR → see CONTRIBUTING.md
• Translate the UI to another language → edit the JSON files in data/www/locales/ (one file per language)
• Print and improve the case → fork hardware/3d-models/

Join us on Discord for help, ideas, and community builds.

Anyone can manufacture and sell TigerScale hardware — no license fee, no registration.

1. Follow the BOM and wiring in hardware/BOM.md
2. Flash the latest official firmware via the Web Installer (always up to date)
3. Ship it — you're done

The only condition to call your product "TigerScale" is running the official firmware unmodified, so every unit works consistently with the TigerTag ecosystem. Forks are welcome — just use a different name. Full details: TRADEMARK.md

This project is licensed under the MIT License — see LICENSE for details.

The "TigerTag" name (RFID protocol + cloud service) and "TigerScale" product name are trademarks of the TigerTag Project. The code is free; the names have conditions. See TRADEMARK.md for the full policy (short version: build and sell freely, use official firmware, keep the name).

Third-party firmware dependencies retain their own licenses — three are LGPL (ESPAsyncWebServer, AsyncTCP, ESP32Servo), satisfied by the fully open build system. Full details: THIRD_PARTY_LICENSES.md

• Yoto for the user-experience inspiration
• ESP32 community for the framework
• ESP Web Tools for the in-browser flasher
• All the contributors who build, test, and improve this project

Built with ❤️ by the TigerTag community.