Skip to content

Architecture

Jump to bottom
Salem874 edited this page Apr 3, 2026 · 1 revision

🏗️ Architecture

Copyright © 2026 MWBM Partners Ltd. All rights reserved.

Modular Design

MeedyaConverter uses a three-layer architecture with a shared cross-platform core:

┌──────────────────────────────────────────────────────────┐
│                    MeedyaConverter                        │
├──────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────┐  │
│  │  macOS App    │  │  Windows App  │  │  Linux App    │  │
│  │  (SwiftUI)    │  │  (WinUI 3)   │  │  (GTK4)       │  │
│  └──────┬────────┘  └──────┬───────┘  └──────┬────────┘  │
│         │                  │                  │           │
│  ┌──────┴──────────────────┴──────────────────┴────────┐ │
│  │                 meedya-convert (CLI)                 │ │
│  └──────────────────────┬──────────────────────────────┘ │
│                         │                                │
│  ┌──────────────────────┴──────────────────────────────┐ │
│  │                ConverterEngine                       │ │
│  │  ┌──────────────────────────────────────────────┐    │ │
│  │  │         EncodingBackend (Protocol)            │    │ │
│  │  │  ┌─────────────────┐ ┌─────────────────────┐ │    │ │
│  │  │  │ FFmpeg Subprocess│ │ AVFoundation/       │ │    │ │
│  │  │  │ (Direct Dist.)  │ │ FFmpegKit Hybrid    │ │    │ │
│  │  │  └─────────────────┘ └─────────────────────┘ │    │ │
│  │  └──────────────────────────────────────────────┘    │ │
│  └─────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘

Internal Targets

Target Type Purpose
ConverterEngine Library Cross-platform core — encoding, probing, manifests, disc reading
meedya-convert Executable CLI tool for automation and scripting
MeedyaConverter Executable macOS SwiftUI application

Names are deliberately distinct from the Meedya product family (MeedyaDL, MeedyaManager, MeedyaDB).

Hybrid Encoding Engine

The encoding backend is selected at build time via build configuration:

Direct Distribution (DIRECT)

  • FFmpeg invoked as subprocess with full GPL codecs (libx264, libx265)
  • dovi_tool as subprocess for Dolby Vision
  • No sandbox restrictions
  • Sparkle 2 auto-updates

App Store (APP_STORE)

  • AVFoundation / VideoToolbox for H.264, HEVC, ProRes (hardware-accelerated)
  • FFmpegKit (LGPL linked) for codecs AVFoundation doesn't support
  • dovi_tool bundled as signed helper (MIT license)
  • Apple-managed updates
  • Three-tier sandbox file access

Three-Tier File Access (App Store Sandbox)

  1. Tier 1 — User-selected access via NSOpenPanel/NSSavePanel (default)
  2. Tier 2 — Security-scoped bookmarks for persistent folder access (recommended)
  3. Tier 3 — Full Disk Access via System Settings (optional, user-granted)

Directory Structure

Sources/
├── ConverterEngine/        # Cross-platform core
│   ├── Backend/            # EncodingBackend protocol + implementations
│   ├── FFmpeg/             # FFmpeg subprocess integration
│   ├── Native/             # AVFoundation/VideoToolbox integration
│   ├── Encoding/           # Profiles, jobs, queue
│   ├── Manifest/           # HLS/DASH manifest generation
│   ├── Audio/              # Normalization, ReplayGain
│   ├── Subtitles/          # Format conversion, CC handling, OCR
│   ├── HDR/                # HDR10/DV/dovi_tool/DDVT
│   ├── Crypto/             # AES-128, key management
│   ├── Cloud/              # Upload providers
│   ├── Disc/               # Optical disc reading/authoring
│   ├── Models/             # Shared data models
│   ├── Reports/            # Post-encoding reports
│   └── Utilities/          # Logging, process runner
├── meedya-convert/         # CLI executable
│   └── Commands/           # ArgumentParser commands
└── MeedyaConverter/        # macOS SwiftUI app
    ├── Views/
    ├── ViewModels/
    └── Components/

🎬 MeedyaConverter

Links

Clone this wiki locally