Skip to content

EddiePiazza/schedule-4-real

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Schedule 4 Real

WHERE REAL GROWERS COME TO PLAY

Grow control • Genetics lab • Plant diagnostics • Grow encyclopedia • 3D multiplayer

https://schedule4real.com

Install Spider Farmer Encrypted 3D Game Home Assistant

Platforms Architectures License Local First


Table of Contents


Quick Install

curl -fsSL https://schedule4real.com/dist/install/install.sh | sudo bash

The installer sets up everything automatically: Node.js, MQTT broker, time-series database, TLS proxy, and all services. Your grow room will be online in under 5 minutes.

Supported Platforms

Platform Method Notes
Linux x86-64 Native Recommended. Debian, Ubuntu, etc.
Linux ARM64 Native Raspberry Pi 4/5 (2 GB+ RAM)
Windows WSL or VirtualBox Full functionality via Linux VM
macOS Docker Intel & Apple Silicon

Requirements

Minimum
RAM 2 GB
Storage 10 GB
Network Same LAN as your grow modules

ARM 32-bit (Raspberry Pi 3 and older) is not supported.


What Is Schedule 4 Real?

Schedule 4 Real is a locally-hosted grow room control platform that gives you full ownership of your Spider Farmer GGS devices — no cloud, no subscriptions, no data leaving your network. It intercepts and reverse-engineers the MQTT protocol used by Spider Farmer modules, letting you monitor sensors, automate outlets, schedule lights, and control everything from a modern web interface on any device.

But this is not just another controller app.

Schedule 4 Real integrates a complete plant genetics laboratory for tracking strains, breeding projects, phenotype hunts, clones, and full grow cycle journals. A pheno hunt system with weighted scoring across six categories, radar charts, and a Keeper Engine helps you identify your best mother plants. A built-in grow encyclopedia with 1,000+ searchable terms covers nutrients, diseases, pests, deficiencies, training techniques, and equipment — with an interactive diagnostic tool that walks you through identifying plant problems step by step (location → symptoms → probable causes with remedies). It includes a visual automation engine where you build complex trigger flows by wiring nodes together. And it wraps everything inside a first-person 3D game where you can walk through virtual rooms, place interactive objects, control your real devices from in-game switches, and invite anyone into fully anonymous, end-to-end encrypted multiplayer sessions — no accounts, no tracking, no metadata leaks.

The game isn't just for growers. It's for anyone who wants to learn about cultivation, explore the encyclopedia, try the diagnostic tools, or simply have a private space to hang out with friends. The communication protocol is built on onion-routed circuits with military-grade cryptography, and its source code is public.

Spider Farmer Compatibility

Currently compatible with the full Spider Farmer GGS ecosystem:

  • Spider Farmer Power Strip 5 (PS5) — 5 outlets, exhaust fan, circulation fan, environment sensors, soil probes
  • Spider Farmer Light Controller (LC) — dual channel grow lights with PPFD auto-control
  • Spider Farmer Control Box (CB) — combined outlet and light control

Future compatibility with other brands like AC Infinity and Grolab by Open Grow is being evaluated. The architecture is protocol-agnostic — new device integrations can be added without changing the core platform.


Dashboard

Real-time monitoring and control — everything at a glance.

Dashboard — Real-time environment monitoring

The dashboard gives you a live view of your entire grow environment. All sensor data updates in real time via WebSocket — no manual refresh needed.

  • Environment sensors — Temperature, humidity, VPD (air + leaf), CO2, updated every few seconds
  • Soil sensors — Up to 6 wireless probes showing soil temperature, moisture (%), and electrical conductivity (EC)
  • Day/Night statistics — Separate min, average, and max for each sensor during light-on and light-off periods
  • Socket control — 5 outlet sockets with instant on/off toggle and mode indicator badges
  • Light status — Brightness bar, current mode (Manual / TimeSlot / PPFD), countdown to next transition
  • Blower & fan — Speed percentage, wattage, animated rotation indicator
  • Power summary — Total consumption in watts, cost breakdown per socket, active device count
  • Event log — Timeline of socket state changes with timestamp and trigger source (manual or automation)
  • Charts — Temperature, humidity, VPD, CO2, wattage, blower/fan — from 1 hour to 90 days, with day/night shading and synced crosshair across all charts

