Initial commit

README.md

@@ -0,0 +1,39 @@
+# NTSH Camera Runner
+
+A process monitoring service for the Nothing to See Here installation, designed to work with the main [NTSH-Control](https://git.morphix.nl/Nothing-to-See-Here/NTSH-Control) system.
+
+## Purpose
+
+Camera Runner monitors and manages the camera executable process, providing:
+
+-   Automatic process startup and crash recovery
+-   WebSocket communication on port `6301` for integration with [NTSH-Control](https://git.morphix.nl/Nothing-to-See-Here/NTSH-Control)
+-   Real-time process status and output logging
+-   Remote restart and system reboot capabilities
+
+## Configuration
+
+Configuration is stored in `~/MorphixProductions/NTSHControl/CameraRunner/config.json`:
+
+```json
+{
+	"socketServer": {
+		"port": 6301
+	},
+	"executable": {
+		"path": "",
+		"arguments": []
+	}
+}
+```
+
+## Integration
+
+This service is controlled by the main [NTSH-Control](https://git.morphix.nl/Nothing-to-See-Here/NTSH-Control) system via WebSocket communication. The main control system connects to `127.0.0.1:6301` to monitor status and send restart commands.
+
+## Process States
+
+-   `STARTING` - Process launching
+-   `RUNNING` - Process active and healthy
+-   `STOPPED` - Process terminated or crashed
+-   `PROBLEM` - Error condition detected