classsend.conf

# ═══════════════════════════════════════════════════════════════
# ClassSend Configuration File
# ═══════════════════════════════════════════════════════════════
# This file is read at startup. Changes require a restart.
# Lines starting with # are comments and are ignored.
# Syntax: key = value
# ═══════════════════════════════════════════════════════════════


# ── ROLE ──────────────────────────────────────────────────────
# Installation role of this machine.
# Values: teacher | student
# The installer writes this to the Windows Registry automatically.
# Override here only if you need to change it without reinstalling.
role = teacher


# ── SERVER ────────────────────────────────────────────────────
# Port the ClassSend server listens on (default: 3000).
# All devices in the class must be able to reach this port.
port = 3000

# Enable TLS/HTTPS encryption (default: false).
# Requires certificate files in the installation directory.
use_tls = false


# ── AUTOSTART ─────────────────────────────────────────────────
# Start ClassSend automatically when Windows boots (default: true).
# In packaged installs this is managed by the NSIS installer via a
# Scheduled Task. Toggle this to register/unregister it on next launch.
autostart = true


# ── INTERNET CONTROL ──────────────────────────────────────────
# Restore internet blocking on startup if it was active when the
# app last closed (default: true). Set to false to always start
# with internet access regardless of the previous session state.
restore_internet_on_startup = true


# ── FILE TRANSFERS ────────────────────────────────────────────
# Maximum upload file size in megabytes (default: 1536 = 1.5 GB).
# Increase if students need to send larger files. Note: the socket
# buffer below must be at least as large.
max_file_size_mb = 1536


# ── STREAMING & SCREEN MONITORING ─────────────────────────────
# Resolution used for the standard overview grid (all students visible).
# Values: low (320×180) | 1080p (1920×1080) | 1440p (2560×1440) | 4k (3840×2160)
screen_capture_quality = low

# Resolution used when focusing on a single student (high-res mode).
# Values: 1080p (1920×1080) | 1440p (2560×1440) | 4k (3840×2160)
screen_capture_hires_quality = 1080p

# Target streaming bandwidth in Mbit/s. Controls JPEG compression per frame.
# Higher = sharper image but more network usage.
# Values: 8 | 16 | 32 | 64
screen_capture_speed_mbit = 16

# Internal Socket.IO message buffer in megabytes (default: 2048 = 2 GB).
# Must be >= max_file_size_mb. Raise only if transfers stall on large files.
socket_buffer_size_mb = 2048


# ── LOGGING ───────────────────────────────────────────────────
# Print detailed diagnostic logs to the Electron console (default: false).
enable_logging = false

# Save all session logs to ~/classSendReport.txt (default: false).
# A new file is created (overwriting the previous one) on each startup.
#
# STARTUP CRASH DEBUGGING
# If ClassSend won't open at all, enable this setting to capture the error:
#   1. Set  auto_export_logs = true  below
#   2. Restart ClassSend (even if it immediately closes)
#   3. Open  %USERPROFILE%\classSendReport.txt  to read the startup error
# Both uncaught exceptions and unhandled promise rejections are captured,
# including errors that occur before the main window appears.
auto_export_logs = false


# ── AI CONTENT FILTERING ──────────────────────────────────────
# Automatically block student messages flagged by the AI (default: true).
block_enabled = true

# Block sensitivity threshold (0–100, default: 90).
# Higher = less sensitive (fewer false positives).
# Lower = more aggressive blocking.
block_threshold = 90

# Automatically flag messages for teacher review (default: true).
report_enabled = true

# Reporting confidence threshold (0–100, default: 20).
# Lower = more messages get flagged to the teacher.
# Higher = only high-confidence violations are reported.
report_threshold = 20