Device Control

Full control over every Spider Farmer GGS module — configure modes, schedules, and automation rules per device.

Settings — Device configuration and environment targets

Outlets (O1–O5)

Each outlet supports 7 control modes:

Mode How it works
Manual Direct on/off toggle
Time Slot Up to 12 scheduled periods per day
Cycle Repeating intervals (e.g., 5 min on, 25 min off)
Temperature Auto-trigger when temp exceeds threshold
Humidity Auto-trigger when humidity exceeds threshold
CO2 Auto-trigger based on CO2 concentration
Drip Irrigation with soil moisture feedback from wireless probes

Lights

Mode How it works
Manual Direct brightness 0–100%
Time Slot Daily schedule with brightness per period
PPFD Auto Automatically adjusts intensity to hit target photosynthetic flux (umol/m2/s)

Sunrise/sunset simulation, dark temperature control, and per-light wattage configuration included.

Blower, Fan & Environment

  • Exhaust blower with speed curve editor (temperature-responsive speed ramp)
  • Circulation fan with oscillation modes and natural wind pattern
  • VPD auto-control — assign devices as extractors, humidifiers, or heaters with intelligent escalation
  • Environment targets for day/night temperature, humidity, VPD range, and CO2

Automation Engine

A visual node-based flow builder for creating complex automation rules — purpose-built for grow rooms.

Triggers — Visual automation flow builder

Drag nodes onto the canvas, wire them together, and let the system handle the rest. No coding required.

Node What it does
Condition Sensor threshold with operator, hysteresis, and separate day/night values
Schedule Time range or repeating interval with weekday selector
Action Toggle outlet, set light mode, control blower speed
Logic AND / OR gates to combine multiple conditions
VPD Control Automatic VPD management with device roles and phase-aware targets
Blower Curve Visual curve editor mapping temperature to fan speed
Note Annotate your flows with comments

Every execution is logged with timestamp, action taken, and sensor values at the time. Filter logs by 1H, 4H, 24H, or 7D. Global enable/disable lets you pause all automations with one click.


Plant Genetics Laboratory

A complete grow journal, strain library, breeding planner, and phenotype analysis tool — all in one place.

Laboratory — Plant genetics and grow journal

Grow Journal

Track every plant from seed to harvest across 15 lifecycle stages: Germination, Seedling, Early/Mid/Late Veg, Pre-Flower, Early/Mid/Late Flower, Flush, Harvest, Drying, Curing, and Archived. Each plant gets a day counter, photo gallery, and full observation timeline.

Observation System

Log plant health, height, notes, and photos through a step-by-step wizard. The system automatically captures environment data (temperature, humidity, VPD) at the moment of each observation. Stage-based reminders tell you when it's time to check your plants. When you flag pest, disease, or deficiency issues, the wizard opens a dedicated diagnostic step that guides you through identifying the problem — select affected areas, match visible symptoms, and get ranked probable causes with remedies.

Grow Encyclopedia

A searchable knowledge base with 1,000+ terms organized across domains: nutrients, diseases, pests, deficiencies, training methods, and grow equipment. Every entry includes detailed descriptions, visual guides, and stage-specific care recommendations. The encyclopedia is cross-linked with observations — diagnostic results link directly to the relevant encyclopedia entry for deeper reading. Supports metric and imperial units.

Plant Problem Diagnostic

An interactive 3-step diagnostic tool integrated into both the observation wizard and the encyclopedia:

  1. Affected Area — Select where on the plant you see the problem (upper leaves, lower leaves, stems, roots, flowers...)
  2. Symptoms — Match what it looks like (yellowing, spots, curling, wilting, discoloration patterns...)
  3. Results — Get probability-ranked diagnoses with descriptions, matching symptoms highlighted, and suggested remedies

