abletoolz 2.2.0__tar.gz → 2.2.1__tar.gz

{abletoolz-2.2.0 → abletoolz-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abletoolz
-Version: 2.2.0
+Version: 2.2.1
 Summary: Tools made for editing, fixing and analyzing Ableton Live sets.
 Author: ElixirBeats
 License-Expression: MPL-2.0
@@ -90,7 +90,7 @@ Sets inside `Backup` and `abletoolz_backup` folders are skipped. You can also pa
 
 Checking doesn't change your set, though it does write [scan results](#what-a-run-leaves-behind). All editing flags only change the set in memory until you add `-s` / `--save`. Plugin conversion has its own explicit save step, `plugins apply` (or `plugins plan --apply`).
 
-Use `-h` for the command's options and `-v` for more detail. For example, sample checks normally show missing files; `-v` shows the ones found too.
+Use `-h` for the command's options. A run prints one short block per set: what it found, with problems named, then one line for the whole run. Add `-v` to list everything behind the counts, such as every relinked file, and to see diagnostics.
 
 If you want to write your own scripts, the [Python tutorial](doc/LIBRARY.md) starts with opening a set and builds up one step at a time.
 
@@ -193,45 +193,51 @@ Arrows show implemented directions, not every format the plugin itself ships in.
 
 | Plugin | Same-plugin format swaps | Upgrade / other converter | Files inside its saved patch |
 | --- | --- | --- | --- |
-| FabFilter Pro-Q, Pro-Q 2 | None | → Pro-Q 3 VST3 or VST2 | — |
-| FabFilter Pro-C (including SC), Pro-L | None | → Pro-C 2 / Pro-L 2 VST3 or VST2, respectively | — |
-| FabFilter Saturn, Volcano 2, Timeless 2 | None | → Saturn 2 / Volcano 3 / Timeless 3 VST3 or VST2, respectively | — |
-| FabFilter Pro-C 2, Pro-DS, Pro-G, Pro-L 2, Pro-MB, Pro-Q 3, Saturn 2, Timeless 3, Volcano 3 | VST2 ↔ VST3 | None | — |
-| Valhalla Delay, FreqEcho, Plate, Room, Shimmer, Supermassive | Between VST2, VST3 and AU, any direction | None | — |
-| Kilohearts kHs effects (listed below) | VST2 ↔ VST3 | None | — |
-| Xfer Serum | VST2 ↔ VST3; AU → VST2 or VST3 | → Serum 2 VST3 / AU (experimental) | — |
-| Xfer Serum 2 | VST3 ↔ AU | None | Relink samples and referenced images |
-| Surge | None | → Surge XT VST3 / AU | — |
-| Surge XT, Surge XT Effects | VST3 ↔ AU | None | — |
+| AAS Lounge Lizard EP-4, Lounge Lizard 3 | None | → Spectrasonics Keyscape Rhodes - Classic VST3 or VST2 (approximations) | — |
+| Akai MPC Essentials | None | None | Report project references; manual repair |
 | Arturia minimoog V Original | None | → Mini V3 VST3 or VST2 | — |
 | Arturia CS-80V, CS-80 V2 | None | → CS-80 V3 VST3 or VST2 | — |
 | Arturia Piano V2, Wurli V2, ARP 2600 V2, Prophet V2, Modular V2 | None | → their V3 VST3 or VST2 | — |
 | Arturia Analog Lab 3, Analog Lab 4 | None | → Analog Lab V VST2 | — |
-| Native Instruments Absynth 3 | None | → Absynth 5 VST2 | — |
-| AAS Lounge Lizard EP-4, Lounge Lizard 3 | None | → Spectrasonics Keyscape Rhodes - Classic VST3 or VST2 (approximations) | — |
-| Ohm Force Ohmicide | None | → Ohmicide[S] VST3 or VST2 | — |
-| iZotope Ozone 8 Elements | None | → Ozone 9 VST2 | — |
-| iZotope Stutter Edit 2 | VST2 ↔ VST3 | None | — |
+| Arturia Mini V3, Prophet V3, Prophet-5 V, MS-20 V, CS-80 V3 | VST2 ↔ VST3; CS-80 V3: AU → VST3 or VST2, VST2 → AU | None | — |
+| Arturia Chorus JUN-6, Dist TUBE-CULTURE | VST3 ↔ AU | None | — |
+| Arturia CMI V | None | None | Relink samples |
 | Audio Damage Ratshack Reverb 2, DubStation 1.5, Discord 3 | None | None; mapped | — |
-| Sonimus Satson Channel | None | None; mapped | — |
-| Subsonic Labs Wolfram | None | None; mapped | — |
 | Camel Audio CamelPhat 3 | None | None; mapped | — |
-| Twin Delay | None | None; mapped | — |
-| Arturia Mini V3, Prophet V3, Prophet-5 V, MS-20 V | VST2 ↔ VST3 | None | — |
-| Native Instruments Pro-53 | None | → Arturia Prophet-5 V VST3 or VST2 (approximations) | — |
+| Devious Machines Texture | VST2 ↔ VST3 | None | Relink samples |
+| FabFilter Pro-Q, Pro-Q 2 | None | → Pro-Q 3 VST3 or VST2 | — |
+| FabFilter Pro-C (including SC), Pro-L | None | → Pro-C 2 / Pro-L 2 VST3 or VST2, respectively | — |
+| FabFilter Saturn, Volcano 2 | None | → Saturn 2 / Volcano 3 VST3 or VST2, respectively | — |
+| FabFilter Timeless 2 | VST2 ↔ VST3 | → Timeless 3 VST3 or VST2 | — |
+| FabFilter Pro-C 2, Pro-DS, Pro-G, Pro-L 2, Pro-MB, Pro-Q 3, Saturn 2, Timeless 3, Volcano 3 | VST2 ↔ VST3; Pro-C 2: AU → VST3 or VST2, VST2 → AU | None | — |
+| Goodhertz Tupe 3 | VST2 ↔ VST3 | None | — |
+| iZotope Ozone 8 Elements | None | → Ozone 9 VST2 | — |
+| iZotope Stutter Edit 2 | VST2 ↔ VST3 | None | — |
+| iZotope Iris | None | None | Report sample references; manual repair |
+| iZotope Trash | None | → Trash 2 VST2 | — |
+| iZotope Ozone 9 Exciter | None | None; mapped state, VST3 writing incomplete | — |
+| Kilohearts kHs effects (listed below) | VST2 ↔ VST3 | None | — |
 | KORG MS-20, Legacy Cell | None | → Arturia MS-20 V VST3 or VST2 (experimental) | — |
 | KORG MDE-X, Polysix, WAVESTATION | None | None; recognized only | — |
-| Goodhertz Tupe 3 | VST2 ↔ VST3 | None | — |
-| Serato Sample | VST2 ↔ VST3 | None | Relink samples |
-| Devious Machines Texture | VST2 ↔ VST3 | None | Relink samples |
+| Native Instruments Absynth 3 | None | → Absynth 5 VST2 | — |
+| Native Instruments Pro-53 | None | → Arturia Prophet-5 V VST3 or VST2 (approximations) | — |
 | Native Instruments Battery 4 | None | None | Relink samples and kits |
 | Native Instruments Kontakt 5, Kontakt 5 16out | None | None | Relink mapped instrument/library references |
 | Native Instruments Maschine 2, Maschine 2 FX | None | None | Relink samples, groups and sounds |
 | Native Instruments Reaktor 6 | None | None | Relink ensemble references |
-| Arturia CMI V; xfadelooper | None | None | Relink samples |
-| iZotope Iris; Akai MPC Essentials | None | None | Report sample / project references, respectively; manual repair |
-| iZotope Trash | None | → Trash 2 VST2 | — |
-| Native Instruments Massive; iZotope Ozone 9 Exciter | None | None; mapped state, VST3 writing incomplete | — |
+| Native Instruments Massive | None | None; mapped state, VST3 writing incomplete | — |
+| Ohm Force Ohmicide | None | → Ohmicide[S] VST3 or VST2 | — |
+| Serato Sample | VST2 ↔ VST3 | None | Relink samples |
+| Sonimus Satson Channel | None | None; mapped | — |
+| Subsonic Labs Wolfram | None | None; mapped | — |
+| Surge | None | → Surge XT VST3 / AU | — |
+| Surge XT, Surge XT Effects | VST3 ↔ AU | None | — |
+| Twin Delay | None | None; mapped | — |
+| u-he Podolski | VST2 ↔ VST3 | None | — |
+| Valhalla Delay, FreqEcho, Plate, Room, Shimmer, Supermassive | Between VST2, VST3 and AU, any direction | None | — |
+| xfadelooper | None | None | Relink samples |
+| Xfer Serum | VST2 ↔ VST3; AU → VST2 or VST3 | → Serum 2 VST3 / AU (experimental) | — |
+| Xfer Serum 2 | VST3 ↔ AU | None | Relink samples and referenced images |
 
 The kHs effects covered are 3-Band EQ, Bitcrush, Channel Mixer, Chorus, Clipper, Comb Filter, Compactor, Compressor, Convolver, Delay, Distortion, Dual Delay, Dynamics, Ensemble, Filter, Flanger, Formant Filter, Frequency Shifter, Gain, Gate, Haas, Ladder Filter, Limiter, Nonlinear Filter, Phase Distortion, Phaser, Pitch Shifter, Resonator, Reverb, Reverser, Ring Mod, Shaper, Stereo, Tape Stop, Trance Gate and Transient Shaper. Evidence varies across these maps; a listed implementation is not a claim that every patch has been auditioned.
 
@@ -279,6 +285,18 @@ A plan file that already exists isn't overwritten unless you pass `--force`. Ope
 
 To skip checking the file, `abletoolz plugins plan "D:/Ableton Projects" --apply` writes the plan and applies its suggestions straight away.
 
+### Convert for another computer
+
+A plugin that loads here is in the plan too, left at `null`. Its comment also lists formats marked "not installed here", which you can pick for a computer that has them, such as the AU when you give a set to a friend on a Mac:
+
+```yaml
+- plugin: Chorus JUN-6
+  format: VST3
+  convert_to: chorus_jun_6_au
+```
+
+Apply it the same way. The other computer still needs the plugin installed.
+
 ### What converting costs
 
 A saved patch and Live's automation are separate things. Even when a patch carries over, a converted device currently loses its automation and clip envelopes, MIDI and macro mappings, because the target's controls can have different numbers. Its configured control list is rebuilt where supported, or left empty.
@@ -287,7 +305,6 @@ Upgrades can also leave out or approximate settings the target has no equivalent
 
 ### A few common cases
 
-- **Sending a set to another computer:** the target plugin doesn't have to be installed here. Choose an offered format the other computer can use; that computer still needs the plugin installed.
 - **An older set:** Live 9 and 10.0 sets can't hold a VST3, so abletoolz moves such a set up to Live 10.1's format when it writes one, and the plan lists what that changes. A Live 9.0 set using some of Live's own devices can't be moved; open and save it in a newer Live first.
 - **Old wrapped VST2 plugins:** `abletoolz plugins routes` lists measured recovery routes and the binaries found for them. Use `--plugin-dir "D:/VstPlugins"` to restrict the recovery-file search to that folder.
 - **Missing samples as well as plugins:** fix and save the sample references first, then make the conversion plan. Converting a patch doesn't relink its files.
@@ -318,6 +335,8 @@ abletoolz "my song.als" --unfold --set-track-heights 68 --set-track-widths 24 -s
 
 `--list-tracks` lists track information. `-x` / `--xml` writes the uncompressed set XML beside the set, which is useful for exploring its structure. Live can also open uncompressed XML renamed to `.als`, provided the document is valid.
 
+If your DJ tracks already have a tempo, downbeat and drop cue, abletoolz can make clips and `.asd` files that open in Live already warped and on the bar: see [pre-warped clips for DJing](doc/DJ_CLIPS.md).
+
 ## Saving your changes
 
 `-s` / `--save` saves ordinary edits in the original location. Before replacing a set, abletoolz copies it to `abletoolz_backup/set_name__1.als` beside the original. If that name exists, it uses `__2`, then `__3`, so earlier backups are kept. A set the run doesn't change isn't written.
@@ -423,9 +442,9 @@ For a plugin whose maker is gone, see [salvaging an old plugin](doc/DEVELOPMENT.
 
 Some things still need work:
 
-- More plugin maps, conversions and support for carrying automation across them.
+- More plugin maps and conversions.
+- Keeping a converted device's automation, clip envelopes and MIDI and macro mappings, by matching its old controls to the new plugin's.
 - Making copies for older Live versions reliable. Python's `save_as` is experimental and some copies still crash Live.
-- Time signatures other than 4/4 and signature changes within a set.
 - More ways for scripts and other programs to work with sets.
 
-`--dump-plugins` and `-x` help inspect plugin settings and set XML. `abletoolz-dj-crates` builds pre-warped `.alc` clips from a TSV of track analysis; run `abletoolz-dj-crates --help` for its options.
+`--dump-plugins` and `-x` help inspect plugin settings and set XML.

{abletoolz-2.2.0 → abletoolz-2.2.1}/README.md

@@ -51,7 +51,7 @@ Sets inside `Backup` and `abletoolz_backup` folders are skipped. You can also pa
 
 Checking doesn't change your set, though it does write [scan results](#what-a-run-leaves-behind). All editing flags only change the set in memory until you add `-s` / `--save`. Plugin conversion has its own explicit save step, `plugins apply` (or `plugins plan --apply`).
 
-Use `-h` for the command's options and `-v` for more detail. For example, sample checks normally show missing files; `-v` shows the ones found too.
+Use `-h` for the command's options. A run prints one short block per set: what it found, with problems named, then one line for the whole run. Add `-v` to list everything behind the counts, such as every relinked file, and to see diagnostics.
 
 If you want to write your own scripts, the [Python tutorial](doc/LIBRARY.md) starts with opening a set and builds up one step at a time.
 
@@ -154,45 +154,51 @@ Arrows show implemented directions, not every format the plugin itself ships in.
 
 | Plugin | Same-plugin format swaps | Upgrade / other converter | Files inside its saved patch |
 | --- | --- | --- | --- |
-| FabFilter Pro-Q, Pro-Q 2 | None | → Pro-Q 3 VST3 or VST2 | — |
-| FabFilter Pro-C (including SC), Pro-L | None | → Pro-C 2 / Pro-L 2 VST3 or VST2, respectively | — |
-| FabFilter Saturn, Volcano 2, Timeless 2 | None | → Saturn 2 / Volcano 3 / Timeless 3 VST3 or VST2, respectively | — |
-| FabFilter Pro-C 2, Pro-DS, Pro-G, Pro-L 2, Pro-MB, Pro-Q 3, Saturn 2, Timeless 3, Volcano 3 | VST2 ↔ VST3 | None | — |
-| Valhalla Delay, FreqEcho, Plate, Room, Shimmer, Supermassive | Between VST2, VST3 and AU, any direction | None | — |
-| Kilohearts kHs effects (listed below) | VST2 ↔ VST3 | None | — |
-| Xfer Serum | VST2 ↔ VST3; AU → VST2 or VST3 | → Serum 2 VST3 / AU (experimental) | — |
-| Xfer Serum 2 | VST3 ↔ AU | None | Relink samples and referenced images |
-| Surge | None | → Surge XT VST3 / AU | — |
-| Surge XT, Surge XT Effects | VST3 ↔ AU | None | — |
+| AAS Lounge Lizard EP-4, Lounge Lizard 3 | None | → Spectrasonics Keyscape Rhodes - Classic VST3 or VST2 (approximations) | — |
+| Akai MPC Essentials | None | None | Report project references; manual repair |
 | Arturia minimoog V Original | None | → Mini V3 VST3 or VST2 | — |
 | Arturia CS-80V, CS-80 V2 | None | → CS-80 V3 VST3 or VST2 | — |
 | Arturia Piano V2, Wurli V2, ARP 2600 V2, Prophet V2, Modular V2 | None | → their V3 VST3 or VST2 | — |
 | Arturia Analog Lab 3, Analog Lab 4 | None | → Analog Lab V VST2 | — |
-| Native Instruments Absynth 3 | None | → Absynth 5 VST2 | — |
-| AAS Lounge Lizard EP-4, Lounge Lizard 3 | None | → Spectrasonics Keyscape Rhodes - Classic VST3 or VST2 (approximations) | — |
-| Ohm Force Ohmicide | None | → Ohmicide[S] VST3 or VST2 | — |
-| iZotope Ozone 8 Elements | None | → Ozone 9 VST2 | — |
-| iZotope Stutter Edit 2 | VST2 ↔ VST3 | None | — |
+| Arturia Mini V3, Prophet V3, Prophet-5 V, MS-20 V, CS-80 V3 | VST2 ↔ VST3; CS-80 V3: AU → VST3 or VST2, VST2 → AU | None | — |
+| Arturia Chorus JUN-6, Dist TUBE-CULTURE | VST3 ↔ AU | None | — |
+| Arturia CMI V | None | None | Relink samples |
 | Audio Damage Ratshack Reverb 2, DubStation 1.5, Discord 3 | None | None; mapped | — |
-| Sonimus Satson Channel | None | None; mapped | — |
-| Subsonic Labs Wolfram | None | None; mapped | — |
 | Camel Audio CamelPhat 3 | None | None; mapped | — |
-| Twin Delay | None | None; mapped | — |
-| Arturia Mini V3, Prophet V3, Prophet-5 V, MS-20 V | VST2 ↔ VST3 | None | — |
-| Native Instruments Pro-53 | None | → Arturia Prophet-5 V VST3 or VST2 (approximations) | — |
+| Devious Machines Texture | VST2 ↔ VST3 | None | Relink samples |
+| FabFilter Pro-Q, Pro-Q 2 | None | → Pro-Q 3 VST3 or VST2 | — |
+| FabFilter Pro-C (including SC), Pro-L | None | → Pro-C 2 / Pro-L 2 VST3 or VST2, respectively | — |
+| FabFilter Saturn, Volcano 2 | None | → Saturn 2 / Volcano 3 VST3 or VST2, respectively | — |
+| FabFilter Timeless 2 | VST2 ↔ VST3 | → Timeless 3 VST3 or VST2 | — |
+| FabFilter Pro-C 2, Pro-DS, Pro-G, Pro-L 2, Pro-MB, Pro-Q 3, Saturn 2, Timeless 3, Volcano 3 | VST2 ↔ VST3; Pro-C 2: AU → VST3 or VST2, VST2 → AU | None | — |
+| Goodhertz Tupe 3 | VST2 ↔ VST3 | None | — |
+| iZotope Ozone 8 Elements | None | → Ozone 9 VST2 | — |
+| iZotope Stutter Edit 2 | VST2 ↔ VST3 | None | — |
+| iZotope Iris | None | None | Report sample references; manual repair |
+| iZotope Trash | None | → Trash 2 VST2 | — |
+| iZotope Ozone 9 Exciter | None | None; mapped state, VST3 writing incomplete | — |
+| Kilohearts kHs effects (listed below) | VST2 ↔ VST3 | None | — |
 | KORG MS-20, Legacy Cell | None | → Arturia MS-20 V VST3 or VST2 (experimental) | — |
 | KORG MDE-X, Polysix, WAVESTATION | None | None; recognized only | — |
-| Goodhertz Tupe 3 | VST2 ↔ VST3 | None | — |
-| Serato Sample | VST2 ↔ VST3 | None | Relink samples |
-| Devious Machines Texture | VST2 ↔ VST3 | None | Relink samples |
+| Native Instruments Absynth 3 | None | → Absynth 5 VST2 | — |
+| Native Instruments Pro-53 | None | → Arturia Prophet-5 V VST3 or VST2 (approximations) | — |
 | Native Instruments Battery 4 | None | None | Relink samples and kits |
 | Native Instruments Kontakt 5, Kontakt 5 16out | None | None | Relink mapped instrument/library references |
 | Native Instruments Maschine 2, Maschine 2 FX | None | None | Relink samples, groups and sounds |
 | Native Instruments Reaktor 6 | None | None | Relink ensemble references |
-| Arturia CMI V; xfadelooper | None | None | Relink samples |
-| iZotope Iris; Akai MPC Essentials | None | None | Report sample / project references, respectively; manual repair |
-| iZotope Trash | None | → Trash 2 VST2 | — |
-| Native Instruments Massive; iZotope Ozone 9 Exciter | None | None; mapped state, VST3 writing incomplete | — |
+| Native Instruments Massive | None | None; mapped state, VST3 writing incomplete | — |
+| Ohm Force Ohmicide | None | → Ohmicide[S] VST3 or VST2 | — |
+| Serato Sample | VST2 ↔ VST3 | None | Relink samples |
+| Sonimus Satson Channel | None | None; mapped | — |
+| Subsonic Labs Wolfram | None | None; mapped | — |
+| Surge | None | → Surge XT VST3 / AU | — |
+| Surge XT, Surge XT Effects | VST3 ↔ AU | None | — |
+| Twin Delay | None | None; mapped | — |
+| u-he Podolski | VST2 ↔ VST3 | None | — |
+| Valhalla Delay, FreqEcho, Plate, Room, Shimmer, Supermassive | Between VST2, VST3 and AU, any direction | None | — |
+| xfadelooper | None | None | Relink samples |
+| Xfer Serum | VST2 ↔ VST3; AU → VST2 or VST3 | → Serum 2 VST3 / AU (experimental) | — |
+| Xfer Serum 2 | VST3 ↔ AU | None | Relink samples and referenced images |
 
 The kHs effects covered are 3-Band EQ, Bitcrush, Channel Mixer, Chorus, Clipper, Comb Filter, Compactor, Compressor, Convolver, Delay, Distortion, Dual Delay, Dynamics, Ensemble, Filter, Flanger, Formant Filter, Frequency Shifter, Gain, Gate, Haas, Ladder Filter, Limiter, Nonlinear Filter, Phase Distortion, Phaser, Pitch Shifter, Resonator, Reverb, Reverser, Ring Mod, Shaper, Stereo, Tape Stop, Trance Gate and Transient Shaper. Evidence varies across these maps; a listed implementation is not a claim that every patch has been auditioned.
 
@@ -240,6 +246,18 @@ A plan file that already exists isn't overwritten unless you pass `--force`. Ope
 
 To skip checking the file, `abletoolz plugins plan "D:/Ableton Projects" --apply` writes the plan and applies its suggestions straight away.
 
+### Convert for another computer
+
+A plugin that loads here is in the plan too, left at `null`. Its comment also lists formats marked "not installed here", which you can pick for a computer that has them, such as the AU when you give a set to a friend on a Mac:
+
+```yaml
+- plugin: Chorus JUN-6
+  format: VST3
+  convert_to: chorus_jun_6_au
+```
+
+Apply it the same way. The other computer still needs the plugin installed.
+
 ### What converting costs
 
 A saved patch and Live's automation are separate things. Even when a patch carries over, a converted device currently loses its automation and clip envelopes, MIDI and macro mappings, because the target's controls can have different numbers. Its configured control list is rebuilt where supported, or left empty.
@@ -248,7 +266,6 @@ Upgrades can also leave out or approximate settings the target has no equivalent
 
 ### A few common cases
 
-- **Sending a set to another computer:** the target plugin doesn't have to be installed here. Choose an offered format the other computer can use; that computer still needs the plugin installed.
 - **An older set:** Live 9 and 10.0 sets can't hold a VST3, so abletoolz moves such a set up to Live 10.1's format when it writes one, and the plan lists what that changes. A Live 9.0 set using some of Live's own devices can't be moved; open and save it in a newer Live first.
 - **Old wrapped VST2 plugins:** `abletoolz plugins routes` lists measured recovery routes and the binaries found for them. Use `--plugin-dir "D:/VstPlugins"` to restrict the recovery-file search to that folder.
 - **Missing samples as well as plugins:** fix and save the sample references first, then make the conversion plan. Converting a patch doesn't relink its files.
@@ -279,6 +296,8 @@ abletoolz "my song.als" --unfold --set-track-heights 68 --set-track-widths 24 -s
 
 `--list-tracks` lists track information. `-x` / `--xml` writes the uncompressed set XML beside the set, which is useful for exploring its structure. Live can also open uncompressed XML renamed to `.als`, provided the document is valid.
 
+If your DJ tracks already have a tempo, downbeat and drop cue, abletoolz can make clips and `.asd` files that open in Live already warped and on the bar: see [pre-warped clips for DJing](doc/DJ_CLIPS.md).
+
 ## Saving your changes
 
 `-s` / `--save` saves ordinary edits in the original location. Before replacing a set, abletoolz copies it to `abletoolz_backup/set_name__1.als` beside the original. If that name exists, it uses `__2`, then `__3`, so earlier backups are kept. A set the run doesn't change isn't written.
@@ -384,9 +403,9 @@ For a plugin whose maker is gone, see [salvaging an old plugin](doc/DEVELOPMENT.
 
 Some things still need work:
 
-- More plugin maps, conversions and support for carrying automation across them.
+- More plugin maps and conversions.
+- Keeping a converted device's automation, clip envelopes and MIDI and macro mappings, by matching its old controls to the new plugin's.
 - Making copies for older Live versions reliable. Python's `save_as` is experimental and some copies still crash Live.
-- Time signatures other than 4/4 and signature changes within a set.
 - More ways for scripts and other programs to work with sets.
 
-`--dump-plugins` and `-x` help inspect plugin settings and set XML. `abletoolz-dj-crates` builds pre-warped `.alc` clips from a TSV of track analysis; run `abletoolz-dj-crates --help` for its options.
+`--dump-plugins` and `-x` help inspect plugin settings and set XML.

{abletoolz-2.2.0 → abletoolz-2.2.1}/abletoolz/__init__.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from collections.abc import Callable
 
-__version__ = "2.2.0"
+__version__ = "2.2.1"
 
 
 def __getattr__(name: str) -> Callable[..., int]:

{abletoolz-2.2.0 → abletoolz-2.2.1}/abletoolz/cli.py

@@ -21,7 +21,6 @@ from collections.abc import Sequence
 import pydantic
 
 from abletoolz import __version__
-from abletoolz.ansi import CB, B, C, G, M, R, Y
 from abletoolz.formats import live_document
 from abletoolz.live_set import AbletonSet
 from abletoolz.live_set.apply_ops import OpsDocument, apply_ops
@@ -50,8 +49,8 @@ def is_valid_dir_path(path: str) -> str:
     """Refuse a Windows path whose trailing backslash escaped its closing quote."""
     if sys.platform.startswith("win") and '"' in path:
         raise argparse.ArgumentTypeError(
-            f"{R}Windows paths must not end in backslash: \n'C:\\somepath\\'(BAD)\n'C:\\somepath' "
-            f"(GOOD)\nThis is due to a bug in how Windows handles backslashes before quotes."
+            "Windows paths must not end in backslash: \n'C:\\somepath\\'(BAD)\n'C:\\somepath' "
+            "(GOOD)\nThis is due to a bug in how Windows handles backslashes before quotes."
         )
     return path
 
@@ -356,7 +355,7 @@ def run_apply_ops(args: argparse.Namespace) -> int:
     """
     output_path: pathlib.Path = args.output
     if output_path.exists():
-        logger.error("%sOutput %s already exists, refusing to overwrite.", R, output_path)
+        console.problem(f"Output {output_path} already exists, refusing to overwrite.")
         return 1
     ableton_set = AbletonSet(pathlib.Path(args.srcs[0]))
     if not ableton_set.parse():
@@ -367,7 +366,7 @@ def run_apply_ops(args: argparse.Namespace) -> int:
         live_document.write_new(output_path, live_document.encode(ableton_set.root))
     # TypeError and LookupError are a value of the wrong kind for a setting, or a setting this set lacks.
     except (pydantic.ValidationError, ValueError, TypeError, LookupError, OSError) as exc:
-        logger.error("%sCould not apply ops: %s", R, exc)
+        console.problem(f"Could not apply ops: {exc}")
         return 1
     document = {
         "applied": len(results),
@@ -376,7 +375,7 @@ def run_apply_ops(args: argparse.Namespace) -> int:
     }
     print(json.dumps(document, separators=(",", ":")))
     console.render_applied_ops(results)
-    logger.info("%sApplied %s op(s) and saved to %s", G, len(results), output_path)
+    console.say(f"Applied {len(results)} op(s) and saved to {output_path}")
     return 0
 
 
@@ -396,12 +395,12 @@ def process(args: argparse.Namespace, config: AbletoolzConfig, locations: Locati
     """Run the command ``args`` names and answer the exit code; ``argv`` is recorded in the run report."""
     db_path = args.db_path if args.db_path is not None else locations.sample_db
     if args.db_prune:
-        database.prune_db(db_path)
+        console.say(f"Removed {database.prune_db(db_path)} file(s) that no longer exist from {db_path}")
         return 0
     if args.db:
         folders = args.srcs or [str(path) for path in config.file_paths]
         if not folders:
-            logger.error("%sNo folders given, and none under file_database.paths in config.yaml.", R)
+            console.problem("No folders given, and none under file_database.paths in config.yaml.")
             return 1
         database.create_or_update_db(
             folders,
@@ -409,30 +408,32 @@ def process(args: argparse.Namespace, config: AbletoolzConfig, locations: Locati
             backend=args.db_backend,
             workers=args.db_workers,
         )
+        for built in (db_path, database.plugin_files_db_path(db_path)):
+            if built.exists():
+                console.say(f"{built}: {database.file_count(built)} file(s)")
         return 0
     db = None
     plugin_files_db = None
     if args.fix_samples_collect or args.fix_samples_absolute:
-        logger.info("%sLoading db...", M)
         db = database.load_db(db_path)
         plugin_files_path = database.plugin_files_db_path(db_path)
         if plugin_files_path.exists():
             plugin_files_db = database.load_plugin_files_db(plugin_files_path)
         else:
-            logger.info("%sNo plugin files database at %s; run --db to build it", Y, plugin_files_path)
+            console.attention(f"No plugin files database at {plugin_files_path}; run --db to build it")
 
     started = datetime.datetime.now().astimezone()
     try:
         pathlib_objects = find_sets(args.srcs)
         if not pathlib_objects:
-            logger.info("%sError, no sets to process!", R)
+            console.problem("No sets to process.")
             return 1
         try:
             jobs = set_workers(args.jobs, len(pathlib_objects))
         except ValueError as error:
-            logger.error("%s%s", R, error)
+            console.problem(str(error))
             return 2
-        logger.info("%sUsing %s set worker(s)", C, jobs)
+        console.hint(f"{len(pathlib_objects)} set(s), {jobs} at a time")
         job = SetJob.from_args(args)
         records = batch.run_sets(
             job,
@@ -451,24 +452,8 @@ def process(args: argparse.Namespace, config: AbletoolzConfig, locations: Locati
     if records is None:
         return 130
     run = report.build(records, command=list(argv), started=started)
-    failed = [record.path for record in records if record.error is not None]
-    logger.info(
-        "%sTook %s to process %s set(s): %s%s ok%s, %s%s failed",
-        CB,
-        run.finished - started,
-        len(pathlib_objects),
-        G,
-        len(pathlib_objects) - len(failed),
-        CB,
-        R if failed else G,
-        len(failed),
-    )
-    logger.info("%sWrote the run report to %s%s", M, B, report.write(run, report_directory(args)))
-    if failed:
-        for path in failed:
-            logger.info("%sFailed to process: %s", R, path)
-        return 1
-    return 0
+    console.render_run(records, elapsed=run.finished - started, report=report.write(run, report_directory(args)))
+    return 1 if any(record.error is not None for record in records) else 0
 
 
 def main(
@@ -495,7 +480,7 @@ def main(
             try:
                 config = load_config(locations.config_file) if config is None else config
             except ValueError as error:
-                logger.error("%s", error)
+                console.problem(str(error))
                 return 2
             return run_plugin_commands(argv[1:], config=config, locations=locations)
         args = parse_arguments(argv)
@@ -503,7 +488,7 @@ def main(
         return exited.code if isinstance(exited.code, int) else 0
 
     machine_readable = bool(args.describe or args.apply_ops or args.search_samples is not None)
-    console.configure_logging(machine_readable=machine_readable, verbose=args.verbose)
+    console.setup(verbose=args.verbose, machine_readable=machine_readable)
     if args.plugin_maps:
         console.render_catalog(CATALOG)
         return 0
@@ -516,7 +501,7 @@ def main(
     try:
         config = load_config(locations.config_file) if config is None else config
     except ValueError as error:
-        logger.error("%s", error)
+        console.problem(str(error))
         return 2
     locations = locations.with_plugin_folders(config.plugin_paths)
     if args.plugin_db: