Skip to content

armgit / nota

Public Imported from GitHub
0

Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.

(docs) Update docs

Egor Khindikaynenc7e976a18624
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 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>`. W
catalog entry matches exactly, the lookup falls back to format + name + uid, so a project
still 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 must
match 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 are
copied into `<data>/plugins/VST3/<id>/`, which is registered as a scan path. Set
diff --git a/BUILD.md b/BUILD.md
index 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
```bash
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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 corners
set 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 the
plug-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's
header. A new Synth opens small. The project remembers each Synth's size, and presets
don'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-25
diff --git a/FEATURES.md b/FEATURES.md
index 76f95fcf..b816d83b 100644
--- a/FEATURES.md
+++ b/FEATURES.md
@@ -2,7 +2,7 @@
# Nota — full feature list
A 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 is
implemented 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 editing
operation.
+- **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 a
selection (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 the
visible 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 the
arrangement, 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; a
velocity 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 MIDI
clip, so steps written here appear in the piano roll and notes drawn there light up as
steps.
+- **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** plays
MIDI (the S–K row, sharps on W E T Y U) — including while a hosted plugin window has
focus.
@@ -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 a
MIDI 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-click
to 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, gamepad
stick 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 hands
control 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 and
pan variation, stereo spread, **Dry/Wet** against the sample itself, an LP/HP/BP filter
and 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 factory
presets in nine folders; every preset outside Basics brings its own source (29 synthesized
on 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`), scan
paths 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 editor
window 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 the
search 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 the
third-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 header
detaches 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 controller
list updates on hot-plug, with a live activity indicator beside each pad that names the
note 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, which
follows the OS appearance and switches with it; the choice applies live and is
diff --git a/README.md b/README.md
index 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 li
chains.
- **MIDI editing** — piano roll (draw/move/stretch, quantize, velocity, live edits as one
undo 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 / Audio
Effect **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 hardware
controllers 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.
+
## Prerequisites
Common 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 managed
app, and runs the smoke test. Then run the app with `dotnet run`.