# nineodernein/hisense-vidaa-clean-home architecture

> Architecture diagram of the GitHub repository nineodernein/hisense-vidaa-clean-home, 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/nineodernein/hisense-vidaa-clean-home
- Repository: https://github.com/nineodernein/hisense-vidaa-clean-home

## Overview

This repository combines an offline, agent-assisted VIDAA setup and research workflow with a native home-screen replacement. The main user-to-result path is to run the local agent, gather device evidence, and prepare a private candidate; on a compatible TV, the native launcher presents apps, inputs, and settings. The README also describes optional DNS filtering and animated media. Edges are limited to relationships shown in excerpts, the source index, or README; several native modules were read but not excerpted, so their internal wiring is not inferred.

Main entry points: [`native-dock.js`](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-dock.js) (Home Dock), [`agent.py`](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/agent.py) (Setup Agent), [`native-core.js`](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-core.js) (Home Engine), [`dns-rules.py`](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/dns-rules.py) (DNS Rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Local Setup"]
  node_agent["Setup Agent<br/>[agent.py]"]
  node_port["Port Research<br/>[model_tools.py]"]
end

subgraph group_research["Access Research"]
  node_sim["Access Simulator<br/>[vidaa_lab.py]"]
end

subgraph group_home["Native Home"]
  node_dock["Home Dock<br/>[native-dock.js]"]
  node_core["Home Engine<br/>[native-core.js]"]
  node_actions["Remote Actions<br/>[native-actions.js]"]
  node_platform["VIDAA Platform<br/>[native-platform.js]"]
  node_entry["Native Entry<br/>[native-entry.js]"]
end

subgraph group_media["Media Experience"]
  node_saver["Screen Saver<br/>[native-saver.js]"]
  node_catalog["Media Catalog<br/>[native-media.js]"]
  node_video["Native Video<br/>[native-video.js]"]
end

subgraph group_network["Optional Filtering"]
  node_dns["DNS Rules<br/>[dns-rules.py]"]
end

node_owner(("TV Owner"))
node_tv(("VIDAA TV"))
node_sdk["VIDAA SDK"]
node_dnsfilter["DNS Filter"]

node_owner -->|"runs locally"| node_agent
node_agent -->|"uses research"| node_port
node_agent -->|"runs simulation"| node_sim
node_tv -->|"opens Home"| node_dock
node_dock -->|"extends engine"| node_core
node_core -->|"reads TV data"| node_sdk
node_dock -->|"starts playback"| node_video
node_dock -.->|"selects media"| node_catalog
node_owner -->|"uses guide"| node_dns
node_dns -.->|"configures filtering"| node_dnsfilter

click node_agent "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/agent.py"
click node_port "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/model_tools.py"
click node_sim "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/vidaa_lab.py"
click node_dock "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-dock.js"
click node_core "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-core.js"
click node_actions "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-actions.js"
click node_platform "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-platform.js"
click node_entry "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-entry.js"
click node_saver "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-saver.js"
click node_catalog "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-media.js"
click node_video "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-video.js"
click node_dns "https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/dns-rules.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_agent,node_port toneBlue
class node_sim toneAmber
class node_dock,node_core,node_actions,node_platform,node_entry toneMint
class node_saver,node_catalog,node_video toneRose
class node_dns,node_owner,node_tv,node_sdk,node_dnsfilter toneIndigo
```

## Components

### Local Setup

- [Setup Agent](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/agent.py): `agent.py`
- [Port Research](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/model_tools.py): `model_tools.py`

### Access Research

- [Access Simulator](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/vidaa_lab.py): `vidaa_lab.py`

### Native Home

- [Home Dock](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-dock.js): `native-dock.js`
- [Home Engine](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-core.js): `native-core.js`
- [Remote Actions](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-actions.js): `native-actions.js`
- [VIDAA Platform](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-platform.js): `native-platform.js`
- [Native Entry](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-entry.js): `native-entry.js`

### Media Experience

- [Screen Saver](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-saver.js): `native-saver.js`
- [Media Catalog](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-media.js): `native-media.js`
- [Native Video](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/native-video.js): `native-video.js`

### Optional Filtering

- [DNS Rules](https://github.com/nineodernein/hisense-vidaa-clean-home/blob/main/dns-rules.py): `dns-rules.py`

### Other components

- **TV Owner**
- **VIDAA TV**
- **VIDAA SDK**
- **DNS Filter**

## Connections

- TV Owner → Setup Agent: runs locally (evidence: `README.md`)
- Setup Agent → Port Research: uses research (evidence: `agent.py`)
- Setup Agent → Access Simulator: runs simulation (evidence: `agent.py`)
- VIDAA TV → Home Dock: opens Home (evidence: `README.md`)
- Home Dock → Home Engine: extends engine (evidence: `native-dock.js`)
- Home Engine → VIDAA SDK: reads TV data (evidence: `native-core.js`)
- Home Dock → Native Video: starts playback (evidence: `native-dock.js`)
- Home Dock → Media Catalog: selects media (evidence: `README.md`)
- TV Owner → DNS Rules: uses guide (evidence: `README.md`)
- DNS Rules → DNS Filter: configures filtering (evidence: `README.md`)
