Settings Guide

Complete reference for all Guardian Eye configuration options with visual examples.

Main Window

The main window displays live camera feeds with motion detection indicators. You can view multiple cameras simultaneously in a grid layout.

Guardian Eye Main Window

๐Ÿ“น Live View

Real-time video from all connected cameras with low latency.

๐ŸŽฏ Motion Indicator

Visual feedback when motion is detected on any camera.

โš™๏ธ Quick Settings

Access settings directly from the toolbar.

Appearance Settings

Appearance Settings

๐ŸŽจ Theme

Choose your preferred color scheme.

System Follows your OS theme (light/dark)
Light Bright interface for daytime use
Dark Dark interface, easier on eyes at night

๐ŸŒ Language

Select interface language.

๐Ÿ‡บ๐Ÿ‡ธ English ๐Ÿ‡ท๐Ÿ‡บ ะ ัƒััะบะธะน ๐Ÿ‡ฉ๐Ÿ‡ช Deutsch ๐Ÿ‡ซ๐Ÿ‡ท Franรงais

Motion Detection Settings

Motion Detection Settings

๐ŸŽš๏ธ Sensitivity

How sensitive the detector is to pixel changes.

Range: 0 - 255
Default: 25
Tip: Lower = more sensitive, may cause false alarms

๐Ÿ“ Min/Max Motion Area

Percentage of frame that must change to trigger.

Min Area: 0.5% โ€” filters noise
Max Area: 50% โ€” filters light changes

๐Ÿ’ก If whole image changes (>50%), it's probably lighting, not motion.

โฑ๏ธ Cooldown

Wait time after detection before next trigger.

Range: 0 - 3600 seconds
Default: 5 seconds

๐Ÿ’ก Prevents spam notifications during continuous motion.

Recording Settings

Recording Settings

๐Ÿ“ Output Path

Where recordings are saved.

./recordings

๐Ÿ’ก Use SSD for best performance with multiple cameras.

๐ŸŽฌ Format & Codec

Format: mp4, mkv, avi
Codec: libx264 (H.264) recommended
Bitrate: 2000 kbps (720p)

โฑ๏ธ Segment Duration

Split recordings into files of this length.

Range: 1 - 60 minutes
Default: 10 minutes

๐Ÿ’ก Shorter = easier to find events, more files to manage.

๐ŸŽž๏ธ Recording FPS

Frames per second for saved video.

Default: 15 FPS
Tip: 15 FPS saves 50% storage vs 30 FPS

Storage Rotation

Storage Settings

๐Ÿ’พ Max Storage Size

Maximum disk space for recordings.

Default: 10,240 MB (10 GB)
Behavior: Oldest files deleted when limit reached

๐Ÿ’ก Set to 0 for unlimited (manage manually).

๐Ÿ“… Max Age (Days)

Delete recordings older than this.

Default: 7 days
Free plan: 7 days max
Home plan: 30 days
Pro plan: Unlimited

๐Ÿ”„ Check Interval

How often to check storage limits.

Default: 30 minutes

๐Ÿ’ก Lower = more responsive cleanup, slightly more CPU.

๐Ÿ“Š Storage Calculator

Estimate how much storage you'll need:

~1.5 GB
per camera/day
720p @ 15fps, 2000kbps
~10 GB
1 camera/week
7 days retention
~40 GB
4 cameras/week
Home plan typical
~180 GB
4 cameras/month
30 days retention