Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
56 lines (45 loc) · 2.34 KB

ARCHITECTURE.md

File metadata and controls

56 lines (45 loc) · 2.34 KB

Clockrr - Architecture

System Overview

┌─────────────────────────────────────────────┐
│              Stremio Client                  │
│                                             │
│  ┌─────────────────────────────────────┐    │
│  │          Clockrr Addon              │    │
│  │                                     │    │
│  │  ┌─────────┐    ┌─────────────┐    │    │
│  │  │ Manifest│───▶│ Clock View  │    │    │
│  │  └─────────┘    └─────────────┘    │    │
│  │                        │           │    │
│  │                 ┌──────▼──────┐    │    │
│  │                 │ Time Display│    │    │
│  │                 └─────────────┘    │    │
│  └─────────────────────────────────────┘    │
└─────────────────────────────────────────────┘

Components

1. Manifest (manifest.json)

Stremio addon manifest defining:

  • Addon ID, name, version
  • Supported resources
  • Catalog configuration

2. Addon Server (index.js)

Node.js server using Stremio Addon SDK plus Express:

  • Serves manifest
  • Handles subtitle requests
  • Serves generated WebVTT clock cues

Data Flow

  1. User installs addon via manifest URL
  2. Stremio fetches manifest
  3. Addon appears in Stremio interface
  4. User accesses clock feature
  5. Current time displayed

Deployment Options

Option URL Pattern Notes
Local http://localhost:7000/manifest.json Development
Contabo public https://clockrr.pvtkrrx.cc/manifest.json Current public VPS route behind Caddy
Contabo preview https://preview-clockrr.buildsales.homes/manifest.json Preview route behind Caddy
Custom Contabo hostname https://<clockrr-host>/manifest.json Future production hostname

Last Updated: January 15, 2026