KUUSOUTOSHI AUDIO · Version 1.0.27 · Windows & macOS · VST®3 / AU / Standalone

DrumUnveil
User Manual v1.0.27

Split a drum recording into its kits and turn them into MIDI.

Contents

What is DrumUnveil

DrumUnveil is a plugin that splits a drum recording into six parts — kick, snare, toms, hi-hat, ride, and crash — and writes each one out as MIDI. Even if your drum track is a single mixed-down recording, DrumUnveil pulls out where each hit lands and how hard it was played, so you can re-trigger it with your own drum instrument.

The separated audio itself (six audio stems) comes out at the same time, so you can decide on the spot whether to rebuild the part in MIDI or just use the separated audio as-is.

Formats: Windows — VST3 and Standalone. macOS — VST3, Audio Unit (AU) and Standalone.

How it works

Both the separation work and the hit-detection work happen entirely on your own computer. No internet connection is used for that work. (Your licence is checked online when you activate it, then re-checked quietly at startup and about once a day. If those checks cannot reach the server, it keeps working for 30 days.) Once a file has been processed, the preparation work is kept in a cache, so loading the same file again takes almost no time.

Installation

System Requirements

WindowsmacOS
OSWindows 10 (1809) or later, 64-bitmacOS 11 (Big Sur) or later
Processor64-bit (x64) — Arm-based Windows is not supportedApple Silicon (M1 or later) only — Intel Macs are not supported
Plugin formatsVST3VST3, Audio Unit (AU)
Also includedStandalone applicationStandalone application
To installAdministrator privilegesYour Mac password

Installing

Windows — the installer for version 1.0.27

  1. Run the installer
  2. Choose what to install (Standalone / VST3, or both)
  3. Restart your DAW

macOS — the installer package for version 1.0.27

  1. Open the .pkg and follow the steps
  2. Enter your Mac password when asked
  3. Restart your DAW

Install Locations

WhatLocation
Standalone (Windows)C:\Program Files\KUUSOUTOSHI AUDIO\DrumUnveil\DrumUnveil.exe
VST3 (Windows)C:\Program Files\Common Files\VST3\DrumUnveil.vst3
Standalone (macOS)/Applications/DrumUnveil.app
VST3 (macOS)/Library/Audio/Plug-Ins/VST3/DrumUnveil.vst3
Audio Unit (macOS)/Library/Audio/Plug-Ins/Components/DrumUnveil.component

In your DAW's plugin list, it appears under the manufacturer name KUUSOUTOSHI AUDIO.

Tip

On Windows, the Standalone app and the plugin cannot run at the same time — close one before using the other.
On macOS there is no such restriction: the Standalone app and the plugin can be open together and both will sound.

Activating Your Licence

Before you enter a key, the same app runs with limited features: separation, detection, audition and editing all work, and you can export kick and snare MIDI with no time limit. Once you enter a key, all six parts and the separated audio can be exported. There's nothing new to download.

  1. Your licence key arrives in the receipt email (it also stays under My Orders on Lemon Squeezy)
  2. Open DrumUnveil and choose File → License…
  3. Paste the key into "Enter your license key:" and press ACTIVATE (an internet connection is needed at this point)
  4. When "License activated successfully!" appears, you're done. The top of the window then reads "This machine is activated"

One licence covers two machines. To move to another computer, open File → License… on the current one and press Deactivate this machine, then enter the key on the new computer.

Uninstalling

Windows

  1. Select Start > Settings > Apps > Installed apps, find DrumUnveil by KUUSOUTOSHI AUDIO, then select More > Uninstall. You can also start it from Uninstall DrumUnveil in the Start menu
  2. You'll be asked whether you have closed every DAW. A DAW that is still running keeps the plugin files open and they are left behind, so close them first, then choose Yes
  3. If the cache isn't empty, you'll be asked whether to remove it too

macOS

  1. Open Uninstall DrumUnveil in /Applications
  2. Click Continue and enter your Mac password when asked
  3. If the cache isn't empty, you'll be asked whether to remove it too
  4. A list of what was removed and what couldn't be removed is shown at the end
macOS: moving DrumUnveil.app to the Trash is not enough

Apple recommends using an app's own uninstaller when it has one. Moving only DrumUnveil.app to the Trash leaves the plugins (VST3 and AU) and the separation model files (about 420 MB) behind.
If a DAW is open while you uninstall, it keeps using DrumUnveil until you quit it. Restart your DAW afterwards.

