KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

SneakPeak

★ 18 Open GitHub ↗

Precision waveform editor for REAPER — dockable item editor with spectral analysis, multi-item layering, and real-time metering

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SneakPeak

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/b451c/SneakPeak/main/LICENSE)
[![Latest Release](https://img.shields.io/github/v/release/b451c/SneakPeak)](https://github.com/b451c/SneakPeak/releases/latest)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-brightgreen.svg)](https://raw.githubusercontent.com/b451c/SneakPeak/main/)

**Precision waveform item editor for REAPER** - a native C++ extension that gives you a detailed, dockable waveform view for any media item. Click an item in REAPER's arrange view, and SneakPeak instantly shows you a full-featured waveform editor with dynamics processing, volume envelope editing, spectral analysis and repair, game-audio tools (seamless loop authoring, one-shot batch export, true-peak limiting), multi-item layering, real-time metering, and full interface scaling (80-200%). Available for macOS (arm64/x86_64), Windows (x64), and Linux (x86_64/aarch64).

![SneakPeak](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/sneakpeak-hero.png)

> *Select any audio item in REAPER and get an instant, detailed waveform with dynamics processing, volume envelope editing, spectral analysis, multi-item layering, and real-time metering - all in a dockable window.*

## Screenshots

![Gate processing](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/dynamics-gate-overview.png)
The gate taming breaths between dialogue phrases (v2.2) - threshold/gate lines, envelope automation and detector curves drawn live on the waveform.

<img src="docs/images/dynamics-panel.png" width="66%" alt="Dynamics panel - compressor tab with transfer curve, GR meter and parameter knobs">
 <img src="docs/images/settings-panel.png" width="28%" alt="Settings panel - UI scale slider, density presets, ruler, meters and view preferences">

The Dynamics panel (compressor tab) and the Settings panel - UI scale 80-200%, density presets, view preferences.

<img src="docs/images/spectral-view.png" width="72%" alt="Spectral analysis view with stacked stereo channels">

Spectral view - async FFT spectrogram with frequency band selection.

<details>
<summary>More demos (animated GIFs - click to expand)</summary>

**Standalone destructive editing** - drag & drop any file, edit, save:

![Standalone editing](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/standalone-editing.gif)

**Multi-item layered view:**

![Multi-item layered view](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/multiview.gif)

**Fade handles with continuous curvature** (horizontal = length, vertical = shape):

![Fade handles](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/fades.gif)

**Minimap navigation:**

![Minimap](https://raw.githubusercontent.com/b451c/SneakPeak/main/docs/images/minimap.gif)

</details>

---

## Why SneakPeak?

REAPER is the most powerful DAW on the market, but a detailed waveform item editor has always been the one thing missing. SneakPeak fills that gap - a dedicated editor that lives inside REAPER as a native extension.

I looked everywhere for a solution - scripts, extensions, workarounds - but nothing delivered what I needed. So I built it. After months of development, I'm releasing SneakPeak as a free, open-source extension for the REAPER community. I considered making it paid, but ultimately decided that the community deserves access to tools like this without barriers.

If you find SneakPeak valuable, please consider [supporting its development](#support). Every contribution helps keep this project alive and growing.

---

## Features

SneakPeak has five viewing modes: **ITEM** (default - click any item), **Timeline View** (after cutting), **Multi-Item** (select 2+ items), **SET** (working set, press T), and **Standalone** (drag & drop files). All non-destructive editing goes through the REAPER API with full undo.

### Interface & Scaling (new in v2.2)
- **Global UI scale (80-200%)** - the entire interface scales from one slider: fonts, toolbar, ruler, meters, panels, and every click target. First run auto-detects your system DPI (Windows display scaling, Linux GDK scale).
- **Settings panel** - gear icon in the mode bar: UI scale with live preview, density presets (Compact / Comfortable / Spacious), Fit to Window, and the Ruler / Meters / View preferences - including hide-ruler and the Detailed/Simple waveform style (new in v2.4).
- **Premium rendering** - anti-aliased, DPI-crisp Dynamics panel, Settings panel, gain knob, L/R meters and toasts.

### Waveform Display
- **Precision waveform rendering** - Peak + RMS display with dB scale and zero-crossing line.
- **Waveform style: Detailed / Simple** (new in v2.4) - Detailed keeps the darker RMS band inside the peak waveform; Simple draws single-colour peaks only. Clip marking is drawn in both styles.
- **Truthful clip display** - red marks real clipping (source flat-tops, or over-0dB in destructive Standalone mode); amber marks over-0dB warnings in REAPER's float contexts where nothing has clipped yet. A dark-red 0dB reference line appears when zoomed out vertically.
- **Deep zoom** - Horizontal and vertical zoom with scroll wheel, toolbar buttons, and keyboard. Zoom to fit, zoom to selection. Zoom anchors on the mouse position or the edit cursor (Settings > View).
- **Minimap** - Resizable overview bar showing the full item waveform. Click to navigate, drag to scroll.
- **Time ruler** - Dynamic tick intervals from milliseconds to minutes with position readout.
- **Channel solo (L/R)** - per-channel monitoring that keeps the soloed channel on its own side (take pan balance under the hood; your pan is saved and restored).

### Audio Editing
- **Precision selection** - Click and drag to select audio regions. Shift+click to extend. Double-click to select all.
- **Cut / Copy / Paste** - Full clipboard support with sample-accurate editing.
- **Normalize** - Peak normalization to 0 dB, plus LUFS normalization (-14 / -16 LUFS).
- **Fades** - Drag fade handles with continuous curvature control (horizontal = length, vertical = curve shape). 7 base shapes with smooth curvature matching REAPER's native D_FADEINDIR. Scroll on a handle to nudge the length (Cmd = 1 ms steps), Shift+drag for a 1/4-speed fine trim (new in v2.4).
- **Slip content** (new in v2.4) - Alt+drag outside the selection in ITEM mode slides the take's source under the item (live arrange update, source-bound clamp, one undo point per slip).
- **Reverse** - Reverse selection or full item.
- **Gain adjustment** - Interactive gain knob (+24 to -60 dB) with fine-adjust mode (Cmd+drag). Scroll wheel on knob for +/-0.5 dB. Quick +3/-3 dB from context menu.
- **DC offset removal** - One-click DC bias correction.
- **Silence / Insert silence** - Zero out selection or insert silence at cursor.
- **Snap to zero-crossing** - Intelligent selection boundaries at zero-crossing points.
- **Undo / Redo** - Full REAPER undo integration, with redo (Ctrl+Shift+Z / Ctrl+Y, new in v2.4). Independent 20-level undo + redo stacks in standalone mode; bounded edits snapshot only the touched range, so long files stay light.
- **Bindable toolbar actions** (new in v2.4) - every toolbar command is a named REAPER action: assign any shortcut in the Action List.

### Dynamics Processing
Right-click > Process > Dynamics Panel. SneakPeak auto-activates the take volume envelope if it isn't already enabled (no manual setup). Analyzes audio and writes volume envelope automation - zero CPU cost during playback. In Standalone mode (new in v2.4) the same panel applies destructively instead - the gain curve (comp + gate + de-ess) is multiplied into the audio with one undo step, completing the standalone podcast chain (Dynamics > Hard Limiter > Save).
- **Built-in compressor** - Industry-standard gain-smoothing architecture (ratio, threshold, soft knee, attack, release, auto makeup gain). Matches FabFilter Pro-C / Waves / ReaComp.
- **Upward compression + BOTH mode** (new in v2.4) - a DOWN/UP/BOTH switch: lift quiet material toward the threshold (with an M.Boost cap and a gate-coupled floor), or run the single-pass leveler that tames loud and lifts quiet at once, with the knee acting as a leave-alone band.
- **Extended ratio** (new in v2.4) - 1:1 through Inf:1 (true limiting, with a detent) and into over-compression (negative ratios).
- **Noise gate** - a full downward expander (reworked in v2.4): ratio 1-10:1, hysteresis band against chatter, exposed attack/release, floors down to -90 dB threshold / -80 dB range, an Off detent.
- **Wideband de-esser** (new in v2.4) - DE-ESS tab with a band-pass / high-pass detector driving a third gain-reduction stage, a hard reduction cap, and a LISTEN lane that paints every span the de-esser bites.
- **Per-stage bypass** (new in v2.4) - power dots on the COMP and GATE tabs audition each stage in real time, alongside the whole-chain A/B.
- **Lookahead** - 0-20ms transient detection without latency cost.
- **Tabbed control panel** - anti-aliased COMP / GATE / DE-ESS / View tabs with knobs, transfer plot and GR meter; every change updates the curves on the waveform in real time, and double-clicking a knob lets you type an exact value.
- **Live mode** - Real-time envelope writing as you drag knobs. Waveform updates instantly, no Apply needed.
- **8 built-in presets** - Default, Gentle Leveling, Voice/Podcast, Broadcast, De-breath, Music Bus, Upward Leveling, De-Ess Vocal.
- **Per-item persistence** - Settings auto-saved via P_EXT, auto-loaded when reopening.
- **GR meter + shading** - Gain reduction visualization in panel and on waveform.
- **A/B bypass** - Instant before/after comparison (audio + visual).
- **Peak/RMS detection** - Toggle between peak and RMS analysis modes.

### Volume Envelope Editing
Enable via right-click > View > Show Volume Envelope. SneakPeak auto-activates the take volume envelope on the current item if it is not yet enabled in REAPER.
- **Envelope overlay** - Cyan curve showing take volume envelope, 1:1 with REAPER arrange view.
- **Point editing** - Click to add, drag to move, double-click or Delete to remove. Right-click for curve shape (6 shapes).
- **Multi-select** - Shift+click to toggle, batch drag/delete.
- **Freehand drawing** - Cmd+drag on envelope line to draw points continuously.
- **Selection rectangle** - Cmd+drag on empty area for rectangle selection.
- **Dense point interaction** - Reveal rectangle for managing >100 points after Apply Dynamics.
- **Curved envelopes** (new in v2.4) - Alt+drag a segment to bend it (bezier tension with a live readout); "Reset curvature" in the point menu. Renders 1:1 with the REAPER arrange view.
- **Works in all modes** - ITEM, Timeline, and SET modes via per-segment envelope lookup.

### Spectral Analysis
- **Real-time spectrogram** - Threaded FFT computation with channel-pair packing (roughly 10x faster on stereo, new in v2.4) and peak-preserving zoom-out, magma color scheme.
- **Spectral Repair (Standalone)** (new in v2.4) - drag a time x frequency rectangle and Heal Selection (Replace or gentler Attenuate strengths, iterative), or run Repair Clicks on a time selection (autoregressive detection + interpolation, sample-accurate). Destructive edits with full undo.
- **Marquee selection** (new in v2.4) - one-gesture time x frequency rectangle with a frosted interior and resizable edge/corner grips; Alt+drag still selects a full-width band; Shift+click extends in time.
- **Frequency grid + Hz/Notes scale** (new in v2.4) - faint reference lines across the spectrogram at the labeled frequencies; switch the scale between Hz and note names (A0-A9, A4 = 440 Hz) in Settings.
- **Per-channel display** - Stereo spectral view with stacked channels.

### Timeline View
Enters automatically after cutting an item in ITEM mode. Shows all fragments with gaps preserved. Exit by clicking a single item. Also accessible via the MULTI dropdown menu.
- **Post-cut continuity** - All surviving fragments shown with gaps preserved, matching the REAPER timeline 1:1. Dark background marks gap regions.
- **Repeated editing** - Continue cutting, adjusting gain, and editing within timeline view. Zoom position preserved across operations.
- **Auto lifecycle** - Enters automatically after cut, exits when you click a single item on REAPER timeline.
- **Option+click segment snap** - Option+click on any segment to instantly select its full range for gain adjustment without creating new splits.

### Multi-Item View
Select 2+ items in REAPER to enter automatically. Click the MULTI label for a dropdown to switch between Mix, Layered, and Timeline View.
- **Cross-track editing** - View all selected items together on an absolute timeline.
- **Mix mode** - Sum all items into a single waveform (like a folder track).
- **Layered mode (per Item)** - Each item displayed in a distinct color with transparency, overlaid on each other. 8-color palette for clear visual separation.
- **Layered mode (per Track)** - Items colored by their parent track for track-aware visualization.
- **Gap visualization** - Dark regions between items for clear visual context.
- **Cross-segment editing** - Delete and gain operations work across item boundaries.
- **Crossfade indicators** - Join-point lines at crossfade midpoints for easy visual reference.
- **Batch gain** - One knob adjusts relative gain across all selected items.

### Working Set (SET Mode)
Select items on one track, press T to enter. Gaps collapse into a continuous waveform. Press T again or Escape to exit.
- **Lock items for editing** - Persistent Working Set survives clicking elsewhere. Click any set item to restore.
- **Persistent state** - Click elsewhere and come back - the set auto-restores when you click any set item.
- **Non-destructive editing** - Delete, split, and gain operations work through REAPER API with full undo.
- **Ripple edit** - Delete in SET mode automatically pulls subsequent items left to close gaps.
- **Selection-aware gain** - Gain knob with selection splits at edges and applies D_VOL only to the fragment (with 10ms crossfade overlap).
- **Group Set Items** - Group all items in the set (or selected range) for easy timeline manipulation. Visual colored bar below ruler.
- **Absolute time ruler** - Toggle between relative and REAPER timeline time (context menu).
- **Bidirectional cursor sync** - Click in SneakPeak scrolls REAPER arrange, click on REAPER timeline updates SneakPeak playhead.

### Metering
- **Real-time level meters** - Stereo L/R display with peak hold indicators.
- **Three meter modes** (right-click to switch):
  - **Peak (PPM)** - True peak metering, instant attack, slow decay.
  - **RMS (AES/EBU)** - RMS loudness with 300ms integration window.
  - **VU** - Classic VU ballistics with slow attack and decay.
- **Info panel** - Selection bounds, view range, format details (sample rate, bit depth, channels, file size, duration).

### Standalone File Mode
Drag any audio file (WAV, MP3, FLAC) into the SneakPeak window to enter. Fully destructive editing with independent undo.
- **Drag & drop** files directly into SneakPeak for offline editing.
- **Long-file friendly** (new in v2.4) - loading runs in timer slices with a progress title (the UI stays responsive), bounded edits snapshot only the touched range, and tab switches are instant regardless of file size.
- **Multiple file tabs** - Up to 8 files open simultaneously with independent undo stacks.
- **Smart Save** - Ctrl+S with overwrite confirmation for WAV, auto `_edit.wav` for MP3/FLAC. Ctrl+Shift+S for Save As.
- **Edit Copy in Standalone** (new in v2.4) - right-click a selected timeline item > Edit Copy in Standalone: the item's audio is written as `{name}_edit.wav` next to its media file and opens as a new standalone tab - one command from the timeline into Loop Lab, Spectral Repair, the Hard Limiter and destructive editing. The original item stays untouched.
- **Replace Source in REAPER Timeline** - Right-click > Replace Source in REAPER Timeline after editing: one click saves the file and swaps `P_SOURCE` on every project take that references the original path. Immediate arrange redraw.
- **Drag-export** - Drag files to REAPER timeline. Clean files use original (no copy), dirty files auto-save first. Selections export as named WAV. Works on all platforms (the Windows hand-off was missing before v2.4).
- **True-Peak Hard Limiter** (new in v2.4) - transparent lookahead brickwall limiting with a hard **dBTP** ceiling (8x-oversampled detection + output re-measure, passes BS.1770-4 meters with margin). Premium panel (Gain/Ceiling/Attack/Hold/Release, TRUE PEAK + LINK, 4 presets incl. Game Asset -1 dBTP), live GR band over the waveform, threaded preview readouts, whole-file or selection apply with undo. Works on Standalone files AND directly on a selected timeline item (destructive source rewrite, Reverse-style confirm + undo). Right-click > Process > Hard Limiter...
- **Loop Lab** (new in v2.4) - build seamless loops for game engines and samplers in one panel (right-click > Loop Lab...): loop region with draggable ruler brackets and live START/END/LENGTH readouts, gapless loop and seam-only auditions, automatic loop-point finder (NCC scoring + texture fallback for stochastic ambiences) with a clickable candidate list and ruler pins, equal-power seam Weld (5-500 ms), and standard `smpl` loop points written on save / adopted on load.
- **One-Shot Factory** (new in v2.4) - the SFX-prep chain in one panel (right-click > One-Shot Factory...): trim silence (threshold + padding), edge micro-fades, normalize (Peak / LUFS-I / True-peak safe via the limiter), slice to variations (whole file / by regions-markers / by silence gaps) with a `{name}_{nn}` naming pattern, and a live per-slice prep preview on the waveform. Works on Standalone files AND directly on a selected timeline item (assets land next to the item's media file). Run exports every slice next to the source; the loaded audio is never touched.

### Markers
- **Add markers** at cursor position (M key).
- **Add regions** from selection (Shift+M).
- **Edit / delete / drag** markers in the ruler.
- **Tab / Shift+Tab** to navigate between markers.

### Playback
- **Play from cursor** or play selection with REAPER transport.
- **Playhead follow** - Waveform auto-scrolls to follow playback position.
- **Standalone preview** - Play audio directly from standalone tabs.

### Integration
- **Floating or docked** - Starts as resizable floating window. Dock/undock via context menu ("Dock SneakPeak in Docker"). Position and size remembered across sessions.
- **Auto-follow selection** - Automatically loads the selected item when you click in the arrange view.
- **Drag export** - Drag a selection outside SneakPeak to place it on REAPER timeline. Alt+drag for immediate export to Finder.
- **Track solo** - Solo button (S) for quick track isolation.
- **REAPER markers** - Full integration with REAPER's project markers.
- **Persistent settings** - All preferences (meter mode, view mode, minimap, snap, dock state, RMS/meter visibility) survive REAPER restarts.
- **Check for updates** - Click the version label in the mode bar to query the latest release on GitHub.
- **Declutter toggles** - Settings > View can hide the ruler and the meters, and switch the waveform to the single-colour Simple style, giving the waveform the full window.

---

## Keyboard Shortcuts

| Action | Shortcut |
|--------|----------|
| Play / Pause | `Space` |
| Stop | `Escape` |
| Jump to start | `Home` |
| Jump to end | `End` |
| Next marker | `Tab` |
| Previous marker | `Shift+Tab` |
| Select all | `Ctrl/Cmd+A` |
| Undo | `Ctrl/Cmd+Z` |
| Redo | `Ctrl/Cmd+Shift+Z` or `Ctrl/Cmd+Y` |
| Cut | `Ctrl/Cmd+X` |
| Copy | `Ctrl/Cmd+C` |
| Paste | `Ctrl/Cmd+V` |
| Delete selection | `Delete` or `E` |
| Silence / Insert silence | `Ctrl/Cmd+Delete` |
| Normalize | `Ctrl/Cmd+N` |
| Toggle gain panel | `G` |
| Toggle Dynamics panel | `D` |
| Toggle Working Set | `T` |
| Add marker | `M` |
| Add region | `Shift+M` |
| Save (standalone) | `Ctrl/Cmd+S` |
| Save As (standalone) | `Ctrl/Cmd+Shift+S` |
| Split at cursor | `S` |
| Ripple Delete | `Shift+Delete` or `Shift+E` |
| Gain +/-1 dB | `Up` / `Down` |
| Next/Previous segment | `Alt/Option+Right/Left` |
| Zoom | `Scroll wheel` (anchor: mouse or edit cursor, see Settings) |
| Vertical zoom | `Shift+Scroll` or `Alt+Scroll` |
| Pan | `Ctrl/Cmd+Scroll` or `Middle-mouse drag` |
| Fine-adjust gain | `Ctrl/Cmd+drag` on knob |

---

## Installation

### ReaPack (recommended)

1. In REAPER, go to **Extensions > ReaPack > Import repositories...**
2. Paste this URL:
   ```
   https://raw.githubusercontent.com/b451c/SneakPeak/main/index.xml
   ```
3. Go to **Extensions > ReaPack > Browse packages**, search for **SneakPeak**.
4. Right-click > **Install**, then restart REAPER.

ReaPack will automatically notify you of future updates.

> **Troubleshooting:** if Synchronize packages does not show the latest version after a new release, check these in order:
> 1. **URL path** in **ReaPack > Manage repositories...** must contain `/main/`, not `/testing/`. Testing-branch URLs from alpha/beta periods serve an independent index that does not track production releases.
> 2. **Cache file mtime** - after Synchronize, `~/Library/Application Support/REAPER/ReaPack/Cache/SneakPeak.xml` (or your platform's equivalent) should be freshly updated. If it's stale, the download is silently failing to write (permissions, AV quarantine, disk). Remove and re-add the repo - this deletes and rewrites the cache file.
> 3. **Corporate proxy or AV** may strip `Cache-Control: no-cache` and serve a cached copy. Verify with `curl -H 'Cache-Control: no-cache' https://raw.githubusercontent.com/b451c/SneakPeak/main/index.xml` - should return the current index.
> 4. **Fresh release (<5 min ago)** - GitHub raw CDN (`raw.githubusercontent.com` via Fastly) returns `Cache-Control: max-age=300`. Wait 5 minutes and retry. Does not apply once more than 5 minutes have elapsed.

### Manual install

1. Download the binary for your platform from the [Releases](https://github.com/b451c/SneakPeak/releases/latest) page.
2. Copy it to your REAPER UserPlugins folder:

| Platform | File | Path |
|----------|------|------|
| **macOS arm64** | `reaper_sneakpeak-arm64.dylib` | `~/Library/Application Support/REAPER/UserPlugins/` |
| **macOS x86_64** | `reaper_sneakpeak-x86_64.dylib` | `~/Library/Application Support/REAPER/UserPlugins/` |
| **Windows x64** | `reaper_sneakpeak-x64.dll` | `%APPDATA%\REAPER\UserPlugins\` |
| **Linux x86_64** | `reaper_sneakpeak-x86_64.so` | `~/.config/REAPER/UserPlugins/` |
| **Linux aarch64** | `reaper_sneakpeak-aarch64.so` | `~/.config/REAPER/UserPlugins/` |

3. Restart REAPER.
4. Open via **Actions > SneakPeak: Toggle Window**, or assign a keyboard shortcut.

> **macOS note:** Only install one dylib - having both arm64 and x86_64 in UserPlugins will cause REAPER to load both and crash.

### Build from source

See [Building](#building) below.

---

## Usage

1. **Open SneakPeak** - Run "SneakPeak: Toggle Window" from REAPER's Actions menu (or assign a shortcut).
2. **Click any audio item** in REAPER's arrange view - SneakPeak instantly shows the detailed waveform.
3. **Click and drag** on the waveform to make a selection. Shift+click to extend.
4. **Right-click** anywhere for the full context menu - editing, processing, view options.
5. **Use the toolbar** for zoom, transport, and audio processing.
6. **Toggle spectral view** from the context menu (View > Spectral View).
7. **Select multiple items** to enter multi-item mode. Right-click > View > Multi-Item View to switch between Mix and Layered modes.
8. **Right-click the meter panel** (bottom) to switch between Peak, RMS, and VU metering.
9. **Drag a WAV file** onto the window to open it in standalone mode.
10. **Press G** to show the gain knob for non-destructive level adjustment.

---

## Building

### Prerequisites

- **CMake** 3.24+
- **C++17** compiler (Clang on macOS)
- **REAPER SDK** - clone into `sdk/`:
  ```bash
  git clone https://github.com/justinfrankel/reaper-sdk.git sdk
  ```
- **WDL** - clone into `WDL/`:
  ```bash
  git clone https://github.com/justinfrankel/WDL.git WDL
  ```

### Compile and install (macOS)

```bash
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(sysctl -n hw.ncpu)
# install via a FRESH file (rm first): overwriting a dylib in place while REAPER
# has it mapped can trigger a codesigning crash on Apple Silicon
rm -f ~/Library/Application\ Support/REAPER/UserPlugins/reaper_sneakpeak.dylib
cp reaper_sneakpeak.dylib ~/Library/Application\ Support/REAPER/UserPlugins/
```

### Debug build

Debug builds enable verbose logging to `/tmp/sneakpeak_debug.log`:

```bash
cmake .. -DCMAKE_BUILD_TYPE=Debug
make -j$(sysctl -n hw.ncpu)
```

---

## Requirements

- **REAPER** 7.0+ (tested on 7.62+)

### Supported Platforms

| Platform | Architecture | Status |
|----------|-------------|--------|
| **macOS** | arm64 (Apple Silicon) | Stable (primary development) |
| **macOS** | x86_64 (Intel) | Stable |
| **Windows** | x64 | Stable |
| **Linux** | x86_64 | Stable |
| **Linux** | aarch64 | Stable |

All platforms built via GitHub Actions CI on every tagged release. The codebase is pure C++ on WDL/SWELL; the premium panel renderer (Blend2D, Zlib license) is fetched and statically linked at build time - the shipped binary remains a single self-contained file.

---

## Architecture

```
src/
  main.cpp                Entry point, REAPER API imports, action registration
  edit_view.h/cpp         Core: window lifecycle, timer, layout, message dispatch
  rendering.cpp           Paint routines, mode bar, ruler, dynamics curves, master waveform
  input_handling.cpp      Mouse, keyboard, toolbar, envelope editing dispatch
  audio_commands.cpp      Clipboard, undo, destructive editing, normalize, fade, reverse
  standalone_file.cpp     Standalone tab lifecycle, save/load/save-as, preview playback
  context_menu.cpp        Right-click menu construction and command dispatch
  drag_export.cpp         Drag & drop WAV export to timeline/desktop
  waveform_view.h/cpp     Waveform data, zoom, selection, envelope helpers, coordinates
  waveform_rendering.cpp  Peak computation, waveform + envelope drawing, dB scale, fades
  dynamics_engine.h/cpp   Compressor + gate computation (peak/RMS, attack/release, lookahead)
  dynamics_panel.h/cpp    Inline dynamics control panel (knobs, tabs, presets, Live mode)
  settings_panel.h/cpp    Settings overlay (UI scale, density presets, view preferences)
  ui_render.h/cpp         Blend2D premium renderers (panels, knobs, meters, toast)
  ui_theme.h              Premium UI design tokens (colors, type scale, layout constants)
  win32_utf8_unit.c       Windows-only TU wrapping WDL's UTF-8 Win32 API layer
  item_split_ops.h/cpp    SplitAndApplyGain helper for consistent gain across all modes
  toolbar.h/cpp           Button bar with zoom, transport, and editing actions
  audio_engine.h/cpp      WAV file I/O (16/24/32-bit float), REAPER source refresh
  audio_ops.h/cpp         Sample processing (normalize, fade, reverse, gain, DC remove)
  multi_item_view.h/cpp   Mix/Layered multi-item view, per-layer audio, absolute timeline
  spectral_view.h/cpp     Async FFT spectrogram with magma colormap
  minimap_view.h/cpp      Resizable minimap overview
  levels_panel.h/cpp      Peak/RMS/VU level meters with mode-dependent ballistics
  gain_panel.h/cpp        Interactive gain knob with fine-adjust mode
  marker_manager.h/cpp    REAPER marker integration (add, edit, delete, navigate)
  theme.h/cpp             Color palette, visual theming, cached fonts
  config.h                Layout constants, interaction parameters, shared utilities
  platform.h              Cross-platform abstraction (Win32/SWELL)
  globals.h/cpp           REAPER API function pointers and helpers
```

The extension loads full audio data via REAPER's AudioAccessor API for accurate waveform display and editing. The waveform uses double-buffered GDI rendering (smooth and flicker-free); the control panels, meters and toasts render through Blend2D for anti-aliased, DPI-crisp output at any UI scale.

---

## Contributing

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

Bug reports, feature requests, and cross-platform testing help are all appreciated. Please use [GitHub Issues](https://github.com/b451c/SneakPeak/issues) to report problems or suggest new features.

---

## Support

SneakPeak is free and open source. If you find it useful in your workflow, please consider supporting its development - it makes a real difference and helps keep the project alive:

- [Ko-fi](https://ko-fi.com/quickmd)
- [Buy Me a Coffee](https://buymeacoffee.com/bsroczynskh)
- [PayPal](https://paypal.me/b451c)

---

## License

## Links

- **Forum thread** - https://forum.cockos.com/showthread.php?t=307499
- **REAPER** - https://www.reaper.fm
- **ReaPack** - https://reapack.com
- **REAPER SDK** - https://github.com/justinfrankel/reaper-sdk
- **WDL/SWELL** - https://github.com/justinfrankel/WDL

---

Made by [falami.studio](https://falami.studio/lab/sneakpeak/) - audio production & engineering studio.

SneakPeak

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README