# vijayaragavanse/screendefender architecture

> Architecture diagram of the GitHub repository vijayaragavanse/screendefender, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vijayaragavanse/screendefender
- Repository: https://github.com/vijayaragavanse/screendefender

## Overview

ScreenDefender is a Windows command-line utility that creates per-monitor watermark overlays, with an option to mark those overlay windows as capture-excluded. The principal workflow parses text, image-path, or base64-file options, starts the overlay thread, enumerates monitors, and renders refreshed watermark layers. The README also claims broader screenshot and screen-sharing blocking and secure display mode; the sampled implementation shows display-affinity settings on overlay windows, but not system-wide capture prevention. The graph reflects calls visible in sampled source and README-documented capabilities; unsampled internals are not inferred.

Main entry points: [`src/overlay.cpp`](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp) (Monitor windows), [`src/main.cpp`](https://github.com/vijayaragavanse/screendefender/blob/main/src/main.cpp) (Option parsing), [`src/watermark.cpp`](https://github.com/vijayaragavanse/screendefender/blob/main/src/watermark.cpp) (Watermark bitmap), [`README.md`](https://github.com/vijayaragavanse/screendefender/blob/main/README.md) (Secure display mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Configuration and runtime"]
  node_cli["Option parsing<br/>[main.cpp]"]
  node_thread["Overlay thread<br/>[overlay.cpp]"]
end

subgraph group_display["Overlay management"]
  node_monitor["Monitor windows<br/>[overlay.cpp]"]
  node_affinity["Capture affinity<br/>[overlay.cpp]"]
  node_refresh["Refresh and rebuild<br/>[overlay.cpp]"]
  node_grid["Watermark placement<br/>[overlay.cpp]"]
  node_secure["Secure display mode<br/>[README.md]"]
end

subgraph group_render["Watermark rendering"]
  node_bitmap["Watermark bitmap<br/>[watermark.cpp]"]
  node_text["Text conversion<br/>[watermark.cpp]"]
end

subgraph group_image["Image input"]
  node_base64["Base64 validation<br/>[base64.cpp]"]
  node_image["Image loading<br/>[overlay.cpp]"]
end

node_user(("Operator"))
node_capture(("Capture and sharing tools"))

node_user -->|"sets options"| node_cli
node_cli -->|"starts"| node_thread
node_thread -->|"enumerates monitors"| node_monitor
node_monitor -->|"sets affinity"| node_affinity
node_monitor -->|"computes positions"| node_grid
node_monitor -->|"loads image"| node_image
node_image -->|"validates and decodes"| node_base64
node_thread -->|"refreshes overlays"| node_refresh
node_refresh -->|"requests bitmap"| node_bitmap
node_bitmap -->|"converts text"| node_text
node_capture -.->|"blocked by feature"| node_secure
node_user -.->|"enables capture protection"| node_secure

click node_cli "https://github.com/vijayaragavanse/screendefender/blob/main/src/main.cpp"
click node_thread "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_monitor "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_affinity "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_refresh "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_bitmap "https://github.com/vijayaragavanse/screendefender/blob/main/src/watermark.cpp"
click node_text "https://github.com/vijayaragavanse/screendefender/blob/main/src/watermark.cpp"
click node_grid "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_base64 "https://github.com/vijayaragavanse/screendefender/blob/main/src/base64.cpp"
click node_image "https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp"
click node_secure "https://github.com/vijayaragavanse/screendefender/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_thread toneBlue
class node_monitor,node_affinity,node_refresh,node_grid,node_secure toneAmber
class node_bitmap,node_text toneMint
class node_base64,node_image toneRose
class node_user,node_capture toneIndigo
```

## Components

### Configuration and runtime

- [Option parsing](https://github.com/vijayaragavanse/screendefender/blob/main/src/main.cpp): `src/main.cpp`
- [Overlay thread](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`

### Overlay management

- [Monitor windows](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`
- [Capture affinity](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`
- [Refresh and rebuild](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`
- [Watermark placement](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`
- [Secure display mode](https://github.com/vijayaragavanse/screendefender/blob/main/README.md): `README.md`

### Watermark rendering

- [Watermark bitmap](https://github.com/vijayaragavanse/screendefender/blob/main/src/watermark.cpp): `src/watermark.cpp`
- [Text conversion](https://github.com/vijayaragavanse/screendefender/blob/main/src/watermark.cpp): `src/watermark.cpp`

### Image input

- [Base64 validation](https://github.com/vijayaragavanse/screendefender/blob/main/src/base64.cpp): `src/base64.cpp`
- [Image loading](https://github.com/vijayaragavanse/screendefender/blob/main/src/overlay.cpp): `src/overlay.cpp`

### Other components

- **Operator**
- **Capture and sharing tools**

## Connections

- Operator → Option parsing: sets options (evidence: `src/main.cpp`)
- Option parsing → Overlay thread: starts (evidence: `src/main.cpp`)
- Overlay thread → Monitor windows: enumerates monitors (evidence: `src/overlay.cpp`)
- Monitor windows → Capture affinity: sets affinity (evidence: `src/overlay.cpp`)
- Monitor windows → Watermark placement: computes positions (evidence: `src/overlay.cpp`)
- Monitor windows → Image loading: loads image (evidence: `src/overlay.cpp`)
- Image loading → Base64 validation: validates and decodes (evidence: `src/overlay.cpp`)
- Overlay thread → Refresh and rebuild: refreshes overlays (evidence: `src/overlay.cpp`)
- Refresh and rebuild → Watermark bitmap: requests bitmap (evidence: `src/overlay.cpp`)
- Watermark bitmap → Text conversion: converts text (evidence: `src/watermark.cpp`)
- Capture and sharing tools → Secure display mode: blocked by feature (evidence: `README.md`)
- Operator → Secure display mode: enables capture protection (evidence: `README.md`)