Interface Overview

1 — Logo & About

The D mark and the KUUSOUTOSHI AUDIO wordmark, top left. Click it to open the About screen, which shows the version and the technologies used.

2 — Tempo Row

The BPM number (click to type in a new value), ×2 and ÷2 (double / halve), Auto (re-detect the tempo), the metronome icon, Beats (time signature), grid resolution, Snap (snap to grid), the drum map list, and 📌 (always on top).

3 — Tool Row

File · ↶ · ↷ · Select · Pen · Save As · Cache · Reset.

4 — Source Waveform

The topmost waveform. This is the audio you loaded, as-is. The thin band above it is the loop range for playback.

5 — Six Lanes

From top to bottom: KICK / SNARE / TOMS / HH / RIDE / CRASH. Each lane has the separated audio's waveform, marks for detected hits, a hit count, Sens / Gate / Swing knobs, a volume knob, Mute (M) and Solo (S), and a drag handle ⠿ for exporting.

6 — Transport

▶ · ■ · ↻, and the Listen switch (MIDI / Audio / Both).

7 — Bottom Bar

The export name field, a progress bar, status messages, and the Done badge.

Window Size

Drag the bottom-right corner to resize the window.

Loading Audio

Drop a drum audio file anywhere on the screen. Supported formats are .wav .aiff .aif .mp3 .flac.

Dropping a file starts the process of splitting the audio into six parts. Progress is shown in the bar at the bottom of the screen. Press Cancel if you want to stop partway through. The Done badge appears when it finishes.

If you load the same file again, DrumUnveil reuses the previous processing from its cache, so it takes almost no time.

Note

Processing time depends on the length of the track and your computer. Exporting and editing are not available until it finishes.

The Six Lanes

The separated audio is arranged into six lanes from top to bottom: KICK, SNARE, TOMS, HH, RIDE, CRASH. Each lane shows a waveform and marks (vertical lines) for detected hits. The height of a mark is the strength of that hit. The number to the right of the lane is the number of hits found there.

Pressing M mutes that lane; pressing S solos it. Each lane's volume knob only changes the audition volume — it does not affect the exported MIDI.

Tempo, Time Signature & Grid

When you load audio, the tempo is detected automatically and shown in BPM. If it's wrong, click the number to type in a new one, use ×2 / ÷2 to double or halve it, or use Auto to detect it again.

Beats is the time signature (the number of beats per bar). You can choose from 2 to 7.

Grid resolution can be set to one of eight values: 1/4 1/8 1/16 1/32 1/64 1/8T 1/16T 1/32T. The grid is drawn as lines over the waveform and is used both by Snap and when placing or moving notes with the Pen.

Pressing the metronome icon makes it click on the beat during playback.

Listening

▶ plays, ■ stops (returning to the play cursor you placed; press it again while stopped to go back to 0:00), and ↻ loops inside the working range. You can also play/pause with the spacebar.

Until audio has been loaded and split into six parts, ▶, ■ and ↻ can't be pressed (and the spacebar does nothing).

The Listen switch decides what you hear.

The MIDI and AUDIO knobs in the bottom bar are the overall volume for each.

Read this first if you hear nothing inside a DAW

Put DrumUnveil on a software-instrument track, not on an empty audio track. This catches people out, especially with the Audio Unit (AU) version on macOS.

Playback here rides on the audio the DAW is processing for that track. On an audio track with nothing on it, many hosts skip processing altogether, so the ▶ button changes to pause but the playhead does not move and you hear nothing. The audio you loaded into DrumUnveil does not count — the host needs audio of its own on that track.

Two ways round it:

The Standalone application is never affected: it runs its own audio device. Confirmed in GarageBand; some DAWs process empty tracks anyway, in which case none of this applies.

Mouse & Keyboard

Everyday Operations

ActionWhat happens
Left clickStarts playback from that position (places the play cursor)
Left dragZooms in to the selected range
Left double-clickResets the view to fit everything (both horizontal and vertical)
WheelZoom in/out horizontally, centred on the mouse
Shift + WheelZoom in/out vertically
Ctrl + Shift + WheelZoom in/out both horizontally and vertically, horizontally centred on the mouse (on a Mac, use the control key — not ⌘)
Ctrl + WheelZoom in/out horizontally, centred on the mouse (same as the wheel alone; control on a Mac)
Middle-button dragPans the view horizontally
Right dragCreates a working range
Right double-clickRemoves the working range
SpacebarPlay / pause
HomeStops playback and returns to the play cursor you placed; press again to go to 0:00 (same as ■)

