📦 NEW: audio clips, instrument automation and five more Bitwig devices in the DAWproject import

Audio clips become builtin:audio tracks: warp markers give the file's tempo,
play start trims, loops repeat, fades and repitch carry over. Automation of
the instrument plugin's parameters (normalized, via the new "scale":
"normalized" curve option) and of the master volume is imported. From the
Bitwig project, Filter, EQ-5, Reverb, Delay-2 and Distortion map to built-in
effects; EQ-5 settled the shared EQ band types. Bus volume automation was
counted on top of the fader twice; now it adds to it like a track's.

Author: austinginder

AGENTS.md

@@ -34,10 +34,12 @@ A DAW's own devices are only names in a DAWproject. For Bitwig exports the impor
 project itself (`<name>.bwproject`, found next to the export or in `~/Documents/Bitwig Studio/Projects/
 <name>/`, or given with `--bitwig`): Drum Machine pads become one track each (plugins with their
 states, Sampler pads as `builtin:sampler`) into a bus named after the drum track, and Chain, EQ+,
-Compressor, Multiband FX-3, Peak Limiter and Tool become built-in effects, with the plugins inside
-them. Other Bitwig devices (Polymer, Filter, Reverb, ...) are listed as left out. Without the Bitwig
-project a Drum Machine becomes `builtin:drums`. Audio tracks, launcher clips and device-parameter
-automation aren't imported. `wavelength import song.bwproject` lists a Bitwig project's tracks,
+EQ-5, Filter, Reverb, Delay-2, Distortion, Compressor, Multiband FX-3, Peak Limiter and Tool become
+built-in effects, with the plugins inside them. Other Bitwig devices (Polymer, Mid-Side Split, ...)
+are listed as left out. Without the Bitwig project a Drum Machine becomes `builtin:drums`. Audio
+clips become `builtin:audio` tracks (warped clips follow the song tempo); automation of volume, pan
+and the instrument plugin's parameters comes across. Automation of plugin effects and of Bitwig's own
+devices, and launcher clips, don't. `wavelength import song.bwproject` lists a Bitwig project's tracks,
 devices, pads and plugin states. Then edit the job like any other and render it; `render
 song.dawproject` does both steps.
 

CHANGELOG.md

@@ -5,6 +5,8 @@ All notable changes to Wavelength. Versions follow semantic versioning.
 ## [Unreleased]
 
 ### Fixed
