Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
(docs) Update docs
Egor Khindikaynenc7e976a18624
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.mdindex b320ad07..31454aa9 100644--- a/ARCHITECTURE.md+++ b/ARCHITECTURE.md@@ -131,10 +131,10 @@ A plugin is found by its JUCE identifier, `<format>-<name>-<path hash>-<uid>`. Wcatalog entry matches exactly, the lookup falls back to format + name + uid, so a projectstill finds a plugin that lives at another path on this machine.-**Get Plug-ins** (`IPluginStore` → `Infrastructure/PluginStore/`) installs open-source VST3-plugins listed in the [plugin registry](https://github.com/nota-daw/nota-plugins-registry).-The registry is one static `index.json` on GitHub Pages, and the repo's README documents its-manifest. A release asset downloads straight from the plugin's GitHub release and must+**Downloads** (Settings → Downloads, formerly Get Plug-ins; `IPluginStore` →+`Infrastructure/PluginStore/`) installs open-source VST3 plugins listed in the+[plugin registry](https://github.com/nota-daw/nota-plugins-registry). The registry is one+static `index.json` on GitHub Pages, and the repo's README documents its manifest. A release asset downloads straight from the plugin's GitHub release and mustmatch the size and sha256 pinned in the index. `ArchiveUnpacker` then unpacks it:zip / tar / dmg / pkg-payload / deb, and no installer ever runs. The listed bundles arecopied into `<data>/plugins/VST3/<id>/`, which is registered as a scan path. Setdiff --git a/BUILD.md b/BUILD.mdindex 2a148521..00113bb6 100644--- a/BUILD.md+++ b/BUILD.md@@ -11,6 +11,16 @@ covers the details — per-platform prerequisites and manual step-by-step builds- Avalonia templates, only if you are scaffolding new projects —`dotnet new install Avalonia.Templates`.+## Submodules++JUCE (plugin hosting) is a git submodule at `src/native/nota.engine/vendor/JUCE`; the native+build fails without it. Clone with `git clone --recurse-submodules`, or initialize it in an+existing checkout (and again after a pull that moves it):++```bash+git submodule update --init --recursive+```+## Quick start```bashdiff --git a/CHANGELOG.md b/CHANGELOG.mdindex 42e24838..4fdde8a6 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,7 +16,33 @@ created, and the build-and-publish run starts.Entry categories: `Added`, `Changed`, `Fixed`, `Removed`.+## [Unreleased]++## [0.42.1] — 2026-09-30++### Highlights+- **Downloads:** install free open-source plug-ins (Surge XT, Dexed, Dragonfly Reverb and+ more) right from Settings, with progress and Cancel. A project with a missing plug-in+ offers to install it.+- **ADSR for audio clips:** shape any clip's attack, decay, sustain and release with handles+ in the arrangement or in the clip editor.+- **Hear it before you load it:** the browser previews presets, drum kits and effects, has a+ new sample player for files, and takes MIDI files — drop one to get its clips.+- **Nota Grain** gets 50 presets that each bring their own sound, and a root note for your+ own samples.+- **All MIDI effects redesigned:** Arp, Chord, Length, Random, Scale and Velocity get two card+ sizes, live views of what they play, 30+ presets each, and no more stuck notes.+- **A fresh look** for Settings, the start window, the quit dialog, the device window and+ plug-in cards, plus editing several tracks at once and ⌘A to select all clips.+### Added+- **Get Plug-ins.** Preferences has a new Get Plug-ins page. It lists open-source VST3+ plug-ins from the Nota plugin registry, among them Surge XT, Dexed, Dragonfly Reverb,+ CHOW Tape Model and Stochas. Install, update or remove one with a click and it shows up+ in the browser. Each plug-in downloads from its own project's GitHub release and is+ checked against the registry before it's unpacked. Nota never runs an installer.+- **Opening a project that uses a missing plug-in** now offers to install it when the+ registry has it, then reopens the project with the plug-in and its saved settings.- **ADSR for audio clips.** Every audio clip now has attack, decay, sustain and release.Hover a clip in the arrangement and drag the handles — the squares in the top cornersset the attack and release, the dot sets the decay and the sustain level — or open the@@ -85,90 +111,6 @@ Entry categories: `Added`, `Changed`, `Fixed`, `Removed`.tracks. Right-clicking a selection opens a menu for the whole set: group, colour, freeze,copy, cut, paste, duplicate and delete. Each command is one undo step.-### Changed-- **A new look for the start window.** The Nota logo follows the light and dark themes,- and recent projects sit in one compact list with their dates. Click a project to select- it and double-click to open it, or use the arrow keys and Return.-- **A new look for the "quit without saving" dialog.** It shows the project's name and how- long its changes have gone unsaved. Return saves and Escape cancels. A saved project is- saved right in the dialog, and Nota quits when it's done.-- **A new look for the device window.** This is the window that opens a device from a- Drum Rack, an Instrument Rack, an Audio Effect Rack or a Nota Rhythm voice. Its title- bar shows the device, the track, the preset picker and the bypass switch. A two-size- instrument such as Nota Synth also gets its S / L switch there. A bar at the bottom shows- where the device sits (pad, chain or voice), its live voice count and its type. On a- small window, the preset picker moves to its own row. Effects now open at their own- width with the usual padding, and a bypassed effect is marked in the window.-- **A new look for Settings.** The window is larger, and the sidebar groups its pages- under Devices, Plug-ins and General, each with an icon. Every page has a short- description under its title. MIDI inputs and the other on/off options use larger- switches. Latency shows in milliseconds. Get Plug-ins is now called Downloads, shows how- many plugins you can still install, counts each filter and lists the download size. The- theme buttons show a sample of each theme's colour. Shortcuts can be filtered and show- each key on its own key-cap.-- **Downloads show their progress at the bottom of Settings, and you can cancel them.** A bar- at the bottom of the window shows the plugin being installed, how much has downloaded and- a Cancel button. It stays in view while you scroll the list or open another page, and- shows the result when the install finishes. Cancelling leaves your plugins as they were.-- **The Downloads list is faster and shows where each plugin runs.** Searching and filtering- the whole registry is instant now. Each plugin shows macOS, Windows and Linux icons for- the systems it's made for. Hover an icon to see which processors it supports. Plugins your- computer can't install are listed last, under their own heading, and say why. A progress- bar shows while the list loads or refreshes.-- "Add track" in a track's right-click menu puts the new track right after that track. On a- group it adds the track inside the group.-- Copying, duplicating or deleting a group now includes its tracks. Pasted tracks go after- the selected track, in its group.-- The first time you switch to automation mode, each track that already has automation- shows its first automated parameter instead of Volume.-- While dragging from the browser over the arrangement, the target track is outlined in its- header too, and the outline stays visible over the lane's clips.-- **Convert Harmony to New MIDI Track** is much cleaner. Overtones no longer come out as extra- notes. Held chords no longer break into short fragments. Slightly detuned recordings map to- the right notes. The shimmer of chorused or detuned sounds no longer adds neighbouring- semitones. Notes start on the audio's attacks, and a re-struck chord comes out as new notes.--### Fixed-- Reordering or removing effects in Devices no longer scrambles their automation: each lane- stays on its own device and parameter. Removing a device also removes its automation.-- In the piano roll you can now drag a note's left edge to change where it starts; its end- stays put.-- Stacked notes (a chord) no longer hide each other's velocity. Grab a stem by its cap to- pick one, or select several notes and drag any of their stems to move them all together.- ⇧-click a stem to add it to the selection.-- Duplicating notes (⌘D) now replaces the notes the copy lands on, like duplicating a clip in- the arrangement. Before, the copy was stacked on top of them.-- When you zoom out in the piano roll, the area past the clip's end is darkened and marked- with a line, so you can see where the clip ends.-- Right-clicking empty space on a track now always opens a menu. It used to show nothing- when there was no copied clip.--## [Unreleased]--## [0.42.1] — 2026-09-30--### Highlights-- **Get Plug-ins:** browse and install free open-source VST3 plug-ins (Surge XT, Dexed,- Dragonfly Reverb and more) right from Preferences. Opening a project with a missing plug-in- offers to install it.-- **All MIDI effects redesigned:** Arp, Chord, Length, Random, Scale and Velocity get a new- look with full and compact card sizes, live views of what they play, and 30+ presets each.-- **Smarter MIDI effects:** the arp uses every octave with new orders, Chord folds into any- key, Length syncs to more note values, and stuck or hanging notes are fixed across the board.-- **Plug-in cards:** VST3 and AU plug-ins get a proper device card with every parameter as a- knob, and Nota Synth gets a compact size too.-- **Smoother editing:** ⌘A selects all clips, moving several clips no longer loses any, and- Space always starts and stops the project.--### Added-- **Get Plug-ins.** Preferences has a new Get Plug-ins page. It lists open-source VST3- plug-ins from the Nota plugin registry, among them Surge XT, Dexed, Dragonfly Reverb,- CHOW Tape Model and Stochas. Install, update or remove one with a click and it shows up- in the browser. Each plug-in downloads from its own project's GitHub release and is- checked against the registry before it's unpacked. Nota never runs an installer.-- **Opening a project that uses a missing plug-in** now offers to install it when the- registry has it, then reopens the project with the plug-in and its saved settings.-### Changed- VST3 and AU plug-ins get a proper device card with two sizes. The header names theplug-in. The small card shows its vendor, format, parameter count and latency, with@@ -253,6 +195,47 @@ Entry categories: `Added`, `Changed`, `Fixed`, `Removed`.filter curve and four knobs (Cutoff, Reso, Attack, Release). Switch with S / L in the card'sheader. A new Synth opens small. The project remembers each Synth's size, and presetsdon't change it.+- **A new look for the start window.** The Nota logo follows the light and dark themes,+ and recent projects sit in one compact list with their dates. Click a project to select+ it and double-click to open it, or use the arrow keys and Return.+- **A new look for the "quit without saving" dialog.** It shows the project's name and how+ long its changes have gone unsaved. Return saves and Escape cancels. A saved project is+ saved right in the dialog, and Nota quits when it's done.+- **A new look for the device window.** This is the window that opens a device from a+ Drum Rack, an Instrument Rack, an Audio Effect Rack or a Nota Rhythm voice. Its title+ bar shows the device, the track, the preset picker and the bypass switch. A two-size+ instrument such as Nota Synth also gets its S / L switch there. A bar at the bottom shows+ where the device sits (pad, chain or voice), its live voice count and its type. On a+ small window, the preset picker moves to its own row. Effects now open at their own+ width with the usual padding, and a bypassed effect is marked in the window.+- **A new look for Settings.** The window is larger, and the sidebar groups its pages+ under Devices, Plug-ins and General, each with an icon. Every page has a short+ description under its title. MIDI inputs and the other on/off options use larger+ switches. Latency shows in milliseconds. Get Plug-ins is now called Downloads, shows how+ many plugins you can still install, counts each filter and lists the download size. The+ theme buttons show a sample of each theme's colour. Shortcuts can be filtered and show+ each key on its own key-cap.+- **Downloads show their progress at the bottom of Settings, and you can cancel them.** A bar+ at the bottom of the window shows the plugin being installed, how much has downloaded and+ a Cancel button. It stays in view while you scroll the list or open another page, and+ shows the result when the install finishes. Cancelling leaves your plugins as they were.+- **The Downloads list is faster and shows where each plugin runs.** Searching and filtering+ the whole registry is instant now. Each plugin shows macOS, Windows and Linux icons for+ the systems it's made for. Hover an icon to see which processors it supports. Plugins your+ computer can't install are listed last, under their own heading, and say why. A progress+ bar shows while the list loads or refreshes.+- "Add track" in a track's right-click menu puts the new track right after that track. On a+ group it adds the track inside the group.+- Copying, duplicating or deleting a group now includes its tracks. Pasted tracks go after+ the selected track, in its group.+- The first time you switch to automation mode, each track that already has automation+ shows its first automated parameter instead of Volume.+- While dragging from the browser over the arrangement, the target track is outlined in its+ header too, and the outline stays visible over the lane's clips.+- **Convert Harmony to New MIDI Track** is much cleaner. Overtones no longer come out as extra+ notes. Held chords no longer break into short fragments. Slightly detuned recordings map to+ the right notes. The shimmer of chorused or detuned sounds no longer adds neighbouring+ semitones. Notes start on the audio's attacks, and a re-struck chord comes out as new notes.### Fixed- A project now finds its plug-ins even when they're installed in a different folder than on@@ -273,6 +256,19 @@ Entry categories: `Added`, `Changed`, `Fixed`, `Removed`.- Nota Random no longer leaves a transposed note hanging when you bypass it while it sounds.- Nota Chord no longer leaves notes hanging when you change its shifts while a key is held,or when two held keys share a note.+- Reordering or removing effects in Devices no longer scrambles their automation: each lane+ stays on its own device and parameter. Removing a device also removes its automation.+- In the piano roll you can now drag a note's left edge to change where it starts; its end+ stays put.+- Stacked notes (a chord) no longer hide each other's velocity. Grab a stem by its cap to+ pick one, or select several notes and drag any of their stems to move them all together.+ ⇧-click a stem to add it to the selection.+- Duplicating notes (⌘D) now replaces the notes the copy lands on, like duplicating a clip in+ the arrangement. Before, the copy was stacked on top of them.+- When you zoom out in the piano roll, the area past the clip's end is darkened and marked+ with a line, so you can see where the clip ends.+- Right-clicking empty space on a track now always opens a menu. It used to show nothing+ when there was no copied clip.## [0.41.5] — 2026-09-25diff --git a/FEATURES.md b/FEATURES.mdindex 76f95fcf..b816d83b 100644--- a/FEATURES.md+++ b/FEATURES.md@@ -2,7 +2,7 @@# Nota — full feature listA consolidated list of what Nota (a cross-platform DAW) can do, as of version-**0.38.0** (plus changes in development on `main`). This document describes what is+**0.42.1** (plus changes in development on `main`). This document describes what isimplemented in the code, not what is planned. Sources: `CHANGELOG.md`, `README.md`,`ARCHITECTURE.md`.@@ -45,6 +45,10 @@ JUCE module; the engine core is JUCE-free.- **Project**: create / open / save (`.nota`), autosaves, undo/redo for every editingoperation.+- **Start window**: the logo follows the theme, recent projects sit in one compact list with+ their dates — click to select, double-click (or the arrow keys and Return) to open.+- **Quit without saving** dialog names the project and how long its changes have gone+ unsaved; Return saves (right in the dialog, then quits), Escape cancels.- **Transport**: play / stop / record, playhead position.- **Stop returns to the launch point** (a seek sets the start anchor).- **Follow** — the arrangement follows the cursor (playhead stays centred).@@ -67,6 +71,7 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).place, move, trim and duplicate clips; grid and snap to bars/beats; scroll and zoom;recording into the arrangement (audio and MIDI); split at the cursor or across aselection (Cmd/Ctrl+E cuts every track in the selection); clip scrubbing on the ruler.+ ⌘A selects every clip; moving several selected clips is one undo step.An **Overview** strip above the ruler shows the whole project in miniature with thevisible span as a window over it — drag it to scroll, drag its edges (or drag vertically)to zoom, double-click to fit the project.@@ -106,7 +111,13 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).⌘/Ctrl+G to group, ⌘/Ctrl+Shift+G to ungroup).- **Adding a track**: the `+ Instrument` / `+ Audio` / `+ Return` buttons above thearrangement, or the context menu — right-click the empty space below the tracks, or use- `Add track ▸` in a track's own menu.+ `Add track ▸` in a track's own menu (the new track goes right after that track, or inside+ it when it is a group).+- **Several tracks at once**: ⇧-click headers to build a selection (or ⌘A with the headers+ focused); ⌘C / ⌘X / ⌘V / ⌘D and Delete copy, cut, paste, duplicate and delete the+ selected tracks, and right-clicking the selection groups, colours or freezes them all —+ each as one undo step. Copying, duplicating or deleting a group takes its tracks along;+ pasted tracks land after the selected track, in its group.- **Per track**: volume, pan (bipolar bar), mute, solo, arm (ready to record).Double-click resets to the default.- **Reordering** by dragging the name row (with an accent insertion line); returns stay@@ -131,6 +142,12 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).- **MIDI clip**: notes (pitch, start, length, velocity).- **Piano Roll**: draw, move, stretch and delete notes; quantization; grid length; avelocity editor; transposing the selection.+ - Drag a note's left edge to move its start (the end stays put); stacked notes keep+ separate velocity stems (grab a stem by its cap, ⇧-click to add it to the selection).+ - ⌘D duplicates notes over whatever they land on, like clips in the arrangement.+ - **Remove out of scale** (next to the Scale key and mode) deletes every note outside the+ scale in one undo step.+ - Zoomed out, the area past the clip's end is darkened and marked with a line.- Scroll and zoom are remembered per clip; a new clip centres on its own notes.- A MIDI clip trimmed in the arrangement mutes note tails at its boundary.- Live edits (moving a note, changing its length) reach the engine immediately, and a@@ -158,6 +175,11 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).pads audition by name. It is not a second copy of the pattern: the grid **is** the MIDIclip, so steps written here appear in the piano roll and notes drawn there light up assteps.+- **MIDI file import**: `.mid` files show in the browser's Files tab and drop from there or+ from Finder / Explorer. On the arrangement the file becomes MIDI clips at the drop point —+ the first part on the target track, every other part on its own new track (drum parts get+ a Nota Rhythm); on a session slot the whole file becomes that slot's clip; double-clicking+ a MIDI file in the browser puts it on a new track.- **Input**: MIDI keyboard (live play and recording), and the **computer keyboard** playsMIDI (the S–K row, sharps on W E T Y U) — including while a hosted plugin window hasfocus.@@ -179,7 +201,9 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).- **Highlighting** of the pressed key on the roll's keyboard and as a bar along its row.- **Audio→MIDI** (right-click an audio clip → Convert):- **Convert Melody** — monophonic pitch detection (YIN) → a new Nota Synth track.- - **Convert Harmony** — polyphonic (STFT + spectral peak picking) → chords.+ - **Convert Harmony** — polyphonic (STFT + spectral peak picking) → chords: overtones,+ chorus shimmer and slight detune don't add stray notes, held chords stay whole, and+ notes start on the audio's attacks.- **Convert Drums** — hit detection + kick/snare/hat classification → a 3-pad kit and aMIDI pattern.- **Slice to New MIDI Track** — slices the audio at transients (or into 16 beats) across@@ -224,6 +248,8 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).- **Automation lanes** on tracks, with curved segments (Alt+drag) and points (double-clickto add, double-click a point to remove).+- **Automation mode** (⌘⇧A): the first time it opens, each track that already has automation+ shows its first automated parameter.- **Draw mode** (the `A` key): drawn automation changes the device parameter in real time,and the whole drag is one undo step.- **The lane follows focus** — touch any knob or fader on any device (built-in, plugin, or@@ -236,6 +262,8 @@ the mixer opens as a separate floating window (**View → Mixer**, ⌘M).the transport **Record** button engaged, moving a control writes that parameter's lane.A mouse gesture stops writing on release; a hardware control (MIDI knob, fader, gamepadstick or trigger) latches and keeps writing until the transport stops.+- **Stable across device moves** — reordering or removing effects keeps every lane on its own+ device and parameter; removing a device removes its automation.- **Overriding** — touch an automated parameter while not recording and the lane handscontrol to you; the toolbar's **Re-enable Automation** button gives it back.- **Reading** during playback and scrubbing (volume and pan controls follow the automation).@@ -279,7 +307,9 @@ and user presets, automation, persistence and cloning.Gauss / Tukey / Tri) sprayed around it, coarse/fine pitch, per-grain position, pitch andpan variation, stereo spread, **Dry/Wet** against the sample itself, an LP/HP/BP filterand an amp envelope. The card draws the sample with the live grain cloud on it (drag to- move Position). Drop a sample from the browser to replace the built-in pad. 50 factory+ move Position). Drop a sample from the browser to replace the built-in pad; a **ROOT**+ control (Pitch tab) sets the key that plays it at its recorded pitch, taken from a note in+ the file name ("Pad_F#3.wav") or C4. 50 factorypresets in nine folders; every preset outside Basics brings its own source (29 synthesizedon first use — choir, strings, bells, kalimba, a drum break, an arpeggio, ocean, radio …),while Basics shape whatever sample is loaded.@@ -617,10 +647,20 @@ and user presets, automation, persistence and cloning.- **AU** (macOS) and **VST3** (all platforms) — instruments and effects.- **Scanning** and a catalogue of installed plugins (a separate `nota-scanworker`), scanpaths in Preferences, and Rescan.-- **Get Plug-ins** — open-source VST3 plugins from the- [Nota plugin registry](https://github.com/nota-daw/nota-plugins-registry), installed,- updated and removed from Preferences (checksum-verified; archives only, installers never- run). A project that needs a missing registry plugin offers to install it.+- **Downloads** (Settings → Downloads, formerly Get Plug-ins) — open-source VST3 plugins+ from the [Nota plugin registry](https://github.com/nota-daw/nota-plugins-registry)+ (Surge XT, Dexed, Dragonfly Reverb, CHOW Tape Model, Stochas …), installed, updated and+ removed with a click (checksum-verified; archives only, installers never run). Instant+ search and filters with counts, macOS / Windows / Linux icons per plugin (hover for the+ supported processors), download sizes, and plugins this computer can't install listed+ last with the reason. A progress bar with **Cancel** stays at the bottom of Settings while+ an install runs. A project that needs a missing registry plugin offers to install it and+ reopens with its saved settings. Plugins are found even when installed in a different+ folder than on the computer that saved the project.+- **Plugin device card** in two sizes: the small card shows vendor, format, parameter count+ and latency with Open editor and Save preset; the full card adds every parameter as a knob+ (with filter and pages, the plugin's own value text, double-click for its default) and a+ sidechain source where the plugin has one.- **Loading** into a track or rack chain, with the plugin's **native GUI** (an editorwindow that opens on top and focused, and closes when the device is removed).- **State save and restore** in the project, and **bypass**.@@ -653,8 +693,16 @@ and user presets, automation, persistence and cloning.favourites first — each remembered across sessions — plus the tag editor.- A **status line** counts what the tab is showing (`13 built-in · 4 plug-ins`), and thesearch box counts the matches.-- **Preview** a sample from the browser, and **drag and drop** onto a track, into the grid,- or into a rack chain.+- **Sample player** under the Files tab: the file's real waveform (click to play from a+ point, hover for the time), Play / Stop, time readout, Loop, Auto (play on select) and a+ preview volume fader; ↑ ↓ step through files and Space plays the selected one. It stays+ hidden until you use a list and tightens in a narrow browser. Space in the arrangement+ always drives the project transport.+- **Drag and drop** onto a track, into the grid, or into a rack chain.+ - Dropping an effect onto Devices puts it between cards (an accent bar marks the spot) or+ in place of the card under the pointer; effects and presets also drop onto a return+ track or the master. While dragging over the arrangement, the target track is outlined+ in its header too.- Dropping an instrument onto an existing track **replaces the instrument** in place(clips, devices and volume are kept); dropping onto empty space creates a new track.Racks are not replaced in place.@@ -719,7 +767,12 @@ and user presets, automation, persistence and cloning.after the first launch on a new version.- **About** — the app and engine versions, the copyright notice, and a pointer to thethird-party attribution notices (`LICENSES/THIRD-PARTY-NOTICES.md`).-- **Preferences** — a consistent design (the house checkboxes, sunken fields).+- **Settings** — a larger window with a sidebar grouped into Devices, Plug-ins and General+ (each page with an icon and a short description), large switches, latency in+ milliseconds, theme buttons that preview each theme, and key-cap shortcuts with a filter.+- **Device window** (a device opened from a Drum Rack, Instrument Rack, Audio Effect Rack or+ a Nota Rhythm voice): the title bar carries the device, track, preset picker, bypass and+ S / L size switch; a footer shows where the device sits, its live voice count and type.- **Edit Tags** — the browser's tag editor.- **Devices/Clip panel in its own window** — the ⧉ button in the bottom panel's headerdetaches it (the selected clip's piano roll on top, the device chain below, both at@@ -738,7 +791,8 @@ and user presets, automation, persistence and cloning.- **Gamepads** (macOS): enable gamepad input (notes and mapped controls); the controllerlist updates on hot-plug, with a live activity indicator beside each pad that names thenote played or the control driven.-- **Plugins**: scan paths, Rescan.+- **Plug-ins**: scan paths, Rescan.+- **Downloads**: the plugin registry installer (see [Plugin hosting](#plugin-hosting)).- **Library**: library folders.- **Appearance**: **Theme** — Ember Graphite (dark), Ember Paper (light) or System, whichfollows the OS appearance and switches with it; the choice applies live and isdiff --git a/README.md b/README.mdindex 685dcbef..6ca9120e 100644--- a/README.md+++ b/README.md@@ -51,15 +51,21 @@ A quick digest — see [`FEATURES.md`](FEATURES.md) for the full, categorised lichains.- **MIDI editing** — piano roll (draw/move/stretch, quantize, velocity, live edits as oneundo step); input from a MIDI keyboard, the computer keyboard, or a **gamepad** (macOS);- **audio→MIDI** (melody / harmony / drums / slice).+ **MIDI file import** (drag a `.mid` in); **audio→MIDI** (melody / harmony / drums / slice).- **Audio** — recording (inputs and internal buses), WAV/AIFF/FLAC/MP3 import, clip- editing with fades and gain, and **warp / time-stretch** (Complex / Complex Pro).+ editing with fades, gain and a per-clip **ADSR**, and **warp / time-stretch** (Complex /+ Complex Pro).- **~35 built-in devices** — synths (subtractive, wavetable, FM, granular, physical,drum-machine and more), a full effects suite (EQ, dynamics, reverb/delay, saturation,limiting, utility), MIDI effects (arp, scale, chord, …), and Instrument / Drum / AudioEffect **racks** with macros.- **Plugin hosting** — VST3 everywhere, AU on macOS: native GUIs, state save/restore, PDC,transport sync; parameters are automatable and MIDI-learnable.+- **Downloads** — install open-source VST3 plugins (Surge XT, Dexed, Dragonfly Reverb …)+ in one click from Settings, straight from the+ [Nota plugin registry](https://github.com/nota-daw/nota-plugins-registry).+- **Browser previews** — hear presets, drum kits and effects before loading them, and+ audition samples in the Files tab's player.- **Automation & MIDI Learn** — draw/record automation on any parameter; map hardwarecontrollers to almost anything.- **Export** — master and stems to WAV (pcm16/pcm24/float32), true-peak normalize, dither,@@ -68,6 +74,19 @@ A quick digest — see [`FEATURES.md`](FEATURES.md) for the full, categorised li(off by default).- **Cross-platform** — macOS, Windows and Linux, for both x64 and arm64.+## Nota plugin registry++Nota now has its own plugin registry —+**[nota-daw/nota-plugins-registry](https://github.com/nota-daw/nota-plugins-registry)**.+It is the list of open-source VST3 plugins that Nota installs from **Settings → Downloads**:+one JSON manifest per plugin, pinned to a release asset's size and sha256, and published as a+single `index.json`.++**Writing a plugin?** Add it to the registry so every Nota user can install it in one click.+The registry's [README](https://github.com/nota-daw/nota-plugins-registry#readme) explains what+gets in (an OSI license, a VST3 in an archive rather than an installer, stable release tags)+and how to add a plugin or a new version — then open a pull request there.+## PrerequisitesCommon to every platform:@@ -96,6 +115,20 @@ sudo apt install build-essential cmake ninja-build libasound2-dev libx11-dev lib## Build & run (development)+**Don't forget the submodules.** JUCE (plugin hosting) lives in a git submodule at+`src/native/nota.engine/vendor/JUCE`, and the native build fails without it. Clone with+submodules:++```bash+git clone --recurse-submodules https://github.com/nota-daw/nota.git+```++or, in a checkout you already have (also after a pull that moves the submodule):++```bash+git submodule update --init --recursive+```+Each platform has a build script that compiles the native engine, builds the managedapp, and runs the smoke test. Then run the app with `dotnet run`.