The diagnostic considers your plant's current growth stage and grow medium to narrow down results. All diagnostic data is saved with the observation for historical tracking.

Strain Library

Catalog your genetics with breeder info, indica/sativa ratios, flowering times, seed type (regular, feminized, auto), and seed inventory. Link plants to strains for cross-strain performance comparison over time.

Breeding Projects

Plan and track crosses with defined goals — line creation, stabilization, backcross, pheno hunting, or seed production. Manage your pollen bank (collection dates, viability, strain) and visualize genetic lineage with tree diagrams.

Pheno Hunt & Keeper Selection

Score plants across 6 weighted categories (yield, potency, flavor, vigor, disease resistance, stability) using radar charts. Compare phenotypes side-by-side with photos. The Keeper Engine helps you identify the best mother plants based on your scoring profile (Standard, Commercial, Breeder, or Connoisseur).

Cameras & Timelapse

Connect IP cameras for live feeds, scheduled captures, and automatic timelapse compilation. Browse photo galleries organized by camera and date.

Reports

Harvest summaries, strain performance analytics, trend charts, and data export (CSV).


Schedule 4 Real Game

A first-person 3D sandbox where your grow room comes to life. Walk through virtual spaces, place objects, control real devices, and invite anyone — all within an encrypted multiplayer experience.

Lobby — Character selection and room browser

The lobby is your starting point. Pick a character, browse your rooms or discover public ones, and step into any 3D environment. Create rooms by uploading custom GLB models — your actual grow tent, an apartment, a warehouse, whatever you want.

The game is designed for two audiences:

  • Growers who want a visual, immersive way to monitor and control their cultivation — walk through your virtual room and flip real switches
  • Everyone else who wants a private sandbox to hang out, learn about growing, or just explore — no grow hardware needed to play

Anonymous & Encrypted Multiplayer

Invite anyone into your rooms. No accounts. No registration. No tracking. Every connection is routed through an encrypted onion network.

Encrypted multiplayer — Anonymous onion-routed connections

How It Works

You (Host)                 Relay Network                 Your Friend (Guest)
    |                           |                              |
    |--- 1-hop onion ---------> Tracker                        |
    |    (register room)        | stores encrypted blob        |
    |                           |                              |
    |                           |  <------ 1-hop onion --------|
    |                           |  (discover room)             |
    |                           |                              |
    |--- rendezvous cookie ---> Relay  <------ 2-hop onion ----|
    |                           | pairs both circuits          |
    |                           |                              |
    |<======= End-to-End encrypted channel (XChaCha20) =======>|
    |     voice, position, objects — relay CANNOT read this     |

Cryptography

Layer Primitive
Key exchange X25519 (Elliptic Curve Diffie-Hellman) per circuit hop
Encryption XChaCha20-Poly1305 AEAD per onion layer
Implementation libsodium (WASM, runs in browser)

Privacy Guarantees

  • No relay can decrypt your traffic — each hop only peels its own encryption layer
  • No tracker sees room contents — metadata encrypted with a key only you and your guests know
  • Your IP is hidden from guests — they connect through relays, never directly to you
  • No accounts or registration — guests join via encrypted invite tokens
  • Encrypted metadata — room names, invite codes, and connection details are encrypted before reaching the relay
  • Federated relays — anyone can run a relay node; gossip protocol connects them

The relay and onion routing source code is public. Even if every relay were compromised, the end-to-end encryption between host and guest remains unbreakable.


Inside a Room

Upload any 3D model (GLB format) as a room. Calibrate the floor and scale, choose an environment preset (Forest, Cyberpunk, Beach, Office...), and start decorating.

Room — First-person 3D environment

Navigate with WASD, sprint with Shift, jump with Space. On mobile, use the dual-stick virtual joystick (with left-handed mode). Full physics: gravity, collision detection, dynamic ground tracking, auto step-up on small obstacles. Head bob while walking, smooth camera movement, ambient dust particles in light beams, and a radial quick-action menu on Q.


