🔬 Meistertracker
Meistertracker is a self-hosted lab management system for mushroom cultivation. Workers walk the lab with phones or tablets, scan barcodes on bags and cultures with the device camera, and the software tracks every fruiting block from inoculation to harvest — across the four phases of the cultivation cycle (spawn run → incubation → fruiting → contamination triage).
Print barcode and QR labels at the workbench, file contamination reports with photos, weigh harvests against KPI dashboards, manage cultures and inventory, and sync tasks and due dates to any CalDAV calendar (Apple Calendar, Google Calendar, Thunderbird, DAVx5). Multi-user with role-based access (worker / admin), MCP integration for Claude Desktop and other LLM clients, offline-capable as a PWA. One Node.js process, SQLite database, no cloud dependencies — runs on Windows, macOS, or Linux (including a Raspberry Pi).
Meistertracker is the operational backbone of Meisterpilze, an urban mushroom farm in Erlangen, Germany, growing shiitake, oyster, king oyster, lion's mane, and blue oyster mushrooms for restaurants, retail, and home growers. Every fruiting block, every culture transfer, and every harvest gram in the lab is tracked through this software — released under AGPL-3.0-or-later so other labs can run, modify, and self-host it freely.
🍄🟫 About
Meistertracker is developed and maintained at Meisterpilze UG in Erlangen, Germany — an urban specialty-mushroom farm founded in June 2024 by Dr. Jonas Hahn (research, biologist) and Luis Veloso (production, chemist). In their own words: „Eine Verbindung von Wissenschaft und Natur" — a blend of science and nature in service of better food.
The software was built in-house because no off-the-shelf tool fit how a real mushroom lab actually works: barcode scanning over typing, lifecycle phases that match the fungal biology, and a label printer right at the workbench. It runs daily in our lab and is published under AGPL-3.0-or-later so other labs can build on it freely.
The software is provided without warranty of any kind and the authors accept no liability for damages arising from its use.
AGPL §13 reminder: if you operate this software as a network service for users other than yourself, you must offer them the corresponding source code (including any modifications). The unmodified upstream is at https://github.com/meisterpilze/meistertracker — linking back is usually enough to comply.
See LICENSE for the full terms.
Legal notice: the meistertracker.com domain that redirects to this repository is operated privately by Julian Zienert (Netherlands). See its imprint & privacy notice for how visits to the domain and emails to @meistertracker.com addresses are handled.
✨ Features
Core lab workflow
- Barcode scanning — ADD, MOVE, REMOVE, HARVEST actions via USB-keyboard scanner or phone camera
- Batch management — fruiting blocks and grain spawn bags with full lifecycle tracking
- Culture library — mother cultures, petri dishes, liquid cultures, grain-to-grain spawn with lineage tracing
- Harvest logging — per-bag weight tracking with flush numbers and yield analytics
- Inventory ledger — substrate stock, delivery logging, low-stock alerts, audit trail per change
- Contamination reports — photo upload + on-screen annotations, optional auto-MOVE to CONTAM zone, follow-up tasks
- Lab notebook — experiments with their vessels and phone photos (with SHA-256; JPEGs keep their full-resolution original, with location data removed: EXIF GPS, XMP and IPTC places), an append-only history of who changed what, protected by a hash chain with a daily RFC 3161 timestamp, removal instead of deletion, work packages for funded projects, a printable lab book (or PDF) per experiment, period or work package, and an archive (ZIP) of it with the photos, the chain and the timestamps that can be checked without the app
- Task management — auto-generated batch tasks plus manual tasks with team assignment
- CalDAV calendar sync — built-in CalDAV server consumed by Apple Calendar, Thunderbird, DAVx5
- Dashboard — KPIs, production pipeline chart, harvest analytics, rack occupancy, contamination rate
- Label printing — Code 128 + QR labels for Zebra GK420d (50×30 mm, 203 dpi)
- PWA — installable on phones / tablets, offline scan queue replays on reconnect
- Multi-language UI — German, English, Portuguese
以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗
