nvrl
f36ff0780c
Check and Windows preview / check (anvil) (push) Successful in 2m41s
Check and Windows preview / check (crucible) (push) Successful in 2m7s
Check and Windows preview / check (patina) (push) Successful in 2m5s
Check and Windows preview / check (rivet) (push) Successful in 1m33s
Check and Windows preview / previews (push) Successful in 1m10s
Check and Windows preview / windows (push) Successful in 2m2s
Independent plugin release / publish (push) Successful in 8s
Independent plugin release / plan (push) Successful in 7s
Independent plugin release / build (push) Successful in 3m3s
Two new CLAP effects aimed at riddim and dubstep production, plus shared crates so all four plugins keep one look and reuse DSP. Anvil 0.1.0 (io.storyboard.sub-anchor): - Replaces the band below Split with a clean mono sine. Every note gets the same peak level and restarts at the same phase, so switch-ups keep their weight and kick hits line up. - Pitch and note starts come from the audio (YIN, 80 ms lookahead reported to the host) or from MIDI notes sent to the effect. - Dynamics, Drive, Octave, Glide, Phase, Gate and Keep; Solo sub monitor, note readout, level meters and a low-band oscilloscope. Crucible 0.1.0 (io.storyboard.resampler): - Records its input continuously in a lock-free ring with host transport markers. Capture takes the newest 1-16 complete bars on the bar grid, following tempo changes, or the newest audio when stopped. - Grid (straight and triplet) or transient slicing, manual cuts, slice audition without audio-thread allocation. - Export writes the loop, trimmed, declicked and normalised slices named and tagged with their root note, and an optional 2048-sample wavetable for Serum and Vital. Shared: - common-ui holds the palette, fonts, knobs and panels taken from Patina; Patina renders identically. Rotary knobs at their minimum no longer tessellate a zero-length arc into NaN vertices. - common-dsp holds biquads, a Linkwitz-Riley crossover, YIN, note helpers and a float WAV writer with sampler root and Serum frame chunks. - Catalog, CI matrix, release tags, editor previews and docs cover both plugins; a script test keeps the catalog and workflows in step.
87 lines
4.0 KiB
Markdown
87 lines
4.0 KiB
Markdown
# Rivet & Patina
|
|
|
|
Four Rust CLAP plugins for writing, designing and mixing bass music.
|
|
|
|
| Plugin | Purpose | Guide |
|
|
| --- | --- | --- |
|
|
| **Rivet** | Tell a MIDI motif as a story on a storyboard of roles, with joined seams | [Rivet](docs/rivet/README.md) |
|
|
| **Patina** | Smooth harsh resonances while retaining tone and transient character | [Patina](docs/patina/README.md) |
|
|
| **Anvil** | Give every bass note the same clean sub: one level, one start phase | [Anvil](docs/anvil/README.md) |
|
|
| **Crucible** | Capture the last bars, slice them and export clean, key-labelled samples | [Crucible](docs/crucible/README.md) |
|
|
|
|
The names come from metalwork: a **rivet** joins pieces; **patina** changes a
|
|
surface while leaving its character; an **anvil** is the solid base everything is
|
|
struck on; a **crucible** melts material down to be cast again. They share a Rust foundation and keep
|
|
their own musical purpose, code, documentation, and version.
|
|
|
|
## Install
|
|
|
|
Download the desired plugin's Windows ZIP from its Gitea release. Extract it
|
|
and copy its `.clap` file (`Rivet.clap`, `Patina.clap`, `Anvil.clap` or
|
|
`Crucible.clap`) into:
|
|
|
|
```text
|
|
C:\Program Files\Common Files\CLAP\
|
|
```
|
|
|
|
In FL Studio 2024.1 or newer, open **Options → Manage plugins**, enable
|
|
**Verify plugins**, and **Find installed plugins**. Load Rivet in the Channel Rack;
|
|
load Patina, Anvil and Crucible in mixer effect slots.
|
|
|
|
Normal branch/PR pipelines also provide a combined Windows preview ZIP in the
|
|
**windows** job. Releases are separate: tags such as `rivet-v0.4.0`,
|
|
`patina-v0.2.0`, `anvil-v0.1.0` and `crucible-v0.1.0` publish independently. See [release workflow](docs/releases.md).
|
|
|
|
These names replace Motif Storyboard and Resonance Compressor. Their CLAP IDs
|
|
and saved-state identifiers are preserved; replace old scanned copies and rescan.
|
|
|
|
## Repository
|
|
|
|
```text
|
|
plugins/
|
|
catalog.json Product metadata used by build and release tools
|
|
rivet/
|
|
core/ Motifs, harmony, variation, history, performance
|
|
midi/ Standard MIDI import/export
|
|
app/ Worker jobs and real-time audition control
|
|
preview/ Offline MIDI/WAV development tool
|
|
plugin/ CLAP wrapper, editor, optional standalone
|
|
patina/
|
|
core/ Spectral detector and attenuation engine
|
|
ui/ Patina's native editor
|
|
render/ Offline WAV evaluation
|
|
plugin/ CLAP audio-effect wrapper
|
|
anvil/
|
|
core/ Pitch tracking, crossover and sub oscillator
|
|
ui/ Anvil's native editor
|
|
plugin/ CLAP audio-effect wrapper with MIDI input
|
|
crucible/
|
|
core/ Input history, capture, slicing, cleanup and export
|
|
ui/ Crucible's native editor
|
|
plugin/ CLAP audio-effect wrapper
|
|
common/
|
|
ui/ Shared look: palette, embedded fonts, knobs and panels
|
|
dsp/ Shared filters, YIN pitch detection and WAV files
|
|
tools/editor-check/ Headless visual QA for all editors
|
|
scripts/ Shared build, packaging, release, and analysis tools
|
|
docs/<plugin>/ Guide, changelog and editor preview per plugin
|
|
references/ Local reference audio; excluded from distribution
|
|
```
|
|
|
|
The root Cargo workspace contains the engines and supporting tools. Each CLAP
|
|
wrapper has an independent workspace and lockfile so SDK dependencies stay
|
|
separate. [Development and testing](docs/development.md) covers the commands.
|
|
|
|
```sh
|
|
cargo test --workspace --locked
|
|
python scripts/build-plugin.py --plugin rivet --target x86_64-pc-windows-gnu
|
|
python scripts/build-plugin.py --plugin patina --target x86_64-pc-windows-gnu
|
|
python scripts/build-plugin.py --plugin anvil --target x86_64-pc-windows-gnu
|
|
python scripts/build-plugin.py --plugin crucible --target x86_64-pc-windows-gnu
|
|
python scripts/package-windows.py
|
|
```
|
|
|
|
Windows is the release target. Linux remains useful for tests, cross-compilation,
|
|
and headless editor previews. FL Studio routing, native window behavior, and
|
|
artistic listening still require manual checks in the target setup.
|