Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,9 @@
- Default FULL 704x520, minimum 660x490; MINI remains 330 high. Do not increase default GUI size without measuring element collision and user workflow.
- Header has no decorative separator rules. Only MODEL and PRESET need small captions; buttons self-label. Maintain >=4.5:1 contrast between static captions and their dark metal background, using the shared palette contract.
- Inspect screenshots from compiled JUCE at default/minimum, MINI and SIDECHAIN; preserve readable controls, meters, telemetry, preset and APVTS bindings. GUI changes must never modify engine DSP or latency.

## M5 original factory bank contract
- New ArSonComp preset content, not a reproduction of FabFilter proprietary .ffp files/settings or proprietary DSP.
- Catalog browser supports real categories/search/tags/description/favorites without consuming additional permanent GUI space.
- Loading a factory program never changes External SC, Listen or Bypass; factory values are sanitized against the canonical parameter table.
- UI favorites persistence is strictly on the message thread, never in DSP. Test every program for finite output, safe bounds and host parameter recall, plus browser screenshot.
83 changes: 83 additions & 0 deletions docs/FACTORY-PRESETS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
# ArSonComp Factory Bank v2 — Original presets with calibrated starting makeup

46 original purpose-built compressor starting points in 10 categories. Every factory program now includes a positive **makeup gain** intended to make the effect audible rather than sounding merely quieter than bypass.

## Clean
- **Neutral Start** — A balanced starting point. Adjust Threshold for the desired gain reduction.
- **Transparent Control** — Low-ratio, wide-knee compression for natural level regulation.
- **Peak Catch** — Fast peak containment with limited reduction; not a true-peak limiter.
- **Parallel Control** — Parallel compression that retains part of the unprocessed dynamics.

## Vocals
- **Natural Vocal** — Gentle vocal leveling that preserves breath and consonants.
- **Forward Lead** — Assertive lead vocal control without an excessively fast attack.
- **Broadcast Voice** — Consistent spoken-word loudness with program-dependent release.
- **Intimate Vocal** — Soft program leveling for quiet intimate performances.
- **Rock Lead** — Firm vocal dynamics for dense guitar-driven arrangements.
- **Backing Blend** — Gentle glue for stacked backing vocals and harmonies.

## Drums
- **Kick Weight** — Maintain kick impact while smoothing excessive body resonance.
- **Snare Snap** — Retain snare crack with a medium attack and lively release.
- **Parallel Smash** — Dense parallel drum energy, dry/wet blended for punch.
- **Room Pump** — Pronounced room-compressor movement for deliberate effect.
- **Drum Bus Glue** — Moderate drum-bus cohesion with transient headroom.
- **Percussion Tame** — Control uneven percussion peaks without flattening expression.

## Bass
- **Steady Bass** — Control low-note variation and sustain with smooth recovery.
- **Bass Attack** — Preserve front-edge impact with medium attack and release.
- **Synth Bass Control** — Dense synth bass level containment with a smooth knee.
- **Slap Peak Tame** — Control slap and pop spikes while retaining some articulation.

## Guitar
- **Acoustic Gentle** — Smooth acoustic strumming dynamics without pumping.
- **Electric Rhythm** — Subtle rhythm guitar leveling for consistent mixing.
- **Lead Sustain** — Extend lead-line sustain with more assertive compression.
- **Clean Picking** — Keep picked notes even and articulate.

## Piano
- **Piano Natural** — Very gentle dynamics for exposed acoustic piano.
- **Pop Piano** — Even pop piano levels while keeping chord attacks lively.
- **Electric Keys** — Controlled sustain for modern electric keyboards.
- **Percussive Keys** — Let piano transients speak through moderate attack.

## Mixbus
- **Gentle Glue** — 2:1 stereo bus glue with conservative reduction.
- **Forward Mix** — Tighter mix cohesion without crushing the transients.
- **Parallel Mix** — Blend denser bus energy underneath the original.
- **Smooth Program** — Smooth overall dynamic movement for changing material.

## Mastering
- **Gentle Program** — Subtle final program control; start with only 1–2 dB reduction.
- **Dynamic Preserve** — Protect program transients and limit gain reduction.
- **Density Lift** — Moderate parallel density; not a brickwall limiter.
- **Slow Program** — Slow RMS-based envelope for wide program changes.

## Special
- **Rhythmic Pump** — Audible rhythmic compression for electronic sources.
- **Hard Clamp** — Aggressive peak reduction; reduce input if distortion appears.
- **Slow Breathing** — Slow rise and recovery for dramatic ambience.
- **NY Parallel** — Dense parallel compression for energetic drums.

## Live & Broadcast
- **Live Speech** — Low-latency microphone dynamics. No added plugin samples.
- **Live Vocal** — Performance vocal control with conservative artifacts.
- **Podcast Voice** — Natural spoken-word consistency; monitor for pumping.
- **Streaming Bus** — Gentle stereo bus level management for online streaming.
- **Stage Instrument** — Transient-preserving compression for a stage instrument.
- **Radio Presenter** — Firm broadcast speech dynamics with smooth release.

This bank draws inspiration from the **workflow** of modern professional compressor browsers (categorized presets, search, favorites and descriptions). It is not an import or reproduction of any FabFilter factory .ffp files, DSP algorithms, settings or branding. The styles and settings target ArSonComp's independent Clean, Feedback and Smooth compressor engine.

IMPORTANT: presets are starting points. Threshold and gain reduction depend on incoming source level. All presets leave external SC, listen, and bypass OFF to prevent unexpected silent/misrouted live audio. Preset loading preserves the current live routing/safety switches. No new DSP latency or audio-thread allocations.

