Conceptual-Machines/magda-core

crowdin-translate

Manage MAGDA translations via Crowdin - how to add source strings, push sources, push a specific locale's translation via CLI, and the rules about who writes what.

لغة النص الأصلي: الإنجليزية

git

Git workflow rules for this repository. MUST be followed for all git operations, including branching, committing and pushing.

لغة النص الأصلي: الإنجليزية

windows-signing

Code-sign the MAGDA Windows installer with the Certum cloud certificate (SimplySign). Use when releasing on Windows, when the signing job in release.yml needs attention, or when troubleshooting "cert not found" / SmartScreen warnings.

لغة النص الأصلي: الإنجليزية

svg-button

Add SVG icon buttons to the UI. Use when creating or modifying buttons that use SVG icons from the assets directory.

لغة النص الأصلي: الإنجليزية

faust-device

Work on MAGDA's compiled Faust devices (synths/FX whose DSP is a .dsp file compiled to C++ at build time). Use when adding or changing a parameter on a compiled Faust plugin (e.g. Poly Synth, the filter engines, compiled FX), creating a new compiled Faust…

لغة النص الأصلي: الإنجليزية

app-icon

Update the MAGDA application icon (dock / taskbar / window icon) from a new source PNG. Use when the user wants to change, swap, or update the app icon, e.g. "update the app icon to Bold-M6". Covers the assets/app_icon.png pipeline, the square-PNG…

لغة النص الأصلي: الإنجليزية

te-host-parameter-writes

Write values from MAGDA into a te::AutomatableParameter (slider moves, controller input, state restore, modifier sync). Covers the setParameterFromHost requirement, why setParameter silently drops host writes when modifiers are active, and what to do after a…

لغة النص الأصلي: الإنجليزية

release

Tag and push a release. Use when the user says "release X.Y.Z". Does NOT merge any branches — just tags the current HEAD and pushes.

لغة النص الأصلي: الإنجليزية

crash-analysis

Analyze MAGDA crash logs and Windows minidumps. Use when the user reports a crash, provides a crash log or .dmp file, or asks to investigate a crash.

لغة النص الأصلي: الإنجليزية

building

Build, test, and run MAGDA DAW. Use when compiling, running tests, or launching the app. Always use Makefile commands, never raw cmake/ninja.

لغة النص الأصلي: الإنجليزية

macros-mods

Guide for implementing and debugging macro and mod (LFO/envelope) linking on device parameters. Use when adding macro/mod support to a plugin, fixing macro link issues, or understanding the modulation system.

لغة النص الأصلي: الإنجليزية

move-file

Move a C++ source file to a new location, updating all

لغة النص الأصلي: الإنجليزية

audio-thread

Audio thread safety and lock-free programming patterns for JUCE/Tracktion Engine. Use when writing Plugin::applyToBuffer(), real-time audio callbacks, metering, or any code that touches the audio thread. Covers what is forbidden, lock-free communication, and…

لغة النص الأصلي: الإنجليزية

juce-threading

JUCE threading model and component lifecycle safety. Use when writing UI components, async callbacks, timers, or any code that crosses thread boundaries. Covers destruction ordering, SafePointer, LookAndFeel cleanup, and common crash patterns.

لغة النص الأصلي: الإنجليزية

valuetree

JUCE ValueTree and serialization patterns for Tracktion Engine plugins. Use when working with plugin state, CachedValue properties, ValueTree listeners, or state persistence/restoration.

لغة النص الأصلي: الإنجليزية

tracktion-engine

Work with Tracktion Engine audio DAW framework. Use when creating/manipulating Edits, Tracks, Clips, Plugins, or Transport control. Covers the core model, playback, and plugin hosting patterns.

لغة النص الأصلي: الإنجليزية