# urmasrehkalt/zoom-controls architecture

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

- Interactive diagram: https://gitdiagram.com/urmasrehkalt/zoom-controls
- Repository: https://github.com/urmasrehkalt/zoom-controls

## Overview

Zooom is a native macOS menu-bar helper for hiding Zoom sharing controls and restoring them later. The main workflow is: the app detects sharing through Zoom’s Accessibility window tree, updates session state, and hides selected windows; a shortcut or menu action can reveal them, while retained recovery state supports restoration. Preferences control automatic hiding and window selection. The graph includes the sampled runtime modules and README-documented capabilities. Source excerpts support the shown calls; live Zoom behavior is explicitly experimental.

Main entry points: [`Sources/Zooom/main.swift`](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/main.swift) (App delegate), [`Sources/Zooom/Accessibility.swift`](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/Accessibility.swift) (Zoom window inspection), [`Sources/Zooom/WindowVisibility.swift`](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/WindowVisibility.swift) (Visibility coordinator), [`Sources/ZooomCore/Geometry.swift`](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/Geometry.swift) (Window recovery state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Menu-bar controls"]
  node_app["App delegate<br/>[main.swift]"]
  node_menuicon["Menu icon<br/>[MenuIcon.swift]"]
  node_preferences[("Saved preferences<br/>[main.swift]")]
end

subgraph group_detection["Sharing detection"]
  node_session["Sharing session"]
  node_accessibility["Zoom window inspection"]
  node_toolbar["Toolbar matching"]
end

subgraph group_visibility["Window visibility and recovery"]
  node_visibility["Visibility coordinator"]
  node_recovery["Window recovery state<br/>[Geometry.swift]"]
  node_geometry["Window geometry<br/>[Geometry.swift]"]
end

subgraph group_platform["macOS and Zoom"]
  node_zoom["Zoom desktop app"]
  node_macos["macOS Accessibility and displays"]
end

node_user(("User"))

node_user -->|"uses menu or shortcut"| node_app
node_app -->|"creates icon"| node_menuicon
node_app -->|"loads and saves"| node_preferences
node_app -->|"queries windows"| node_accessibility
node_app -->|"updates session"| node_session
node_app -->|"hides and restores"| node_visibility
node_accessibility -->|"matches controls"| node_toolbar
node_visibility -->|"reads and moves windows"| node_accessibility
node_visibility -->|"tracks parked windows"| node_recovery
node_recovery -->|"calculates and verifies"| node_geometry
node_accessibility -->|"inspects window tree"| node_zoom
node_accessibility -->|"uses Accessibility and display APIs"| node_macos
node_visibility -->|"hides or unhides app"| node_zoom
node_geometry -->|"uses screen bounds"| node_macos

click node_app "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/main.swift"
click node_menuicon "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/MenuIcon.swift"
click node_preferences "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/main.swift"
click node_session "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/SharingSession.swift"
click node_accessibility "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/Accessibility.swift"
click node_toolbar "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/SharingToolbar.swift"
click node_visibility "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/WindowVisibility.swift"
click node_recovery "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/Geometry.swift"
click node_geometry "https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/Geometry.swift"

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_app,node_menuicon,node_preferences,node_user toneBlue
class node_session,node_accessibility,node_toolbar toneAmber
class node_visibility,node_recovery,node_geometry toneMint
class node_zoom,node_macos toneRose
```

## Components

### Menu-bar controls

- [App delegate](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/main.swift): `Sources/Zooom/main.swift`
- [Menu icon](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/MenuIcon.swift): `Sources/Zooom/MenuIcon.swift`
- [Saved preferences](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/main.swift): `Sources/Zooom/main.swift`

### Sharing detection

- [Sharing session](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/SharingSession.swift): `Sources/ZooomCore/SharingSession.swift`
- [Zoom window inspection](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/Accessibility.swift): `Sources/Zooom/Accessibility.swift`
- [Toolbar matching](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/SharingToolbar.swift): `Sources/ZooomCore/SharingToolbar.swift`

### Window visibility and recovery

- [Visibility coordinator](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/Zooom/WindowVisibility.swift): `Sources/Zooom/WindowVisibility.swift`
- [Window recovery state](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/Geometry.swift): `Sources/ZooomCore/Geometry.swift`
- [Window geometry](https://github.com/urmasrehkalt/zoom-controls/blob/main/Sources/ZooomCore/Geometry.swift): `Sources/ZooomCore/Geometry.swift`

### macOS and Zoom

- **Zoom desktop app**
- **macOS Accessibility and displays**

### Other components

- **User**

## Connections

- User → App delegate: uses menu or shortcut (evidence: `README.md`)
- App delegate → Menu icon: creates icon (evidence: `Sources/Zooom/main.swift`)
- App delegate → Saved preferences: loads and saves (evidence: `Sources/Zooom/main.swift`)
- App delegate → Zoom window inspection: queries windows (evidence: `Sources/Zooom/main.swift`)
- App delegate → Sharing session: updates session (evidence: `Sources/Zooom/main.swift`)
- App delegate → Visibility coordinator: hides and restores (evidence: `Sources/Zooom/main.swift`)
- Zoom window inspection → Toolbar matching: matches controls (evidence: `Sources/Zooom/Accessibility.swift`)
- Visibility coordinator → Zoom window inspection: reads and moves windows (evidence: `Sources/Zooom/WindowVisibility.swift`)
- Visibility coordinator → Window recovery state: tracks parked windows (evidence: `Sources/Zooom/WindowVisibility.swift`)
- Window recovery state → Window geometry: calculates and verifies (evidence: `Sources/ZooomCore/Geometry.swift`)
- Zoom window inspection → Zoom desktop app: inspects window tree (evidence: `Sources/Zooom/Accessibility.swift`)
- Zoom window inspection → macOS Accessibility and displays: uses Accessibility and display APIs (evidence: `Sources/Zooom/Accessibility.swift`)
- Visibility coordinator → Zoom desktop app: hides or unhides app (evidence: `Sources/Zooom/WindowVisibility.swift`)
- Window geometry → macOS Accessibility and displays: uses screen bounds
