# jrtechofcdev/jrtech-wallpaper architecture

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

- Interactive diagram: https://gitdiagram.com/jrtechofcdev/jrtech-wallpaper
- Repository: https://github.com/jrtechofcdev/jrtech-wallpaper

## Overview

JR_TECH_OFC is an interactive Lively Wallpaper dashboard, with optional Windows media controls, browser progress reporting, and a matching lock-screen design. The main workflow runs from Lively data and user settings through the wallpaper’s shared runtime and feature modules to the rendered dashboard; media controls and weather also use external services. The README documents several integrations whose implementation details are not shown in the excerpts, so those links cite the README. Other edge evidence is limited to the sampled source.

Main entry points: [`wallpaper/js/core.js`](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/core.js) (Runtime core), [`wallpaper/js/lively-bridge.js`](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/lively-bridge.js) (Lively data bridge), [`media-bridge/JrTechMediaBridge.ps1`](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/media-bridge/JrTechMediaBridge.ps1) (Media Bridge), [`browser-extension/content.js`](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/browser-extension/content.js) (Player page agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wallpaper["Wallpaper runtime"]
  node_runtime["Runtime core<br/>[core.js]"]
  node_livelybridge["Lively data bridge<br/>[lively-bridge.js]"]
end

subgraph group_features["Dashboard features"]
  node_clock["Clock<br/>[clock.js]"]
  node_calendar["Calendar<br/>[calendar.js]"]
  node_hardware["System monitor<br/>[hardware.js]"]
  node_weather["Weather panel<br/>[weather.js]"]
  node_audio["Audio visualizer<br/>[audio.js]"]
  node_brandfield["Reactive background<br/>[brandfield.js]"]
end

subgraph group_media["Media controls"]
  node_mediaui["Music player<br/>[media.js]"]
  node_bridge["Media Bridge"]
  node_extcontent["Player page agent<br/>[content.js]"]
  node_extbackground["Extension relay<br/>[background.js]"]
end

subgraph group_extras["Optional experiences"]
  node_lockscreen["Lock-screen design<br/>[gerador.html]"]
end

node_user(("Wallpaper user"))
node_lively["Lively Wallpaper"]
node_windowsmedia["Windows media controls"]
node_windowsvolume["Windows volume"]
node_player["Browser media player"]
node_openmeteo["Open-Meteo"]

node_user -->|"configures"| node_lively
node_lively -->|"sends data"| node_livelybridge
node_livelybridge -->|"updates state"| node_runtime
node_runtime -->|"ticks"| node_clock
node_runtime -->|"ticks"| node_calendar
node_runtime -->|"boots"| node_livelybridge
node_livelybridge -->|"emits system data"| node_hardware
node_livelybridge -->|"emits spectrum"| node_audio
node_livelybridge -->|"emits track"| node_mediaui
node_runtime -->|"drives frames"| node_brandfield
node_runtime -->|"drives frames"| node_audio
node_runtime -->|"applies settings"| node_hardware
node_runtime -->|"applies settings"| node_weather
node_runtime -->|"applies settings"| node_mediaui
node_weather -->|"fetches forecast"| node_openmeteo
node_mediaui -->|"sends commands"| node_bridge
node_bridge -->|"uses controls"| node_windowsmedia
node_bridge -->|"uses volume"| node_windowsvolume
node_player -->|"reports playback"| node_extcontent
node_extcontent -->|"sends report"| node_extbackground
node_extbackground -->|"forwards report"| node_bridge
node_bridge -->|"returns seek"| node_extbackground
node_extcontent -->|"applies seek"| node_player
node_user -->|"uses design"| node_lockscreen

click node_runtime "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/core.js"
click node_livelybridge "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/lively-bridge.js"
click node_clock "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/clock.js"
click node_calendar "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/calendar.js"
click node_hardware "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/hardware.js"
click node_weather "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/weather.js"
click node_audio "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/audio.js"
click node_brandfield "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/brandfield.js"
click node_mediaui "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/media.js"
click node_bridge "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/media-bridge/JrTechMediaBridge.ps1"
click node_extcontent "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/browser-extension/content.js"
click node_extbackground "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/browser-extension/background.js"
click node_lockscreen "https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/lock-screen/gerador.html"

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_runtime,node_livelybridge,node_user,node_player toneBlue
class node_clock,node_calendar,node_hardware,node_weather,node_audio,node_brandfield toneAmber
class node_mediaui,node_bridge,node_extcontent,node_extbackground toneMint
class node_lockscreen toneRose
class node_lively,node_windowsmedia,node_windowsvolume,node_openmeteo toneIndigo
```

## Components

### Wallpaper runtime

- [Runtime core](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/core.js): `wallpaper/js/core.js`
- [Lively data bridge](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/lively-bridge.js): `wallpaper/js/lively-bridge.js`

### Dashboard features

- [Clock](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/clock.js): `wallpaper/js/modules/clock.js`
- [Calendar](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/calendar.js): `wallpaper/js/modules/calendar.js`
- [System monitor](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/hardware.js): `wallpaper/js/modules/hardware.js`
- [Weather panel](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/weather.js): `wallpaper/js/modules/weather.js`
- [Audio visualizer](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/audio.js): `wallpaper/js/modules/audio.js`
- [Reactive background](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/brandfield.js): `wallpaper/js/modules/brandfield.js`

### Media controls

- [Music player](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/wallpaper/js/modules/media.js): `wallpaper/js/modules/media.js`
- [Media Bridge](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/media-bridge/JrTechMediaBridge.ps1): `media-bridge/JrTechMediaBridge.ps1`
- [Player page agent](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/browser-extension/content.js): `browser-extension/content.js`
- [Extension relay](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/browser-extension/background.js): `browser-extension/background.js`

### Optional experiences

- [Lock-screen design](https://github.com/jrtechofcdev/jrtech-wallpaper/blob/main/lock-screen/gerador.html): `lock-screen/gerador.html`

### Other components

- **Wallpaper user**
- **Lively Wallpaper**
- **Windows media controls**
- **Windows volume**
- **Browser media player**
- **Open-Meteo**

## Connections

- Wallpaper user → Lively Wallpaper: configures (evidence: `README.md`)
- Lively Wallpaper → Lively data bridge: sends data (evidence: `README.md`)
- Lively data bridge → Runtime core: updates state (evidence: `wallpaper/js/lively-bridge.js`)
- Runtime core → Clock: ticks (evidence: `wallpaper/js/modules/clock.js`)
- Runtime core → Calendar: ticks (evidence: `wallpaper/js/modules/calendar.js`)
- Runtime core → Lively data bridge: boots (evidence: `wallpaper/js/lively-bridge.js`)
- Lively data bridge → System monitor: emits system data (evidence: `README.md`)
- Lively data bridge → Audio visualizer: emits spectrum (evidence: `wallpaper/js/lively-bridge.js`)
- Lively data bridge → Music player: emits track (evidence: `wallpaper/js/lively-bridge.js`)
- Runtime core → Reactive background: drives frames (evidence: `wallpaper/js/core.js`)
- Runtime core → Audio visualizer: drives frames (evidence: `wallpaper/js/core.js`)
- Runtime core → System monitor: applies settings (evidence: `wallpaper/js/core.js`)
- Runtime core → Weather panel: applies settings (evidence: `wallpaper/js/core.js`)
- Runtime core → Music player: applies settings (evidence: `wallpaper/js/core.js`)
- Weather panel → Open-Meteo: fetches forecast (evidence: `wallpaper/js/modules/weather.js`)
- Music player → Media Bridge: sends commands (evidence: `wallpaper/js/modules/media.js`)
- Media Bridge → Windows media controls: uses controls (evidence: `README.md`)
- Media Bridge → Windows volume: uses volume (evidence: `README.md`)
- Browser media player → Player page agent: reports playback (evidence: `browser-extension/content.js`)
- Player page agent → Extension relay: sends report (evidence: `browser-extension/content.js`)
- Extension relay → Media Bridge: forwards report (evidence: `browser-extension/background.js`)
- Media Bridge → Extension relay: returns seek (evidence: `browser-extension/background.js`)
- Player page agent → Browser media player: applies seek (evidence: `browser-extension/content.js`)
- Wallpaper user → Lock-screen design: uses design (evidence: `README.md`)