+- DAWproject import: volume automation on effect and group buses was added on top of the fader
+  twice (bus automation adds to the fader, like a track's).
 - `"stems": "none"` no longer creates an empty `stems/` folder.
 - `lint` compared every pair at every voice's note starts, so a third voice's rhythm split a pair's
   moves and hid real parallels (four parallel octaves in Fugue for the Night Shift's exposition went
@@ -24,6 +26,13 @@ measured before their fader), a render that loses a track exits 1 with `"ok": fa
 command rejects options it doesn't know.
 
 ### Added
+- DAWproject import, more of the song: audio clips become `builtin:audio` tracks (warp markers give
+  the file's tempo so clips follow the song, play start trims, looped clips repeat, fades, "repitch"
+  plays tape-style), automation of the instrument plugin's parameters and of the master volume comes
+  across, and from the Bitwig project Filter, EQ-5, Reverb, Delay-2 and Distortion become built-in
+  effects (read from how 745 projects store them; EQ-5 confirmed the EQ band types, which also fixes
+  one EQ+ type). Effects parked at 0% mix (factory drum kits' pad effects) are skipped.
+- Automation curves take `"scale": "normalized"`: values 0..1 of a plugin parameter's range.
 - MIDI files: `wavelength import song.mid` (and `render song.mid`) makes a job from a Standard MIDI
   File (types 0, 1 and 2): tempo map, time signature, markers, one track per MIDI track and channel,
   sustain pedal folded into note lengths, CC7 / CC10 / CC11 as fader, pan and rides, other CCs,

README.md

@@ -162,7 +162,7 @@ A minimal job:
 | `analyze <file.wav \| render-dir> [--start S] [--end S] [--json]` | Measures pitch, brightness, band balance, stereo width, onsets and envelope of a WAV, or of a render's mix, stems and sections. |
 | `params <plugin> [--preset N] [--state F] [--all] [--json]` | Shows parameters with ranges, current values and display text, optionally after loading a preset or state. |
 | `render <job.json> [--out DIR] [--stems float\|24\|16\|none] [--jobs N] [--json]` | Renders stems, `mix.wav` and `report.json`. Plugin tracks render in worker processes, several at once; a crashing plugin costs its track, not the song. A failed render leaves `{"ok": false}` in `report.json`, never a stale report. |
-| `import <song.dawproject> [--out DIR] [--bitwig FILE \| none] [--json]` | Turns a DAWproject export (Bitwig, Studio One, Cubase) into a job: notes, tracks with their plugins and saved states, mixer, sends, groups, tempo map, markers, volume and pan automation. For Bitwig it also reads the `.bwproject` behind the export for Bitwig's own devices: Drum Machine pads (plugins and samples), Chain, EQ+, Compressor, Multiband FX-3, Peak Limiter, Tool. Lists what didn't come across. `import song.bwproject` lists a Bitwig project's devices; `render song.dawproject` imports and renders in one step. |
+| `import <song.dawproject> [--out DIR] [--bitwig FILE \| none] [--json]` | Turns a DAWproject export (Bitwig, Studio One, Cubase) into a job: notes, tracks with their plugins and saved states, mixer, sends, groups, tempo map, markers, volume and pan automation. Audio clips (warped ones follow the song tempo) and automation of the instrument plugin's parameters come across too. For Bitwig it also reads the `.bwproject` behind the export for Bitwig's own devices: Drum Machine pads (plugins and samples), Chain, EQ+, EQ-5, Filter, Reverb, Delay-2, Distortion, Compressor, Multiband FX-3, Peak Limiter, Tool. Lists what didn't come across. `import song.bwproject` lists a Bitwig project's devices; `render song.dawproject` imports and renders in one step. |
 | `import <song.mid> [--out DIR] [--instrument PLUGIN] [--json]` | Turns a Standard MIDI File into a job: tempo map, time signature, markers, and a track per MIDI track and channel with its notes (sustain pedal folded into note lengths), volume, pan and expression, other controllers, pitch bend (with the file's bend range) and pressure. Channel 10 plays `builtin:drums`; other channels a General MIDI-family sound from the installed sample library, or `--instrument` for all of them. `render song.mid` imports and renders. |
 | `export <job.json> [--out song.mid] [--json]` | Writes the job's parts as a type 1 MIDI file to open in a DAW or notation program: tempo map (ramps stepped every 1/16 beat), time signature, markers, and a track per job track with its notes, fader, pan, rides and CC, pitch bend and pressure automation. Export, import and export again gives the same file byte for byte. |
 | `master <mix.wav> --chain <chain \| job> [--loudness L] [--lead-in S] [--out DIR] [--json]` | Masters a finished mix: plays it through a master chain (an effect list, a master object, or a song's job with its markers; a file or inline JSON) and reports loudness and true peak before and after, per section. |
@@ -210,8 +210,8 @@ render's stem loudness (`<song>/out` by default).
 
 1. Per-note pitch and level tracking in `analyze`; gain-reduction readouts for compressors and limiters.
 2. Auditions inside each instrument's range, and an envelope-depth measure for rhythmic patches.
-3. The rest of Bitwig's own devices (Filter, Reverb, Delay, EQ-5, Distortion) and device-parameter
-   automation in the DAWproject import; audio clips.
+3. DAWproject import: automation of plugin effects and of Bitwig's own devices, launcher clips, more
+   Bitwig devices (Mid-Side Split, Polymer, Phase-4).
 4. FLAC and AIFF samples, SFZ instruments, and a General MIDI SoundFont fallback.
 5. A local service with a web UI and live playback through the speakers; Audio Unit hosting.
 

docs/job-format.md

@@ -74,7 +74,7 @@ A job is one JSON object. Unknown fields are ignored.
 | `articulations` | none | Articulation name → keyswitch key (`{"long": 0, "spiccato": 1, "tremolo": 3}`). Notes pick one with `"art"`; the keyswitch note is sent 30 ms before the first note of every change. |
 | `range` | none | `[lowest, highest]` playable keys (`["G3", "C#7"]`): notes outside it get a warning in the report (sample libraries are silent there). |
 | `velocityTo` | none | Drive a controller from note velocities, one point per onset, ramping between them: `{"param": "Dynamics", "min": 0.1, "max": 1}` or `{"cc": 1, "min": 10, "max": 127}`. For libraries whose long notes take loudness from a controller instead of velocity. Explicit automation of the same target wins. |
-| `automation` | none | `gain` (dB), `rides` (dB added on top of `gain`: one curve, or named curves `{"sections": curve, "fills": curve}` that all add up, so section rides never overwrite the written fader curve), `pan` (-1..1), `params` (`{"Name": curve}`, plain values), `cc` (`{"1": curve, "64": curve}`, MIDI CC values 0-127), `pitchbend` (semitones, see `bendRange`), `pressure` (0-127). CC, pitch bend and pressure reach CLAP plugins as MIDI (or note expressions) and VST3 plugins through the parameters they map those controllers to (a warning names any they don't map). Curves are described in `effects.md` (points, steps, LFOs). |
+| `automation` | none | `gain` (dB), `rides` (dB added on top of `gain`: one curve, or named curves `{"sections": curve, "fills": curve}` that all add up, so section rides never overwrite the written fader curve), `pan` (-1..1), `params` (`{"Name": curve}` or `{"#id": curve}`, plain values; a curve object with `"scale": "normalized"` gives 0..1 of the parameter's range, as DAWs store automation), `cc` (`{"1": curve, "64": curve}`, MIDI CC values 0-127), `pitchbend` (semitones, see `bendRange`), `pressure` (0-127). CC, pitch bend and pressure reach CLAP plugins as MIDI (or note expressions) and VST3 plugins through the parameters they map those controllers to (a warning names any they don't map). Curves are described in `effects.md` (points, steps, LFOs). |
 
 `plugin` may also be `builtin:drums` or `builtin:fx` (see `effects.md`), `builtin:sampler`, or `builtin:audio`.
 

src/automation.hpp

@@ -113,6 +113,9 @@ class Envelope {
             else if (curve == "step") allStep = true;
             else throw std::runtime_error("automation curve must be linear, exp or step");
             if (j.contains("lfo")) e.lfo_ = std::make_shared<Lfo>(Lfo::parse(j["lfo"], tempo));
+            const std::string scale = j.value("scale", "plain");
+            if (scale == "normalized") e.normalized_ = true;
+            else if (scale != "plain") throw std::runtime_error("automation \"scale\" must be plain or normalized");
             if (j.contains("points")) points = &j["points"];
             else if (j.contains("value")) { e.pts_.push_back({0.0, j["value"].get<double>()}); e.step_.push_back(false); return e; }
             else throw std::runtime_error("automation object needs \"points\" or \"value\"");
@@ -139,6 +142,15 @@ class Envelope {
     }
 
     bool empty() const { return pts_.empty(); }
+    // "scale": "normalized": values are 0..1 of a plugin parameter's range (as DAWs store automation)
+    bool normalized() const { return normalized_; }
+    Envelope scaled(double lo, double hi) const {   // normalized -> the parameter's own range
+        Envelope e = *this;
+        for (auto &p : e.pts_) p.second = lo + std::clamp(p.second, 0.0, 1.0) * (hi - lo);
+        if (e.lfo_) { auto l = std::make_shared<Lfo>(*e.lfo_); l->depth *= hi - lo; for (auto &d : l->depthPts) d.second *= hi - lo; e.lfo_ = l; }
+        e.normalized_ = false;
+        return e;
+    }
     bool constant() const { return pts_.size() <= 1 && !lfo_; }
 
     double at(double sec) const {
@@ -167,6 +179,7 @@ class Envelope {
     std::vector<std::pair<double, double>> pts_;   // (seconds, value)
     std::vector<bool> step_;                        // jump (hold, then step) into this point
     bool exp_ = false;
+    bool normalized_ = false;
     std::shared_ptr<Lfo> lfo_;
 };