Skip to content

hollance/TheKissOfShame

Repository files navigation

The Kiss of Shame – Tape Desecration Processor

“Something so wrong never sounded so right.”

The Kiss of Shame, debuted at the Audio Engineering Society Convention 2014 in Los Angeles, was a pioneering DAW plugin that leveraged commercial UX/UI design principles to shape its magnetic tape + circuitry emulation algorithms.

To differentiate itself in the competitive pro-audio plugin market, The Kiss of Shame introduced groundbreaking features including an interactive, multi-touch-ready GUI and analog tape degradation simulation for distinctive audio effects.

The Kiss of Shame was the worlds first (and perhaps only) tape / analog circuitry emulation plugin that realistically models the effects of magnetic particle instability, lubricant loss, substrate deformation, drift, scrape-flutter, print-through and reel expansion/contraction into a suite of FX processing tools for sound design and music production.

It was also the first to leverage machine learning to account for the vast nonlinearities inherent in magnetic tape and analog circuitry. Last but not least, it's the only analog tape emulation that has fully-interactive reels that support touch and can write flange automation on-the-fly akin to a real analog tape deck.

Watch a short demo video

About this open source project

The Kiss of Shame was not completely finished and never saw a release. The source code was graciously donated to the open source community by its owner in 2024.

The goal of this open source project is:

  1. To finish the plug-in and make binary releases available.
  2. Figure out how it works and document the code for eductional purposes.
  3. Potentially, improve the code.

NOTE: The source code that was donated does not contain all the features from the description. Notably, there is only one tape type and one environment (Hurricane Sandy), and the print-through function is missing. In its current form the plug-in only works well at a 44100 Hz sample rate. That said, it's still a fun plug-in with a cool UI, and there's a lot to learn from the source code!

Installation instructions

TODO

NOTE: This is currently work-in-progress. There may be issues with the plug-in!

How to use this plug-in

Choose between two distinct tape types:

S-111 – A superior reel format popular from the 50s to 70s, was the preferred reference tape for many engineers. The Kiss of Shame introduces its first digital emulation, bringing this legendary format to the digital world.

A-456 – This classic, high-output/low-noise format is a recording staple used in countless productions. While many software emulations exist, none recreate it quite like this. Unique digital recreation tactics were employed to capture its essence.

NOTE: The tape type selection button currently has no effect.

From Weathered to Weather:

Age – This knob allows the user to legislate the amount of hypothetical time the selected tape type has been subjected to the chosen "Environment" to manipulate the severity of the corresponding effects.

Environment – Choose between several simulated storage conditions to inflict the sonic ramifications of factors such as magnetic particle instability, oxidation, lubricant loss, tape pack expansion/contraction, "vinegar syndrome" and more upon the source material. Users can even choose a "Hurricane Sandy" setting to access processing modeled from tape immersed and then recovered from the storm's flood waters.

NOTE: Only the Hurricane Sandy environment is implemented.

A real-world obstacle:

Shame – The Kiss of Shame recreates the full spectrum of these factors like Drift, Wow, Flutter and Scrape-Flutter which the user can impart with the center knob. It can take your source signal from mildly colored to totally mangled.

Print-Through – Also known as "bleed-through", this emulation captures the mechanical speed fluctuations present in analog recordings. While they posed challenges for engineers in the past, they became a hallmark of classic records.

NOTE: The print-through feature is not implemented.

Reach out and touch tape:

The Kiss of Shame is the first tape plug-in to feature animated, interactive reels that can be manipulated with a simple click or touch. This allows users to access authentic analogue tape flange in real-time, without the need for two physical tape decks, and in a fraction of the time. All parameters, including reel movements, are fully automatable, and for screen real estate optimization, the reels are collapsible and fully customizable.

TIP: To flange, drag on the reels. To collapse the reels, double-click anywhere in the UI.

Building from source code

Brief instructions:

  • Install JUCE 7 or newer.
  • Open KissOfShame.jucer in Projucer and export to your IDE.
  • Select the VST3 or AU target and build.

Currently only tested with:

  • JUCE 7.0.9
  • Xcode 15.2 + macOS Sonoma 14.3
  • Visual Studio 2022 + Windows 10

Changes from the original

The original code was written using JUCE 3.1. It required the user to copy a folder with image and sound files to /Users/Shared/KissOfShame. The parameters were not exposed to the DAW and would reset when the editor re-opened.

The following changes were made in this repo:

  • Converted to JUCE 7.
  • General code cleanup, fixed compiler warnings, added some comments.
  • Put the parameters into AVPTS, added state saving & loading.
  • Embedded the graphics and audio resources into the plug-in binary.
  • Added support for Windows and Apple Silicon Macs.
  • Changed the knobs from rotary to vertical drag.

TO-DO list

Bugs I found:

  • Sometimes there is an extremely loud glitch. Not sure yet what causes this, most likely some uninitialized memory.
  • When the Hurricane Sandy environment is active, moving the Age knob to the minimum position can cause the low-pass filter to give a massive gain boost.

Other things that can / should be improved in the code (volunteers welcome!):

  • Don't hardcode the sample rate to 44100 Hz.
  • Add prepareToPlay() and reset() methods to the DSP classes. The reset method should clear out old state.
  • Allocate buffers ahead of time and copy into them, rather than doing audioGraphProcessingBuffer = audioBuffer, which may allocate (at least the first time).
  • The envelope generators (Envelope and EnvelopeDips) could keep track of the prev and next point, so we don't have to loop through all the points at every timestep.
  • Often the loop for the channels is nested inside the loop for the samples, which can be inefficient.
  • Shame effect: The code allows for interpolating between the wavetables but all wavetables have the same data in it.
  • Reel animation: Don't set framesPerSecond to 0 to stop the animation.
  • audioProcessor.curPositionInfo uses a deprecated API.
  • VU meter RMS readings should be atomic, and ideally be independent of the block size.
  • Remove most of the compiler warnings. (I set the warning level high on purpose.)
  • Replace the Biquads with TPT / SVF filters.
  • Don't use rand() and srand(). Replace with juce::Random.
  • Parameter smoothing.

Maybe:

  • When you drag to apply flanging, I would expect a mouse up to reset the flanging depth, since the animation does return to normal speed.
  • Skew the flange depth so that shorter delays are easier to dial in. (For example by doing targetDepth = depth * depth * 1000.0f.)
  • Oversampling. The saturation stage can easily add aliases.
  • Use CMake instead of Projucer.

How it works

TODO

Credits & license

Copyright (C) 2014-2015 Eros Marcello

Original developers:

Updates and improvements by Matthijs Hollemans.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Some of the code in this repo (Granulate and Noise) was taken from The Synthesis ToolKit in C++ (STK) by Perry R. Cook and Gary P. Scavone.

JUCE is copyright © Raw Material Software.