# tsamouridis/oz-automatic-recorder architecture

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

- Interactive diagram: https://gitdiagram.com/tsamouridis/oz-automatic-recorder
- Repository: https://github.com/tsamouridis/oz-automatic-recorder

## Overview

OZ Automatic Recorder is a Windows desktop app for scheduling Zoom meetings and controlling OBS recordings. The user enters a meeting link, weekday, start time, and duration; the app saves the schedule, periodically checks it, opens the meeting and starts OBS at the scheduled time, then stops both at the calculated end time. The GUI also supports browsing and deleting schedules and configuring the OBS executable path. The graph reflects the shown GUI and recording logic; other source files were not inspected, so their behavior is omitted.

Main entry points: [`src/autoRecord.py`](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/autoRecord.py) (End-time check), [`src/gui.py`](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py) (Tkinter GUI), [`src/fileHandler.py`](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/fileHandler.py) (Path and completion files), [`src/__main__.py`](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/__main__.py) (App entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_entry["App entry point<br/>[__main__.py]"]
  node_gui["Tkinter GUI<br/>[gui.py]"]
  node_scheduler_ui["Schedule management<br/>[gui.py]"]
  node_path_ui["OBS path settings<br/>[gui.py]"]
end

subgraph group_recording["Recording control"]
  node_poller["Periodic runner<br/>[gui.py]"]
  node_start_check["Start-time check<br/>[autoRecord.py]"]
  node_end_check["End-time check<br/>[autoRecord.py]"]
end

subgraph group_storage["File-backed state"]
  node_schedule_store[("Schedule files<br/>[fileHandler.py]")]
  node_settings_store[("Path and completion files<br/>[fileHandler.py]")]
end

node_user(("User"))
node_browser["Default browser"]
node_obs["OBS Studio"]
node_zoom["Zoom process"]

node_user -->|"uses"| node_gui
node_entry -->|"creates"| node_gui
node_gui -->|"opens"| node_scheduler_ui
node_gui -->|"opens"| node_path_ui
node_gui -->|"starts"| node_poller
node_scheduler_ui -->|"saves and manages"| node_schedule_store
node_path_ui -->|"saves path"| node_settings_store
node_poller -->|"calls"| node_start_check
node_poller -->|"calls"| node_end_check
node_start_check -->|"reads schedules"| node_schedule_store
node_start_check -->|"reads OBS path"| node_settings_store
node_end_check -->|"reads schedules"| node_schedule_store
node_end_check -->|"checks completion"| node_settings_store
node_start_check -->|"opens meeting link"| node_browser
node_start_check -->|"starts recording"| node_obs
node_end_check -->|"terminates process"| node_obs
node_end_check -->|"terminates process"| node_zoom
node_end_check -->|"marks completed"| node_settings_store

click node_entry "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/__main__.py"
click node_gui "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py"
click node_scheduler_ui "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py"
click node_path_ui "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py"
click node_poller "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py"
click node_start_check "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/autoRecord.py"
click node_end_check "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/autoRecord.py"
click node_schedule_store "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/fileHandler.py"
click node_settings_store "https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/fileHandler.py"

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_entry,node_gui,node_scheduler_ui,node_path_ui,node_user,node_browser toneBlue
class node_poller,node_start_check,node_end_check toneAmber
class node_schedule_store,node_settings_store toneMint
class node_obs,node_zoom toneIndigo
```

## Components

### Desktop interface

- [App entry point](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/__main__.py): `src/__main__.py`
- [Tkinter GUI](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py): `src/gui.py`
- [Schedule management](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py): `src/gui.py`
- [OBS path settings](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py): `src/gui.py`

### Recording control

- [Periodic runner](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/gui.py): `src/gui.py`
- [Start-time check](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/autoRecord.py): `src/autoRecord.py`
- [End-time check](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/autoRecord.py): `src/autoRecord.py`

### File-backed state

- [Schedule files](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/fileHandler.py): `src/fileHandler.py`
- [Path and completion files](https://github.com/tsamouridis/oz-automatic-recorder/blob/master/src/fileHandler.py): `src/fileHandler.py`

### Other components

- **User**
- **Default browser**
- **OBS Studio**
- **Zoom process**

## Connections

- User → Tkinter GUI: uses (evidence: `README.md`)
- App entry point → Tkinter GUI: creates (evidence: `src/__main__.py`)
- Tkinter GUI → Schedule management: opens (evidence: `src/gui.py`)
- Tkinter GUI → OBS path settings: opens (evidence: `src/gui.py`)
- Tkinter GUI → Periodic runner: starts (evidence: `src/gui.py`)
- Schedule management → Schedule files: saves and manages (evidence: `src/gui.py`)
- OBS path settings → Path and completion files: saves path (evidence: `src/gui.py`)
- Periodic runner → Start-time check: calls (evidence: `src/gui.py`)
- Periodic runner → End-time check: calls (evidence: `src/gui.py`)
- Start-time check → Schedule files: reads schedules (evidence: `src/autoRecord.py`)
- Start-time check → Path and completion files: reads OBS path (evidence: `src/autoRecord.py`)
- End-time check → Schedule files: reads schedules (evidence: `src/autoRecord.py`)
- End-time check → Path and completion files: checks completion (evidence: `src/autoRecord.py`)
- Start-time check → Default browser: opens meeting link (evidence: `src/autoRecord.py`)
- Start-time check → OBS Studio: starts recording (evidence: `src/autoRecord.py`)
- End-time check → OBS Studio: terminates process (evidence: `src/autoRecord.py`)
- End-time check → Zoom process: terminates process (evidence: `src/autoRecord.py`)
- End-time check → Path and completion files: marks completed (evidence: `src/autoRecord.py`)