While the Pen is ON

ActionWhat happens
Click on empty spaceAdds a note at that position (snaps to the grid if Snap is ON)
Click on a note markDeletes that note
Drag a note mark up/downChanges that note's velocity (up = louder, down = softer; 1–127)
Shift + drag a note mark sidewaysMoves that note (snaps to the grid if Snap is ON). Shift + click deletes it, like a normal click
Drag from empty spaceDeletes all the notes it passes over
Tip

Double-click a knob to reset it to its default. Left double-click on the waveform to reset the zoom to fit everything. The Zoom knob in the bottom bar zooms around the playhead (the blue line).

Sensitivity, Gate & Swing

Each lane has three knobs.

The floor gate and global swing in the bottom bar set the same value across all six lanes at once. Moving a lane's own knob afterward overrides that lane only.

ParameterRangeDefault
Sens0.25 – 4.00 (log)1.00
Gate0.00 – 0.200.05
Swing0% – 100%100%
Floor Gate0.00 – 0.200.05
Global Swing0% – 100%100%

Working Range & the Settings Card

Right-drag across the waveform to create a working range. Click the [⋯] that appears at its right edge to open the settings card.

The card lets you use different values just within that range.

Press Confirm to confirm the range, which remains as a band. Click a confirmed band to reopen it for editing, or Delete to remove it.

Right double-click removes a working range. The card can be dragged and dropped anywhere you like.

NameRangeOverride Checkbox
Retention0 – 100None (this range always overrides)
Sens0.25 – 4.00Yes ("override for this range")
Gate0.00 – 0.20Yes
Velocity0.50 – 2.00Yes

Pen Editing

Press Pen to enable it. While the Pen is on, mouse actions on the waveform become note edits instead (see Mouse & Keyboard).

With Snap on, notes you place or move snap to the grid. Turn it off if you need finer placement.

