Scrypted Privacy Manager

A Scrypted plugin that provides granular privacy controls for cameras, allowing you to disable recording, events, streaming, and detection on a per-camera basis with time-based scheduling.

Features

Per-Camera Privacy Controls

• Block Recording: Prevent video from being recorded
• Block Events: Suppress motion and detection events
• Block Streaming: Block live video streaming and snapshots
• Block Detection: Disable object detection processing
• Block Motion Alerts: Suppress motion detection notifications

Privacy Profiles

Create named profiles that apply settings to groups of cameras:

• Night Mode: Indoor cameras OFF, outdoor cameras ON
• Away Mode: All cameras ON
• Home Mode: Indoor cameras OFF during the day
• Custom profiles: Create your own

Time-Based Scheduling

Configure automatic privacy based on time:

• Daily: Apply privacy settings every day
• Weekdays: Monday through Friday only
• Weekends: Saturday and Sunday only
• Custom: Select specific days

Example: Disable indoor camera recording from 8 AM to 10 PM on weekdays.

Panic Mode (Quick Toggle)

One-click button to immediately block ALL cameras:

• Overrides all settings, schedules, and profiles
• Exposed as a Home Assistant switch for automation

Home Assistant Integration

All profiles and panic mode are exposed as switches:

• switch.privacy_panic_mode
• switch.privacy_night_mode
• switch.privacy_away_mode
• etc.

Webhook Notifications

HTTP POST notifications when privacy settings change:

{
  "event": "privacy_changed",
  "timestamp": "2024-01-08T10:30:00Z",
  "camera": "Living Room Camera",
  "cameraId": "abc123",
  "settings": {
    "blockRecording": true,
    "blockEvents": true,
    "blockStreaming": false,
    "blockDetection": true,
    "blockMotionAlerts": true
  },
  "trigger": "schedule"
}

Audit Logging

Track all privacy setting changes:

• Timestamp
• Camera affected
• Previous and new settings
• Trigger (manual, schedule, profile, panic)

Installation

From NPM

npm install @blueharford/scrypted-privacy-manager

In Scrypted

1. Go to Plugins in the Scrypted web interface
2. Click Install Plugin
3. Search for "Privacy Manager" or paste the NPM package name
4. Click Install

Configuration

Global Settings

Access via Plugins > Privacy Manager > Settings:

| Setting | Description | |---------|-------------| | Panic Mode | Emergency: Block ALL cameras immediately | | Default Settings | Default privacy settings for new cameras | | Webhook URL | HTTP endpoint for notifications | | Webhook Events | Which events trigger webhooks | | Audit Log Retention | Days to keep audit entries |

Per-Camera Settings

Each camera will have a Privacy Controls section in its settings:

| Setting | Description | |---------|-------------| | Enable Privacy Controls | Master switch for this camera | | Block Recording | Prevent recording | | Block Events | Suppress events | | Block Streaming | Block live video | | Block Detection | Disable object detection | | Block Motion Alerts | Suppress motion alerts | | Enable Schedule | Use time-based automation | | Schedule Type | Daily/Weekdays/Weekends/Custom | | Privacy Start Time | When privacy mode activates | | Privacy End Time | When privacy mode deactivates |

Creating Profiles

1. Go to Plugins > Privacy Manager
2. Click Add New Device
3. Enter a profile name (e.g., "Night Mode")
4. Configure the profile:
   • Select cameras to include
   • Set which privacy options to apply
5. Toggle the profile on/off as needed

HTTP API

The plugin exposes HTTP endpoints:

GET /status

Returns current status:

{
  "panicMode": false,
  "profiles": [
    { "id": "profile-123", "name": "Night Mode", "active": true, "cameraCount": 3 }
  ],
  "schedules": {
    "totalSchedules": 5,
    "activeSchedules": 2
  }
}

GET /audit

Returns audit log as JSON.

POST /panic

Enable/disable panic mode:

{ "enabled": true }

Use Cases

Indoor Cameras During Day

Disable recording on indoor cameras while you're home:

1. Create a profile "Home Mode"
2. Add all indoor cameras
3. Enable: Block Recording, Block Events, Block Detection
4. Set schedule: Daily, 8:00 AM - 10:00 PM

Privacy When Working From Home

Disable office camera during work hours:

1. Go to office camera settings
2. Enable schedule
3. Type: Weekdays
4. Start: 09:00, End: 17:00

Instant Privacy

Need immediate privacy?

1. Open Scrypted or Home Assistant
2. Turn on "Privacy: Panic Mode"
3. All cameras immediately stop recording/streaming

Development

Building

npm install
npm run build

Local Development

npm run scrypted-deploy-debug

License

Apache-2.0

Author

blueharford

Links

• NPM Package
• GitHub Repository
• Scrypted