requirements.txt

# LEDMatrix Core Dependencies
# Compatible with Python 3.10, 3.11, 3.12, and 3.13
# Tested on Raspbian OS 12 (Bookworm) and 13 (Trixie)

# Image processing
Pillow>=12.2.0,<13.0.0
numpy>=1.24.0  # For fast array operations in ScrollHelper (compatible with 2.x)

# Timezone handling
pytz>=2024.2,<2025.0  # Updated for latest timezone data

# HTTP requests
requests>=2.33.0,<3.0.0
urllib3>=2.7.0,<3.0.0  # requests transitive, but imported directly (urllib3.util.retry.Retry); floor is a security floor, not the API floor — 1.26.x carries ~10 CVEs

# Google API integration

# Font rendering
freetype-py>=2.5.1,<3.0.0

# Spotify integration (used by web_interface/blueprints/api_v3.py OAuth endpoints)
spotipy>=2.25.2,<3.0.0

# Flask web framework
Flask>=3.1.3,<4.0.0

# WebSocket support: intentionally NOT declared here. Plugins that need
# it (e.g. ledmatrix-music's Socket.IO client) declare it in their own
# requirements.txt, which the plugin store installs.

# JSON Schema validation
jsonschema>=4.20.0,<5.0.0

# Requirement specifier parsing (plugin dependency satisfaction checks)
packaging>=23.0,<27.0

# Testing dependencies live in requirements-test.txt:
#   pip install -r requirements.txt -r requirements-test.txt

# ───────────────────────────────────────────────────────────────────────
# Optional dependencies — the code imports these inside try/except
# blocks and gracefully degrades when missing. Install them for the
# full feature set, or skip them for a minimal install.
# ───────────────────────────────────────────────────────────────────────
#
# scipy             — sub-pixel interpolation in
#                     src/common/scroll_helper.py for smoother
#                     scrolling. Falls back to a simpler shift algorithm.
#   pip install 'scipy>=1.10.0,<2.0.0'
#
# psutil            — per-plugin resource monitoring in
#                     src/plugin_system/resource_monitor.py. The monitor
#                     silently no-ops when missing (PSUTIL_AVAILABLE = False).
#                     Note: web_interface/requirements.txt requires this
#                     range as a hard dependency — keep the two in sync.
#   pip install 'psutil>=6.0.0,<7.0.0'
#
# Flask-Limiter     — request rate limiting in web_interface/app.py
#                     (accidental-abuse protection, not security). The
#                     web interface starts without rate limiting when
#                     this is missing.
#   pip install 'Flask-Limiter>=3.5.0,<4.0.0'