Tonecraft Tokyo — VST3 / AU Plugin

HATGRAFT

User Manual — v1.0.0

Latest manual (official site) ↗

HATGRAFT is a free drum instrument dedicated to hi-hats. Besides the three ways of playing — closed, open and pedal — the pedal (MIDI CC4) changes how far the cymbals are open, continuously, so half-open hits and foot splashes all come from one plugin. It installs as a separate plugin from the paid HATGRAFT Pro, so you can have both installed.

No samples are bundled. It produces sound out of the box using only 3 synthesized layers (METAL / AIR / STICK). You can also layer your own hi-hat sounds on two slots, one for closed and one for open.

1. Quick Start

  1. Insert HATGRAFT on an instrument track in your DAW.
  2. Play F#1 / G#1 / A#1. Closed (CLOSED), pedal (PEDAL) and open (OPEN) sound. Clicking the on-screen keys also plays them.
  3. Use the preset bar at the top to browse the 32 factory presets (8 categories) and find a sound close to what you have in mind.
  4. Press C3–B3 (default) to play that key's hi-hat pattern in time with the tempo.
  5. To reroll a pattern, press RANDOM. Press LOCK to keep one you like.
  6. To layer your own hi-hat sounds, drop audio files (WAV etc.) onto the CLOSED / OPEN slots in the SAMPLE panel.

HATGRAFT varies slightly on every hit (FLUX). Playing back the same part of a song always produces the same sound, so rendered audio matches what you heard. In the free edition the amount is fixed at 25, but the 8 bars still show the actual variation (adjusting its amount and character is a Pro feature).

2. Panel Overview

There are MAIN and EDIT tabs at the top (switching tabs does not change the window size). The keyboard in the lower half works on both tabs. At the top right you can choose the display size from 60 / 70 / 80 / 90 / 100 %. The first time it opens at 100 % (or, if that does not fit your screen, at the largest size that fits). Your choice is remembered on that computer the next time you open it. Hover over a control to see its description in the InfoBar at the top (Japanese or English, following your OS display language).

To the right of the logo are the version number and the Manual (opens the latest version of this manual on the official site) and Feedback (opens a form for impressions, bug reports and requests) links. Your browser opens only when you click one.

Preset bar (top)

MAIN screen

EDIT screen

Click the EDIT tab to show the detailed sound-design screen. In the free edition only METAL TYPE and TUNE can be operated (the other parameters can be seen; operating them is a Pro feature). Values stored in factory presets or in your DAW session still sound as saved.

Pro features and the “PRO” mark

In the free edition, the parts with Pro features carry a “PRO” mark. Hover over a locked control to see a description of the Pro feature in the InfoBar; click a PRO mark to open the Pro edition's page.

Free vs Pro

Feature Free Pro
FLUX Fixed at 25 (the variation display still moves) Adjust FLUX + STRENGTH / POSITION / DRIFT
EDIT screen Only METAL TYPE and TUNE can be operated (the rest sound with preset / session values) Everything can be operated
Pattern export Drag as MIDI + drag as WAV (full mix and per way of playing)
Individual outputs per way of playing None 3 (CLOSED / OPEN / PEDAL)
Factory presets 32 36 (+ 4 HUMAN)
User presets Open, import a file + save, remove, export to a file

3. Parameter Details

Three ways of playing and the pedal (CC4)

SAMPLE

Drop an audio file (wav / aiff / flac / mp3) onto the CLOSED / OPEN slot in the SAMPLE panel to load it. Each slot holds up to 3 seconds; longer files are cut at 3 seconds (the slot says so). Hits that are only slightly open use the CLOSED slot, and widely open hits use the OPEN slot. You can load just one slot; an empty slot plays no sample. Start position, pitch, brightness, attack, length and level can be adjusted in SAMPLE on the EDIT screen (a Pro feature; in the free edition they sound with preset or session values).

FLUX

The variation on every hit. In the free edition it is fixed at 25 (adjusting it with the FLUX knob or STRENGTH / POSITION / DRIFT is a Pro feature). As when a person plays, how hard, where the stick lands and the timing all vary, and pitch, decay, brightness, level, attack, left–right image, timing and sizzle change a little. They change together the way real playing does — a harder hit is louder, brighter and sharper at once. Playing the same part of a song gives the same sound every time. The 8 bars show the actual variation on the last hit.

WEAR / SPAN / RESET

The way the cymbals settle in as you keep playing. SPAN is the number of bars until the change is at its largest. It follows the bar position, not elapsed time, so moving the playback position still gives the same sound at the same place. With RESET on, the change returns to the start when playback stops.

PHRASE

Each of 12 keys holds one hi-hat pattern. While you hold a key, it plays in time with the tempo.

OUTPUT knobs (MAIN screen)

EDIT screen parameters

In the free edition only METAL TYPE and TUNE can be operated. The other parameters sound with preset or session values.

4. Recommended Settings

If unsure, pick from a factory preset category.

You do not need to program hi-hats one hit at a time. Choose a convenient key position with ZONE, hold the C3–B3 keys to play patterns, reroll with RANDOM and LOCK the ones you like — that is the easiest way to use it. You can also drag a pattern out as MIDI and edit it in your DAW.

5. Requirements

ItemDetails
Supported OSWindows 10 / 11 x64, macOS 11 or later (Apple Silicon / Intel)
Plugin formatWindows: VST3 / Mac: VST3, AU (Instrument)
HostDAW compatible with VST3 or AU
Bundled samplesNone (sounds with synthesis alone)
Outputs1 stereo output (individual outputs per way of playing are a Pro feature)

6. Installation and Uninstallation

* This product is recognized as a separate plugin from HATGRAFT Pro, so both can be installed side by side.

Installation (Windows)

  1. Extract the downloaded ZIP file.
  2. Copy the HATGRAFT.vst3 folder to the following location:
    C:\Program Files\Common Files\VST3\
  3. Launch your DAW and run a plugin rescan.

Installation (Mac)

  1. Extract the downloaded ZIP file.
  2. Copy HATGRAFT.vst3 to ~/Library/Audio/Plug-Ins/VST3/ and HATGRAFT.component to ~/Library/Audio/Plug-Ins/Components/ (~ is your home folder. In Finder, choose Go → Go to Folder and paste the path to open it. Create the folder if it does not exist).
  3. Open Terminal (Applications → Utilities → Terminal), paste the following three lines one at a time, and press Return after each:
    cd ~/Library/Audio/Plug-Ins
    xattr -dr com.apple.quarantine “VST3/HATGRAFT.vst3”
    xattr -dr com.apple.quarantine “Components/HATGRAFT.component”
  4. Launch your DAW and run a plugin rescan (if you copy the files while your DAW is running, the change may not take effect).

If nothing is printed, the command succeeded. Unless you run this, macOS will display “is damaged and can’t be opened” or “cannot be opened because the developer cannot be verified”, and your DAW will not load the plugin. This command simply removes the quarantine attribute (a mark) that macOS attaches to downloaded files. You must run it again whenever reinstalling for an update.

Uninstallation (Windows)

Delete C:\Program Files\Common Files\VST3\HATGRAFT.vst3. If you also want to remove saved user presets, delete %APPDATA%\Hatgraft\Presets as well.

Uninstallation (Mac)

Delete HATGRAFT.vst3 and HATGRAFT.component. If you also want to remove saved user presets, delete ~/Library/Hatgraft/Presets as well.

7. Troubleshooting

8. Notes

9. Disclaimer