# masqu3rad3/tik_manager4 architecture

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

- Interactive diagram: https://gitdiagram.com/masqu3rad3/tik_manager4
- Repository: https://github.com/masqu3rad3/tik_manager4

## Overview

Tik Manager 4 is a cross-platform VFX and animation project/pipeline manager with integrations for multiple DCC applications and production-management platforms. The primary workflow is selecting project work in the UI, managing versions, then publishing validated work or ingesting an existing version through a host-specific DCC adapter. The README also highlights asset organization, collaboration, extensibility, and management integrations. Arrows are limited to relationships documented in the README or visible in the supplied source index/excerpts; host-specific details beyond sampled adapters are grouped at their source directories.

Main entry points: [`tik_manager4/ui/main.py`](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/main.py) (Tik Manager UI), [`tik_manager4/dcc/main_core.py`](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/main_core.py) (Host Adapters), [`tik_manager4/objects/main.py`](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/main.py) (Project Model), [`tik_manager4/management/management_core.py`](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/management_core.py) (Management Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Project Workflow"]
  node_ui["Tik Manager UI<br/>[main.py]"]
  node_model["Project Model<br/>[main.py]"]
  node_versions[("Version Records<br/>[version.py]")]
  node_preview["Preview Media<br/>[preview.py]"]
  node_publish["Publish Workflow<br/>[publish_dialog.py]"]
  node_ingestui["Bundle Ingest UI"]
end

subgraph group_dcc["DCC Integration"]
  node_dccentry["Host Adapters<br/>[main_core.py]"]
  node_extract["Scene Extraction<br/>[extract_core.py]"]
  node_ingest["Asset Ingestion<br/>[ingest_core.py]"]
  node_validation["Publish Validation<br/>[validate_core.py]"]
  node_hostmodules["Host Extensions"]
end

subgraph group_management["Management Platforms"]
  node_managementcore["Management Adapter<br/>[management_core.py]"]
  node_kitsu["Kitsu Integration<br/>[main.py]"]
  node_shotgrid["ShotGrid Integration<br/>[main.py]"]
end

subgraph group_runtime["Shared Runtime"]
  node_filelog["Logging<br/>[filelog.py]"]
  node_utils["Core Utilities<br/>[utils.py]"]
  node_tankcore["ShotGrid Toolkit Core"]
  node_qt["Qt Compatibility<br/>[__init__.py]"]
  node_uiwidgets["UI Components"]
  node_feedback["Feedback Dialog<br/>[feedback.py]"]
  node_pick["Picker UI<br/>[pick.py]"]
  node_fileseq["File Sequences<br/>[filesequence.py]"]
end

node_artist(("Artist"))
node_externalmgmt(("Production Platform"))

node_artist -->|"uses"| node_ui
node_ui -->|"manages projects"| node_model
node_model -->|"tracks versions"| node_versions
node_model -->|"selects handler"| node_managementcore
node_ui -->|"starts publish"| node_publish
node_ui -->|"starts ingest"| node_ingestui
node_publish -.->|"uses host"| node_dccentry
node_ingestui -.->|"requests ingest"| node_ingest
node_dccentry -.->|"extracts scenes"| node_extract
node_dccentry -.->|"runs checks"| node_validation
node_dccentry -.->|"routes ingest"| node_ingest
node_dccentry -->|"loads host features"| node_hostmodules
node_dccentry -->|"opens interface"| node_ui
node_kitsu -->|"implements"| node_managementcore
node_shotgrid -->|"implements"| node_managementcore
node_managementcore -.->|"synchronizes"| node_externalmgmt
node_kitsu -->|"syncs project events"| node_externalmgmt
node_ui -->|"uses Qt shim"| node_qt
node_ui -->|"builds views"| node_uiwidgets
node_ui -->|"opens feedback"| node_feedback
node_ui -->|"uses picker"| node_pick
node_model -->|"uses logging"| node_filelog
node_model -->|"uses utilities"| node_utils
node_ingest -->|"handles sequences"| node_fileseq
node_shotgrid -->|"uses toolkit"| node_tankcore
node_versions -.->|"associates previews"| node_preview

click node_ui "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/main.py"
click node_model "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/main.py"
click node_versions "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/version.py"
click node_preview "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/preview.py"
click node_publish "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/publish_dialog.py"
click node_ingestui "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/bunde_ingest_dialog.py"
click node_dccentry "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/main_core.py"
click node_extract "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/extract_core.py"
click node_ingest "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/ingest_core.py"
click node_validation "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/validate_core.py"
click node_hostmodules "https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/dcc"
click node_managementcore "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/management_core.py"
click node_kitsu "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/kitsu/main.py"
click node_shotgrid "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/shotgrid/main.py"
click node_filelog "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/core/filelog.py"
click node_utils "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/core/utils.py"
click node_tankcore "https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/external/shotgunsoftware/tank"
click node_qt "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/Qt/__init__.py"
click node_uiwidgets "https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/ui/widgets"
click node_feedback "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/feedback.py"
click node_pick "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/pick.py"
click node_fileseq "https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/external/fileseq/filesequence.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_ui,node_model,node_versions,node_preview,node_publish,node_ingestui toneBlue
class node_dccentry,node_extract,node_ingest,node_validation,node_hostmodules toneAmber
class node_managementcore,node_kitsu,node_shotgrid toneMint
class node_filelog,node_utils,node_tankcore,node_qt,node_uiwidgets,node_feedback,node_pick,node_fileseq toneRose
class node_artist,node_externalmgmt toneIndigo
```

## Components

### Project Workflow

- [Tik Manager UI](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/main.py): `tik_manager4/ui/main.py`
- [Project Model](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/main.py): `tik_manager4/objects/main.py`
- [Version Records](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/version.py): `tik_manager4/objects/version.py`
- [Preview Media](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/objects/preview.py): `tik_manager4/objects/preview.py`
- [Publish Workflow](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/publish_dialog.py): `tik_manager4/ui/dialog/publish_dialog.py`
- [Bundle Ingest UI](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/bunde_ingest_dialog.py): `tik_manager4/ui/dialog/bunde_ingest_dialog.py`

### DCC Integration

- [Host Adapters](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/main_core.py): `tik_manager4/dcc/main_core.py`
- [Scene Extraction](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/extract_core.py): `tik_manager4/dcc/extract_core.py`
- [Asset Ingestion](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/ingest_core.py): `tik_manager4/dcc/ingest_core.py`
- [Publish Validation](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/dcc/validate_core.py): `tik_manager4/dcc/validate_core.py`
- [Host Extensions](https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/dcc): `tik_manager4/dcc`

### Management Platforms

- [Management Adapter](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/management_core.py): `tik_manager4/management/management_core.py`
- [Kitsu Integration](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/kitsu/main.py): `tik_manager4/management/kitsu/main.py`
- [ShotGrid Integration](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/management/shotgrid/main.py): `tik_manager4/management/shotgrid/main.py`

### Shared Runtime

- [Logging](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/core/filelog.py): `tik_manager4/core/filelog.py`
- [Core Utilities](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/core/utils.py): `tik_manager4/core/utils.py`
- [ShotGrid Toolkit Core](https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/external/shotgunsoftware/tank): `tik_manager4/external/shotgunsoftware/tank`
- [Qt Compatibility](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/Qt/__init__.py): `tik_manager4/ui/Qt/__init__.py`
- [UI Components](https://github.com/masqu3rad3/tik_manager4/tree/dev/tik_manager4/ui/widgets): `tik_manager4/ui/widgets`
- [Feedback Dialog](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/dialog/feedback.py): `tik_manager4/ui/dialog/feedback.py`
- [Picker UI](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/ui/pick.py): `tik_manager4/ui/pick.py`
- [File Sequences](https://github.com/masqu3rad3/tik_manager4/blob/dev/tik_manager4/external/fileseq/filesequence.py): `tik_manager4/external/fileseq/filesequence.py`

### Other components

- **Artist**
- **Production Platform**

## Connections

- Artist → Tik Manager UI: uses
- Tik Manager UI → Project Model: manages projects (evidence: `tik_manager4/ui/main.py`)
- Project Model → Version Records: tracks versions (evidence: `tik_manager4/objects/main.py`)
- Project Model → Management Adapter: selects handler (evidence: `tik_manager4/objects/main.py`)
- Tik Manager UI → Publish Workflow: starts publish (evidence: `tik_manager4/ui/main.py`)
- Tik Manager UI → Bundle Ingest UI: starts ingest (evidence: `tik_manager4/ui/main.py`)
- Publish Workflow → Host Adapters: uses host
- Bundle Ingest UI → Asset Ingestion: requests ingest
- Host Adapters → Scene Extraction: extracts scenes (evidence: `tik_manager4/dcc/main_core.py`)
- Host Adapters → Publish Validation: runs checks (evidence: `tik_manager4/dcc/main_core.py`)
- Host Adapters → Asset Ingestion: routes ingest (evidence: `tik_manager4/dcc/main_core.py`)
- Host Adapters → Host Extensions: loads host features (evidence: `tik_manager4/dcc/maya/main.py`)
- Host Adapters → Tik Manager UI: opens interface (evidence: `tik_manager4/dcc/maya/main.py`)
- Kitsu Integration → Management Adapter: implements (evidence: `tik_manager4/management/kitsu/main.py`)
- ShotGrid Integration → Management Adapter: implements (evidence: `tik_manager4/management/shotgrid/main.py`)
- Management Adapter → Production Platform: synchronizes
- Kitsu Integration → Production Platform: syncs project events (evidence: `tik_manager4/management/kitsu/main.py`)
- Tik Manager UI → Qt Compatibility: uses Qt shim (evidence: `tik_manager4/ui/main.py`)
- Tik Manager UI → UI Components: builds views (evidence: `tik_manager4/ui/main.py`)
- Tik Manager UI → Feedback Dialog: opens feedback (evidence: `tik_manager4/ui/main.py`)
- Tik Manager UI → Picker UI: uses picker (evidence: `tik_manager4/ui/main.py`)
- Project Model → Logging: uses logging (evidence: `tik_manager4/objects/main.py`)
- Project Model → Core Utilities: uses utilities (evidence: `tik_manager4/objects/main.py`)
- Asset Ingestion → File Sequences: handles sequences (evidence: `tik_manager4/dcc/ingest_core.py`)
- ShotGrid Integration → ShotGrid Toolkit Core: uses toolkit (evidence: `tik_manager4/management/shotgrid/main.py`)
- Version Records → Preview Media: associates previews
