Architecture

This document is for developers who are new to the code. It explains how the pieces fit together, which rules keep the audio thread safe, and where to find things. For building, testing and step-by-step recipes see DEVELOPING.md; for what the program does from the user’s side see USER_GUIDE.md. The Logic Pro research behind the layout and behaviour is in logic-reference.md, and the feature scope is in LOGIC_FEATURES.md.

Contents

Foundations

• Overview
• Processes and threads
• Real-time rules
• How an edit flows

Data

• The project model: Ids, tracks and routing · Regions, takes and notes · Automation, markers and the rest
• Undo
• Persistence
• Tempo map

Engine

• The engine graph, block by block: Plug-in delay compensation · Multi-core processing · Offline render and Isolate
• The VST3 host: Loading and scanning · Processing and parameters · Editor windows
• Audio I/O and latency
• Built-in effects and presets: The effect framework · Built-in instruments · Marbble Tre internals · Marbble Sampler internals · Synth model internals · Clipboard and strip settings

Interface

• The frontend

Reference

• Cross-cutting patterns
• Module map: The engine crate · VST3 host and Tauri · Frontend · Frontend components · Tests and packaging