Reference: https://www.fabfilter.com/help/pro-c/presets/loadingpresets

## Preset loudness / makeup calibration (October 2026)

Every factory program receives a deterministic, fixed **starting Makeup gain**, calculated when the static factory bank is initialized (never on the audio thread): estimate static reduction for a reference **−18 dBFS peak** using the exact knee/range/ratio transfer law, weight it by the preset's Mix, then add a modest intentional audible lift. Vocal and live programs allow up to 6 dB, general instruments/buses up to 5.8 dB, mastering up to 3.2 dB, and deliberately aggressive special effects up to 8 dB. Neutral Start now contains real gentle 2.5:1 / −24 dB compression, instead of factory defaults with almost no reference-level gain reduction.

This is **not** automatic loudness measurement, adaptive normalization, peak limiting, or a guarantee that louder means better. Incoming material with hot peaks can clip later in the DAW or audio interface when makeup is enabled. Reduce Makeup or Input to maintain at least ~3–6 dB of useful monitoring headroom; compare bypass at matched loudness before making critical mix/master decisions. Vocal, karaoke and broadcast presets favor an audible immediately useful lift, whereas mastering deliberately remains conservative. Source level and playing style still affect actual gain reduction.

Automated smoke checks require all 46 programs to have positive makeup, meaningful static compression at a −12 dBFS peak reference and finite audio below 0 dBFS for a modest nominal test input; these are *bounds*, not a guarantee of no clipping on arbitrary signals. No DSP/latency/host parameter ID or preset schema change. Future calibrated reference WAV and perceptual ABX testing remain pending.
4 changes: 4 additions & 0 deletions docs/GUI-PERFORMANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,7 @@ Technical reference: JUCE developer ADC 2025 session on component hierarchy, opa
## M4 compact and legible isolated LCD

Keep the optimized opaque LCD child and idle-repaint coalescing with the new default 704×520 and minimum 660×490. MINI remains 330px high with a 47px meter well. Captions have higher contrast, separator rules are removed, and the new geometry is covered by actual JUCE visual smoke tests. CI CPU timing is not real-device XRUN proof.

## Compact second pass

Default window reduced from **704×520 to 612×500** (~16% less screen area); minimum 580×480. The seven main knobs are drawn in 62px-high controls while preserving per-control labels, mouse hit targets and the light gunmetal slider rails. All 5 SIDECHAIN elements reflow inside minimum width with 8px gaps. The isolated opaque LCD and idle repaint coalescing remain unchanged; audio DSP does not depend on window size.
14 changes: 14 additions & 0 deletions docs/WINDOWS-QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,3 +72,17 @@ For MAONO PS22, install the official [PS22 Windows driver and routing tool](http
**Isolate the fault before claiming a fix:** (A) PS22 direct monitor (analog baseline, no ArSonComp), (B) unprocessed Windows/DAW input/output, (C) VST3 or Standalone with compressor host-bypassed, (D) compressor active with identical gain and routing. If A has crackles suspect input/cable/hardware; if B/C also crackle suspect driver, buffer, USB or operating-system scheduling; if only D crackles investigate DSP/automation and capture a digital audio recording. A single Task Manager CPU/GPU/memory snapshot is not an xrun measurement. Report driver name, sample rate, buffer, whether Standalone or VST3, and whether bypass removes crackles. A real audio-device test is required.

`ARSON_WINDOWS_ASIO=OFF` can be used by downstream builders who cannot accept the Steinberg ASIO SDK's third-party licensing terms; review distribution compliance before a public release. Enabling ASIO does **not** ensure zero hardware latency or prevent all crackles.

### M5 original factory presets and browser

The preset dropdown includes **46 original ArSonComp factory starting points** in ten categories: Clean, Vocals, Drums, Bass, Guitar, Piano, Mixbus, Mastering, Special, and Live & Broadcast. Choose **SEARCH / BROWSE PRESETS...** at the top or FILE → Browse factory bank to open the compact in-plugin browser without resizing the editor.

Search matches name, category, tags and description. Pick a row to see its purpose and author. APPLY auditions without closing; double-click applies and closes; keyboard arrows and Enter apply, Escape closes. STAR/UNSTAR stores stable favorite IDs in the user application data directory, and FAVORITES filters the list. Use the bank's preset list directly for faster navigation.

Presets are designed for ArSonComp's independent three compressor models, **not** imported FabFilter .ffp programs or claims of matching proprietary factory sounds. Each preset preserves the current External SC, Listen and Bypass switches, so recall never silently changes live routing. Threshold and amount of reduction always depend on the input's actual level; tune to source and loudness-match listening comparisons. FILE Save/Open continues to support the existing .arsoncomp user preset format.

## Smaller factory-browser GUI (2026-10-31)

New default FULL window **612×500**, minimum **580×480**; MINI height **320**, retaining the live meter well. Header is a single compact responsive row (100px brand, smaller model/actions, usable preset field). Main rotary controls retain a 62px drag target, and SIDECHAIN HP/LP/detector/EXT/LISTEN widths are calculated from available space to avoid clipping at minimum width. The categorized 46-preset browser remains a transient overlay, not a permanent wide side panel.

Factory programs now include purpose-specific Makeup starting gain, generally stronger for vocals/live and gentler for mastering. The goal is a noticeable first impression **without silently bypassing dynamics**, not guaranteed louder-is-better or universal headroom safety. Watch the output meter, adjust Input/Makeup and compare Bypass at matched loudness.
Loading
Loading