Skip to content

Commit 0e530fb

Browse files
Librarian page: file-only patch librarian (import/export .syx, names, tags, backup/restore, undo)
Pure C++ core with tests; native JUCE view ported from the mockup. Device grab/send/audition stay off until the Novation Librarian traffic is captured. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S9jrKvEqSepAg8JRh5QJCL
1 parent 4df811d commit 0e530fb

14 files changed

Lines changed: 1159 additions & 1058 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,9 @@ Controller plugin for the Novation UltraNova and MiniNova on Linux.
1919
- The backend follows the rules printed in that document: nrpnMSB is 0 at power-up and after every data entry (so the panel's two-message NRPNs are understood), 14 bit values are sent as dataMSB then dataLSB, other controllers inside a sequence do not break it, touch and solo use 0..63 off and 64..127 on.
2020
- Outgoing messages are queued: the newest value per parameter wins, parameters go out in turn, and an NRPN sequence is never cut in half. At most 48 messages leave per audio block.
2121
- Global / audio setup values are never automated and are not sent by "Send all".
22-
- **None are tested on the real device yet.** Value ranges and names of choices (filter types, waveforms, effects, mod sources) are not in the source, so ranges are assumed 0 to 127 and marked that way in the plugin. No SysEx and no patch librarian yet. Nothing is sent that is not in the map.
22+
- **None are tested on the real device yet.** Value ranges and names of choices (filter types, waveforms, effects, mod sources) are not in the source, so ranges are assumed 0 to 127 and marked that way in the plugin. Nothing is sent that is not in the map.
2323
- Tests (`sh tests/run.sh`, pure C++, no JUCE): a software model of the device written from the document checks every map entry at its minimum, middle, maximum and default on three MIDI channels, plus decoder, queue, device-inquiry parsing and fuzz runs under address and undefined-behaviour checks. The model checks that our messages follow the document, it is not a recording of the real device.
24+
- **Librarian page (files only):** open, edit, search, import, export, back up and restore patch banks (.syx files) in a library folder, with category, genre, favourites and undo. It never talks to the synth: Grab, Init, audition and send wait for a capture of the Novation Librarian (the SysEx request message is in no document we have). Covered by `tests/test_library.cpp`.
2425
- Builds in CI on Linux, Windows and macOS. Not tested in a DAW yet.
2526

2627
How it behaves: every entry is an automatable parameter (except Global). Moving it sends MIDI to the device, and incoming CC from the device moves it; incoming CC is consumed, never echoed back. Turn on CC receive and transmit on the device.

‎ROADMAP.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Editor for the Novation UltraNova, in the look of the Novation editor.
99
- [x] Full NRPN map (374 entries plus ClockBPM 14 bit), generated by tools/gen_map.py
1010
- [x] Backend rules from the source: nrpnMSB reset, 14 bit data, packed bit helpers, outgoing queue, device inquiry parser
1111
- [x] Device model and tests for every map entry, fuzz runs
12+
- [x] Librarian page, file side: .syx banks in a library folder, tree, patch list (name, category, genre, favourite), rename, reorder, remove, import and export, drag and drop, search, undo and redo, backup and restore (src/Library.h, tests/test_library.cpp). Never sends anything to the synth
1213

1314
## Next
1415
- [ ] Device inquiry in the plugin (Identity request on connect, show what answered); the parser exists, the host MIDI path for SysEx still has to be proven
@@ -21,7 +22,8 @@ Editor for the Novation UltraNova, in the look of the Novation editor.
2122

2223
- [ ] Wave table names and the CC value to name mapping (the MIDI doc gives CC 19, 29 and 41 for the oscillator waveforms but no value list)
2324
- [ ] Real MIDI I/O behind the mockup controls
24-
- [ ] Librarian page with backup and restore
25+
- [ ] Librarian, device side (needs a capture of the Novation Librarian on Windows: the request for one patch and for a bank, and what the synth answers): Grab, send, audition, Reset (Init), reading the synth's banks
26+
- [ ] Librarian: test with a real 128 patch bank file and on the real synth; drag a bank out of the window; own category and genre lists in settings
2527

2628
## Every cat plugin
2729
- Draw through `catui::RenderGate` so meters and animations stop when the window is not in front (audio, automation and MIDI keep running)

0 commit comments

Comments
 (0)