truce-rack 1.1.3

Cross-format audio plugin host (CLAP + VST3 by default; AU, AU3, LV2 behind features)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# truce-rack

[![crates.io](https://img.shields.io/crates/v/truce-rack.svg)](https://crates.io/crates/truce-rack)
[![docs.rs](https://img.shields.io/badge/docs.rs-blue)](https://docs.rs/truce-rack)

Cross-format audio plugin host. Umbrella crate for the
[**truce-rack**][repo] workspace — re-exports the per-format
wrapper crates behind features so a downstream user can opt into
exactly the formats they need without juggling version pins
across multiple direct dependencies.

[repo]: https://github.com/truce-audio/truce-rack

## Defaults

CLAP and VST3 are the cross-platform mainstream formats and ship
enabled by default. Audio Unit and LV2 are platform-specific
enough to be opt-in.

Every wrapper forwards host transport from
`ProcessContext::transport` into its backend's native form (VST3
`ProcessContext`, CLAP `clap_event_transport`, LV2 `time:Position`,
AU host callbacks), so tempo- and grid-synced plugins work the same
across formats.

| Feature | Default | Crate it enables                                           | Platforms |
| ------- | ------- | ---------------------------------------------------------- | --------- |
| `clap`  | ✓       | [`truce-rack-clap`](https://crates.io/crates/truce-rack-clap)   | all       |
| `vst3`  | ✓       | [`truce-rack-vst3`](https://crates.io/crates/truce-rack-vst3)   | all       |
| `au`    |         | [`truce-rack-au`](https://crates.io/crates/truce-rack-au)       | Apple     |
| `au3`   |         | [`truce-rack-au3`](https://crates.io/crates/truce-rack-au3)     | Apple     |
| `lv2`   |         | [`truce-rack-lv2`](https://crates.io/crates/truce-rack-lv2) (needs system `lilv-0`) | all       |

## Usage

```toml
[dependencies]
truce-rack = "1.0"   # CLAP + VST3
```

```rust
use truce_rack::core::scanner::PluginScanner;
use truce_rack::clap::ClapScanner;
use truce_rack::vst3::Vst3Scanner;

let clap_plugins = ClapScanner::new().scan()?;
let vst3_plugins = Vst3Scanner::new().scan()?;
```

To opt into AU + LV2 too:

```toml
[dependencies]
truce-rack = { version = "1.0", features = ["au", "au3", "lv2"] }
```

## When to depend on `truce-rack` vs the per-format crates

- **`truce-rack`** — you want the convenience of one dependency
  line and aren't sensitive to the umbrella's resolver churn when
  unrelated wrappers bump.
- **Per-format crates** — you only need one or two formats, want
  the minimum possible build graph, or want to pin per-format
  versions independently. See
  [`truce-rack-core`](https://crates.io/crates/truce-rack-core)
  for the trait surface and pick wrappers à la carte.

## License

MIT or Apache-2.0, at your option.