Infinite Rooms & Doors

Create as many rooms as you want and interconnect them with doors. Each door can link to a different environment — build a hallway that connects your grow tent to a lounge, a shop, or a secret lab.

Infinite rooms — Interconnected environments with doors


Locked Doors & Private Zones

Put security keypads on any door. Only people who know the code can enter. Build a private "candy shop" behind a locked door — display your best genetics, your harvest collection, or anything you want to share exclusively with trusted visitors.

Locked door — Keypad security system


Sandbox Mode

Place furniture, decorations, screens, interactive objects — hundreds of 3D assets auto-discovered from the asset library. Move, rotate, scale, duplicate, lock objects in place. Build procedural grow tents with configurable dimensions, reflective mylar interiors, cloth door physics, and vent ports. Connect tents to fans and filters with flexible ducting tubes that use Verlet physics simulation. Every room is your canvas.

Sandbox — Place and arrange 3D objects


Real-Time Grow Control in 3D

Bind virtual objects to your real Spider Farmer devices. Display live sensor data on in-game screens. Flip switches that control actual outlets. Your grow room becomes an interactive 3D control panel.

In-game device control — Live sensor data and switches

  • Display zones — Show live temperature, humidity, VPD, CO2 on wall-mounted screens, with real-time sensor charts
  • Phone casting — Stream your phone's Spider Farmer app to an in-game display zone via SSE
  • Device switches — Bind any object to a real outlet or light; toggle with a click
  • Keypads — Program action chains that execute device commands
  • Behavior triggers — Automate actions when a player enters a zone

Voice Chat

Built-in voice chat over peer-to-peer WebRTC. No Discord, no third-party app — just talk while you walk. See who's speaking, mute yourself, and adjust volume, all inside the game. Voice data flows directly between players, never through our relay servers.

Multiplayer session — friends exploring together with voice chat


TV & Streaming

Place TVs in your rooms and tune into live IPTV channels. Browse by category (Sports, News, Music, Gaming), add custom m3u8 streams, save favorites. Watch together with friends in multiplayer.

In-game TV — IPTV streaming with channel browser


Complete Feature List

Dashboard & Monitoring

Feature
Real-time temperature, humidity, VPD, leaf VPD, CO2
Up to 6 wireless soil sensors (temp, moisture, EC)
Day/Night statistics (min, avg, max per period)
5 outlet sockets with instant toggle and mode badges
Dual light control (brightness, mode, countdown)
Blower speed, wattage, CO2 close indicator
Power consumption tracking with cost breakdown
Socket event log with trigger source
Charts: 1h to 90 days, synced crosshair, day/night shading
Custom device naming

Automation

Feature
Visual node-based flow editor
Sensor conditions with hysteresis and day/night thresholds
Time schedules (range + interval modes + weekday picker)
AND/OR logic gates
VPD auto-control with device role assignment
Fan curve editor (sensor-to-speed mapping)
Execution log with full audit trail
Global enable/disable

Laboratory

Feature
15-stage plant lifecycle tracking
Observation wizard with auto environment capture
Dedicated diagnostic step (affected area → symptoms → results)
Grow encyclopedia with 1,000+ searchable terms
Photo gallery with lightbox
Strain library (breeder, genetics, flowering time, inventory)
Breeding projects with pollen bank and genetic trees
Pheno hunt scoring with radar charts and Keeper Engine
Camera feeds, timelapse, scheduled captures
Reports, analytics, CSV export
Grow rooms with 2D floor plan and device binding
Notification system with reminders and alerts

3D Game