A moved note gets a thin lime-green line on its right, and a faint line stays at its original position. A note you placed by hand gets a thin white line. A moved note plays and exports exactly where you put it (Swing doesn't affect it). Move it back to its original position and Swing applies again.

If you save moved notes in 1.0.27 and open them in 1.0.26 or earlier, detected notes go back to their original positions. Notes you placed by hand and then moved stay where you moved them, but without the faint line.

The Pen's on/off state is not saved. It is off again the next time you open the plugin.

Undo & Reset

↶ undoes one step, ↷ redoes it. Moving a knob from press to release counts as one step.

Pressing Reset discards all your edits and returns to the state right after loading.

Drag & Drop Export

Drag the ALL knob and drop it onto a DAW track or folder. The file is created on the spot. Drag a lane's ⠿ handle to export just that lane.

What comes out depends on the Listen state.

Press Select to enter selection mode, which shows a checkbox to the right of each lane's name. Drag from the name of any checked lane and all the checked lanes are exported together. Checked lanes show the ⠿ grip — drag from it or from the lane's name. Save As also saves only the checked lanes. ALL ignores the checks and exports everything selected in the mixer.

A lane with no notes is not exported.

Save As

Press Save As to choose a save location. The default location is Music\DrumUnveil\.

File names are prefixed with whatever is entered in Name: in the bottom bar. If it's left empty, the loaded audio file's name is used instead.

You can also drop a file directly onto the Save As button to save it to the same location.

Saving Your Edits (.duv)

Use File → Save edit data… to save your edits as a .duv file. Use File → Load edit data… to load one back. A .duv file can also be loaded by dropping it onto the screen.

Only the edits themselves are saved — not the audio. To load a .duv file, the original audio file must be in the same location.

Drum Maps

Choose your drum instrument from the list in the top bar. Selecting an instrument automatically assigns each kit's note number to that instrument's layout.

If your instrument isn't in the list, open Edit drum map…, set the six note numbers (0–127), give it a name, and save it — it will always be available afterward. The three built-in maps cannot be deleted.

The last map you selected is remembered, and is still selected the next time you open the plugin.

Map NameKICKSNARETOMSHHRIDECRASH
GM (Standard)363847425149
Addictive Drums 2363869496077
Toontrack (EZdrummer / Superior Drummer)363847425149

Full Parameter List

Per Lane

ParameterRangeDefault
Sens0.25 – 4.00 (log)1.00
Gate0.00 – 0.200.05
Swing0% – 100%100%
Volume0% – 200%100%
PanLeft – Right
(Both mode only)
Center

Global

ParameterRangeDefault
Floor Gate0.00 – 0.200.05
Global Swing0% – 100%100%
MIDI Volume0% – 200%100%
AUDIO Volume0% – 200%100%
Zoom1.0× – 64× (log)1.0×
Beats2 – 7—

Selection Card

NameRangeOverride Checkbox
Retention0 – 100None (this range always overrides)
Sens0.25 – 4.00Yes ("override for this range")
Gate0.00 – 0.20Yes
Velocity0.50 – 2.00Yes

File Locations

WhatWindowsmacOS
Separation modelsC:\ProgramData\DrumUnveil\models\/Library/Application Support/DrumUnveil/models/
Audition samplesC:\ProgramData\DrumUnveil\audition\/Library/Application Support/DrumUnveil/audition/
Processing cache%APPDATA%\DrumUnveil\cache\~/Library/Application Support/DrumUnveil/cache/
Your custom drum maps%APPDATA%\DrumUnveil\maps\~/Library/Application Support/DrumUnveil/maps/
Last-used map record%APPDATA%\DrumUnveil\settings.json~/Library/Application Support/DrumUnveil/settings.json
Export temp folder%TEMP%\DrumUnveil\your system temporary folder, DrumUnveil/
Default Save As locationMusic\DrumUnveil\~/Music/DrumUnveil/

The cache keeps only the 20 most recent entries — older ones are removed automatically. Use Cache → Clear cache to empty it manually. Cache → Clear view just removes the currently open audio from the screen.

Uninstalling keeps your custom drum maps. For the cache, the uninstaller asks whether to remove it (only when it isn't empty). To remove everything including your maps, delete %APPDATA%\DrumUnveil\ (Windows) or ~/Library/Application Support/DrumUnveil/ (macOS) by hand. See Uninstalling for the steps.

Troubleshooting

The plugin doesn't show up in my DAW

Restart your DAW and have it rescan for plugins. If it still doesn't appear, check that the plugin file is there — C:\Program Files\Common Files\VST3\DrumUnveil.vst3 on Windows, /Library/Audio/Plug-Ins/VST3/DrumUnveil.vst3 or /Library/Audio/Plug-Ins/Components/DrumUnveil.component on macOS. Some DAWs require this location to be added to their scan settings.

No audition sound

If you see Audition samples not found (see manual), the audition samples couldn't be found. Check whether files exist in C:\ProgramData\DrumUnveil\audition\ (Windows) or /Library/Application Support/DrumUnveil/audition/ (macOS), and if not, reinstall.

The play button toggles, but nothing moves and nothing sounds

Most often: DrumUnveil is sitting on an empty audio track — move it to a software-instrument track. This catches people out most with the Audio Unit (AU) version on macOS. Inside a DAW this happens on a track that has no audio running through it. Audition rides on the DAW's audio processing, so on a track the host isn't processing, only the button's appearance changes — the playhead and the sound stay where they are.

Either of these fixes it:

The standalone application has no such limitation.

Observed in GarageBand. Some DAWs keep processing empty tracks, in which case none of this is necessary.

Audio won't load

If you see Couldn't load the file, the file is either corrupted or in an unsupported format. Try re-exporting it as .wav and load it again.

It says the previous file can't be found

Previous file not found -- drop it again (settings restored) means your saved settings were restored, but the original audio file has been moved or deleted. Drop the same audio file again to continue working.

No sound when running the Standalone and a DAW at the same time (Windows)

Run only one of them at a time. This does not apply on macOS — there, the Standalone app and the plugin can both play at once.

Picking up too much / too little

Adjust that lane's Sens and Gate. If bleed is being picked up too much, raising Gate helps.

Nothing happens when I try to export

Check the bottom bar for one of these messages: Drag from a checked lane / No notes in the checked lanes / No output selected (enable MIDI/AUDIO in the mixer).

I can't undo anything

Editing isn't available while processing is in progress. Wait for Done to appear before making edits.

Support & Specs

Contact

Email: support@kuusoutoshi-audio.com
Web: https://kuusoutoshi-audio.com

Technical Specifications

↑