# ka1-s/lynx-share architecture

> Architecture diagram of the GitHub repository ka1-s/lynx-share, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ka1-s/lynx-share
- Repository: https://github.com/ka1-s/lynx-share

## Overview

LYNX SHARE is a cross-platform DAW combining pattern-based, clip-launch and simple one-window workflows. Users create or import a project, edit and arrange musical material, play it through instruments and effects, record or mix it, then export or collaborate. The README establishes the product workflows and project-format capabilities; source-index references support a few internal dependencies. Many feature modules are listed but not sampled, so their connections are omitted rather than inferred.

Main entry points: [`src/core/Song.h`](https://github.com/ka1-s/lynx-share/blob/main/src/core/Song.h) (Project Song), [`src/core/EngineLayouts.cpp`](https://github.com/ka1-s/lynx-share/blob/main/src/core/EngineLayouts.cpp) (Pattern Workflow), [`src/core/ClipLauncher.cpp`](https://github.com/ka1-s/lynx-share/blob/main/src/core/ClipLauncher.cpp) (Clip Launch), [`src/core/MixerOps.h`](https://github.com/ka1-s/lynx-share/blob/main/src/core/MixerOps.h) (Mixer Routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["Workflows and Editing"]
  node_pattern["Pattern Workflow<br/>[EngineLayouts.cpp]"]
  node_clip["Clip Launch<br/>[ClipLauncher.cpp]"]
  node_simple["Simple Workflow<br/>[SimpleTracks.cpp]"]
  node_piano["Piano Roll<br/>[PianoRollTools.cpp]"]
  node_playlist["Playlist<br/>[PlaylistOps.cpp]"]
  node_session["Session Editing<br/>[SessionOps.h]"]
  node_recorder["Recording<br/>[Recorder.h]"]
  node_mpe["MPE Support<br/>[Mpe.h]"]
end

subgraph group_projects["Projects and Exchange"]
  node_song[("Project Song<br/>[Song.h]")]
  node_project_import["Project Import<br/>[FlpImport.h]"]
  node_flp_format["FLP Format<br/>[Flp.h]"]
  node_project_export["Project Export<br/>[Exporter.cpp]"]
  node_sharing["Project Sharing<br/>[ContentShare.h]"]
end

subgraph group_audio["Audio Runtime"]
  node_mixer["Mixer Routing<br/>[MixerOps.h]"]
  node_effects["Effects Chain<br/>[DetailChain.h]"]
  node_audio_engine["Audio Engine<br/>[AudioEngine.cpp]"]
  node_instruments["Native Engines<br/>[NativeEngines.cpp]"]
  node_plugin_host["Plugin Hosting<br/>[PluginHost.h]"]
end

subgraph group_ui["Interface and Settings"]
  node_preferences[("Preferences<br/>[Preferences.h]")]
  node_controls["UI Controls<br/>[ValueControl.h]"]
  node_localization["Localization<br/>[I18n.h]"]
  node_theme["Themes<br/>[Theme.h]"]
end

node_musician(("Musician"))

node_musician -->|"edits patterns"| node_pattern
node_musician -->|"launches clips"| node_clip
node_musician -->|"records simply"| node_simple
node_pattern -->|"edits notes"| node_piano
node_pattern -->|"arranges clips"| node_playlist
node_clip -->|"edits sessions"| node_session
node_simple -->|"edits project"| node_song
node_pattern -->|"edits project"| node_song
node_clip -->|"edits project"| node_song
node_project_import -->|"loads into"| node_song
node_project_import -->|"uses format"| node_flp_format
node_song -->|"exports project"| node_project_export
node_song -.->|"shares project"| node_sharing
node_recorder -->|"records into"| node_song
node_song -->|"routes tracks"| node_mixer
node_mixer -->|"holds effect chain"| node_effects
node_audio_engine -.->|"processes routing"| node_mixer
node_audio_engine -->|"uses engines"| node_instruments
node_plugin_host -->|"hosts effects"| node_effects
node_pattern -.->|"supports expression"| node_mpe
node_musician -.->|"sets options"| node_preferences

click node_pattern "https://github.com/ka1-s/lynx-share/blob/main/src/core/EngineLayouts.cpp"
click node_clip "https://github.com/ka1-s/lynx-share/blob/main/src/core/ClipLauncher.cpp"
click node_simple "https://github.com/ka1-s/lynx-share/blob/main/src/core/SimpleTracks.cpp"
click node_piano "https://github.com/ka1-s/lynx-share/blob/main/src/core/PianoRollTools.cpp"
click node_playlist "https://github.com/ka1-s/lynx-share/blob/main/src/core/PlaylistOps.cpp"
click node_session "https://github.com/ka1-s/lynx-share/blob/main/src/core/SessionOps.h"
click node_song "https://github.com/ka1-s/lynx-share/blob/main/src/core/Song.h"
click node_project_import "https://github.com/ka1-s/lynx-share/blob/main/src/core/FlpImport.h"
click node_flp_format "https://github.com/ka1-s/lynx-share/blob/main/src/flp/Flp.h"
click node_project_export "https://github.com/ka1-s/lynx-share/blob/main/src/engine/Exporter.cpp"
click node_sharing "https://github.com/ka1-s/lynx-share/blob/main/src/core/ContentShare.h"
click node_recorder "https://github.com/ka1-s/lynx-share/blob/main/src/core/Recorder.h"
click node_mixer "https://github.com/ka1-s/lynx-share/blob/main/src/core/MixerOps.h"
click node_effects "https://github.com/ka1-s/lynx-share/blob/main/src/core/DetailChain.h"
click node_audio_engine "https://github.com/ka1-s/lynx-share/blob/main/src/engine/AudioEngine.cpp"
click node_instruments "https://github.com/ka1-s/lynx-share/blob/main/src/core/NativeEngines.cpp"
click node_plugin_host "https://github.com/ka1-s/lynx-share/blob/main/src/engine/PluginHost.h"
click node_preferences "https://github.com/ka1-s/lynx-share/blob/main/src/core/Preferences.h"
click node_controls "https://github.com/ka1-s/lynx-share/blob/main/src/ui/ValueControl.h"
click node_localization "https://github.com/ka1-s/lynx-share/blob/main/src/ui/I18n.h"
click node_theme "https://github.com/ka1-s/lynx-share/blob/main/src/ui/Theme.h"
click node_mpe "https://github.com/ka1-s/lynx-share/blob/main/src/core/Mpe.h"

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_pattern,node_clip,node_simple,node_piano,node_playlist,node_session,node_recorder,node_mpe toneBlue
class node_song,node_project_import,node_flp_format,node_project_export,node_sharing toneAmber
class node_mixer,node_effects,node_audio_engine,node_instruments,node_plugin_host toneMint
class node_preferences,node_controls,node_localization,node_theme toneRose
class node_musician toneIndigo
```

## Components

### Workflows and Editing

- [Pattern Workflow](https://github.com/ka1-s/lynx-share/blob/main/src/core/EngineLayouts.cpp): `src/core/EngineLayouts.cpp`
- [Clip Launch](https://github.com/ka1-s/lynx-share/blob/main/src/core/ClipLauncher.cpp): `src/core/ClipLauncher.cpp`
- [Simple Workflow](https://github.com/ka1-s/lynx-share/blob/main/src/core/SimpleTracks.cpp): `src/core/SimpleTracks.cpp`
- [Piano Roll](https://github.com/ka1-s/lynx-share/blob/main/src/core/PianoRollTools.cpp): `src/core/PianoRollTools.cpp`
- [Playlist](https://github.com/ka1-s/lynx-share/blob/main/src/core/PlaylistOps.cpp): `src/core/PlaylistOps.cpp`
- [Session Editing](https://github.com/ka1-s/lynx-share/blob/main/src/core/SessionOps.h): `src/core/SessionOps.h`
- [Recording](https://github.com/ka1-s/lynx-share/blob/main/src/core/Recorder.h): `src/core/Recorder.h`
- [MPE Support](https://github.com/ka1-s/lynx-share/blob/main/src/core/Mpe.h): `src/core/Mpe.h`

### Projects and Exchange

- [Project Song](https://github.com/ka1-s/lynx-share/blob/main/src/core/Song.h): `src/core/Song.h`
- [Project Import](https://github.com/ka1-s/lynx-share/blob/main/src/core/FlpImport.h): `src/core/FlpImport.h`
- [FLP Format](https://github.com/ka1-s/lynx-share/blob/main/src/flp/Flp.h): `src/flp/Flp.h`
- [Project Export](https://github.com/ka1-s/lynx-share/blob/main/src/engine/Exporter.cpp): `src/engine/Exporter.cpp`
- [Project Sharing](https://github.com/ka1-s/lynx-share/blob/main/src/core/ContentShare.h): `src/core/ContentShare.h`

### Audio Runtime

- [Mixer Routing](https://github.com/ka1-s/lynx-share/blob/main/src/core/MixerOps.h): `src/core/MixerOps.h`
- [Effects Chain](https://github.com/ka1-s/lynx-share/blob/main/src/core/DetailChain.h): `src/core/DetailChain.h`
- [Audio Engine](https://github.com/ka1-s/lynx-share/blob/main/src/engine/AudioEngine.cpp): `src/engine/AudioEngine.cpp`
- [Native Engines](https://github.com/ka1-s/lynx-share/blob/main/src/core/NativeEngines.cpp): `src/core/NativeEngines.cpp`
- [Plugin Hosting](https://github.com/ka1-s/lynx-share/blob/main/src/engine/PluginHost.h): `src/engine/PluginHost.h`

### Interface and Settings

- [Preferences](https://github.com/ka1-s/lynx-share/blob/main/src/core/Preferences.h): `src/core/Preferences.h`
- [UI Controls](https://github.com/ka1-s/lynx-share/blob/main/src/ui/ValueControl.h): `src/ui/ValueControl.h`
- [Localization](https://github.com/ka1-s/lynx-share/blob/main/src/ui/I18n.h): `src/ui/I18n.h`
- [Themes](https://github.com/ka1-s/lynx-share/blob/main/src/ui/Theme.h): `src/ui/Theme.h`

### Other components

- **Musician**

## Connections

- Musician → Pattern Workflow: edits patterns (evidence: `README.md`)
- Musician → Clip Launch: launches clips (evidence: `README.md`)
- Musician → Simple Workflow: records simply (evidence: `README.md`)
- Pattern Workflow → Piano Roll: edits notes (evidence: `README.md`)
- Pattern Workflow → Playlist: arranges clips (evidence: `README.md`)
- Clip Launch → Session Editing: edits sessions (evidence: `README.md`)
- Simple Workflow → Project Song: edits project (evidence: `README.md`)
- Pattern Workflow → Project Song: edits project (evidence: `README.md`)
- Clip Launch → Project Song: edits project (evidence: `README.md`)
- Project Import → Project Song: loads into (evidence: `src/core/FlpImport.h`)
- Project Import → FLP Format: uses format (evidence: `src/core/FlpImport.h`)
- Project Song → Project Export: exports project (evidence: `README.md`)
- Project Song → Project Sharing: shares project (evidence: `README.md`)
- Recording → Project Song: records into (evidence: `src/core/SessionOps.h`)
- Project Song → Mixer Routing: routes tracks (evidence: `src/core/DetailChain.h`)
- Mixer Routing → Effects Chain: holds effect chain (evidence: `src/core/DetailChain.h`)
- Audio Engine → Mixer Routing: processes routing (evidence: `src/engine/AudioEngine.cpp`)
- Audio Engine → Native Engines: uses engines (evidence: `src/core/NativeEngines.cpp`)
- Plugin Hosting → Effects Chain: hosts effects (evidence: `src/engine/PluginHost.h`)
- Pattern Workflow → MPE Support: supports expression (evidence: `README.md`)
- Musician → Preferences: sets options