Feature
First-person navigation (WASD, sprint, jump)
Custom GLB room upload with floor calibration
Object placement (move, rotate, scale, duplicate, lock)
Environment presets and ambient lighting control
Interactive TVs with IPTV/HLS streaming
Keypads with security codes and door locks
Display zones (images, video, text, sensor charts, phone casting)
Device bindings (control real outlets/lights from 3D)
Behavior system (proximity triggers, action chains)
Procedural grow tent builder (frame, mylar, cloth door, vent ports)
Flexible ducting system (Verlet physics, connects tents to fans/filters)
Mobile joystick controls (dual-stick, left-handed mode)
Room mesh editor (toggle visibility, adjust polygon count)
Surface polygon tracing tool for interactive zones
Audio SFX engine with haptic feedback
Particle effects (dust motes in light beams)
Post-processing (bloom, FXAA, color correction)

Multiplayer

Feature
Anonymous join — no accounts, no registration
End-to-end encrypted (XChaCha20-Poly1305)
Onion-routed circuits (2-hop, relay-based)
Real-time player sync (20Hz, interpolated)
Voice chat (WebRTC peer-to-peer)
Public room browser via anonymous tracker
Invite tokens and 4-character room codes
Password-protected rooms
Federated relay network with gossip discovery
Open source communication protocol

System & Infrastructure

Feature
Service monitor with restart controls
Database backup and restore
Component-level auto-updates with changelog
Live MQTT message viewer (raw device traffic)
Optional relay node (contribute to the network)
90-day data retention with auto-cleanup
Fully local — works without internet
Home Assistant integration via MQTT auto-discovery
No telemetry, no analytics, no tracking

Installation Guide

Step 1 — Install

curl -fsSL https://schedule4real.com/dist/install/install.sh | sudo bash

The script installs and configures:

  • Node.js 22 (runtime)
  • Mosquitto (MQTT broker, ports 1883/1884/9001)
  • QuestDB (time-series database via Docker)
  • spiderproxy (TLS MITM proxy for Spider Farmer traffic)
  • PM2 (process manager for all services)
  • Web interface on port 3000

Step 2 — Network Setup (Required)

Your Spider Farmer modules talk to their cloud server on port 8883 (MQTT over TLS). You need to redirect that traffic to your Schedule 4 Real server so the proxy can intercept it.

On your router, create a NAT port redirect:

Setting Value
Protocol TCP
Source Any device on your LAN
Destination port 8883
Redirect to YOUR_SERVER_IP:8883
Router-specific examples

OPNsense / pfSense:

  • Firewall > NAT > Port Forward
  • Interface: LAN, Protocol: TCP
  • Destination: any, port 8883
  • Redirect target: SERVER_IP:8883

Linux (iptables):

iptables -t nat -A PREROUTING -p tcp --dport 8883 -j DNAT --to-destination SERVER_IP:8883

Generic routers:

  • Open router admin panel (usually 192.168.1.1)
  • Find NAT / Port Forwarding section
  • Add rule: external port 8883 TCP to internal SERVER_IP:8883

Tip: Assign a static IP (DHCP reservation) to both your server and your Spider Farmer modules for a stable setup.

Step 3 — Open the App

  • Local network: http://YOUR_SERVER_IP:3000
  • With a domain (optional): Set up a reverse proxy (Nginx, Caddy, LiteSpeed) with SSL

Optional — HTTPS

Some features require a secure context (HTTPS):

  • Voice chat (WebRTC)
  • Asset caching (Service Workers)
  • Remote access over the internet

Free SSL with Caddy:

caddy reverse-proxy --from yourdomain.com --to localhost:3000

Optional — Multiplayer Relay

To let friends join your rooms from outside your local network:

  • Forward port 9443 to your server, or
  • Proxy through your domain: location /rooms { proxy_pass http://localhost:9443; }

Your installation can also act as a public relay node to help other users connect — enable it from System > Relay.


Architecture

Spider Farmer Modules (PS5, LC, CB)
    | MQTT + TLS (port 8883)
    v
spiderproxy (TLS MITM)
    | Decrypts traffic, re-publishes locally
    | Optionally bridges to Spider Farmer cloud
    v
Mosquitto MQTT Broker (1883 / 1884 / 9001)
    |
    |---> mqtt-ingestion ---> QuestDB (90-day sensor history)
    |
    |---> Nuxt Server ------> WebSocket ---> Browser (real-time)
    |                    \---> REST API ---> Browser (control)
    |
    |---> supervisor -------> Trigger engine ---> Automated actions
    |
    |---> camera-service ---> Snapshots, timelapse

Tech Stack

Layer Technology
Frontend Nuxt 4 + Vue 3 + TypeScript + TailwindCSS
3D Engine THREE.js
Backend Nuxt Nitro (210+ API endpoints + WebSocket)
Database QuestDB (time-series, append-only)
MQTT Mosquitto
Proxy spiderproxy (PyInstaller binary)
Crypto libsodium-wrappers (WASM)
Video HLS.js
Voice WebRTC
Build Vite + esbuild + Docker buildx (ARM64)

Spider Farmer Compatibility

Schedule 4 Real works with the complete Spider Farmer GGS product line through reverse-engineered MQTT protocol integration:

Module Model What You Can Control
Spider Farmer Power Strip 5 SF-PS5 5 outlets (7 modes each), exhaust fan, circulation fan, environment sensors, up to 6 soil probes
Spider Farmer Light Controller SF-LC Light 1 + Light 2 (Manual, TimeSlot, Cycle, PPFD Auto), sunrise/sunset simulation
Spider Farmer Control Box SF-CB Combined outlet + light control with fan management

The official Spider Farmer app continues to work alongside Schedule 4 Real. The cloud bridge is maintained by default — you get local control AND cloud access simultaneously.

Home Assistant Integration

Bridge your Spider Farmer devices to Home Assistant via MQTT auto-discovery. Every sensor, outlet, and light channel is exposed as a native entity — integrate your grow room into your full home automation setup with zero cloud dependency.

Entity Type Examples
Sensors Temperature, humidity, VPD, leaf VPD, CO2, soil moisture, soil EC
Switches 5 outlet sockets with on/off control
Dimmers Light 1 + Light 2 brightness as number entities
Fans Blower and circulation fan speed control

All communication stays local — Home Assistant talks to Schedule 4 Real's MQTT broker on your LAN. No cloud service, no API keys, no internet required.

Keywords: Spider Farmer GGS, Spider Farmer Power Strip 5, Spider Farmer Light Controller, Spider Farmer Control Box, Spider Farmer local control, Spider Farmer automation, Spider Farmer alternative app, Spider Farmer MQTT, Spider Farmer grow controller, Spider Farmer smart controller, GGS grow controller, Spider Farmer home automation, Spider Farmer Home Assistant, SF-PS5, SF-LC, SF-CB, grow room controller, grow room automation, indoor grow controller, PPFD controller, VPD controller, Home Assistant grow room, MQTT grow controller, source available grow controller, self-hosted grow controller


Source Available & Self-Hosted

Schedule 4 Real runs entirely on your hardware. No cloud services, no subscriptions, no data leaving your network.

  • Source available — the onion relay network, encryption protocol, MQTT proxy, installer, and service infrastructure are fully open source. The web application is distributed as a compiled package while commercial partnerships with equipment brands are being finalized. A full open source release is planned for the future
  • Self-hosted — runs on a Raspberry Pi, a NUC, a Proxmox VM, or any Linux machine
  • Works offline — full functionality without internet access
  • Zero telemetry — nothing phones home, no analytics, no crash reports
  • Auto-updates — component-level updates with SHA-256 verification and automatic rollback on failure
  • Backup & restore — one-click database backups, downloadable, restorable to any point

Community

Discord


Sponsor

Schedule 4 Real is sponsored by WEEDLIX.


schedule4real.com

About

Schedule 4 Real: control your real grow from a 3D game. SpiderFarmer integration, grow journals, breeding planner, phenotype tracking & camera feeds. Join an anonymous decentralized network — invite growers, share setups & trade cookies. No accounts, no tracking, fully encrypted.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors