======================================================================
 HATGRAFT  v1.0.0
 Hybrid Hi-Hat Instrument
 Tonecraft Tokyo
======================================================================

* Overview

HATGRAFT is a free VST3 / AU instrument dedicated to hi-hat sounds.

  - Besides the three ways of playing - closed, pedal and open -
    the pedal (MIDI CC4) changes how far the cymbals are open,
    continuously. Half-open hits and foot splashes all come from
    one pair of hats, so the timbre always matches.
  - An open hat stops with the sound of the cymbals closing when
    you close it (CHOKE). Half-open, the two cymbals rub against
    each other and sizzle (SIZZLE).
  - Fluctuates slightly on every hit (FLUX). Playing back the same
    part of a song always produces the identical sound, so rendered
    audio matches what you hear.
  - Contains hi-hat patterns across the 12 keys from C3 to B3.
    Patterns can be rerolled with RANDOM and dragged from the keys
    into your DAW as MIDI.
  - Includes 32 factory presets.

It installs as a separate plugin from the upgraded HATGRAFT Pro, so
you can have both installed.

No samples are bundled. The three synthesized layers produce sound
right from the start. You can also drag and drop your own hi-hat
sounds onto two slots, one for closed and one for open, to layer
them.


* Requirements

  OS               Windows 10 / 11 (64bit)
                   macOS 11 or later (Apple Silicon / Intel)
  Format           Windows: VST3 / Mac: VST3, AU (Instrument)
  Supported DAWs   DAWs compatible with VST3 / AU
  Outputs          Stereo
  Window size      1200 x 940 (fixed; can be shown at 60-100 %)
  Screen language  Japanese / English (follows OS display language)


* Installation

[Windows]

  1. Extract this ZIP file.
  2. Copy the HATGRAFT.vst3 folder to the following location:

       C:\Program Files\Common Files\VST3\

  3. Launch your DAW and perform a plugin rescan.
     (If you copy the file while your DAW is running, changes may
     not take effect.)

To uninstall, delete the HATGRAFT.vst3 folder you copied. To
also remove your user presets, delete %APPDATA%\Hatgraft\Presets\
as well.


[Mac]

  1. Extract this ZIP file.
  2. Copy HATGRAFT.vst3 and HATGRAFT.component to their
     respective locations:
     (~ represents your user home folder. Open it by pasting the
     path into Finder: Go -> Go to Folder. Create the folder if
     it does not exist.)

       HATGRAFT.vst3      -> ~/Library/Audio/Plug-Ins/VST3/
       HATGRAFT.component -> ~/Library/Audio/Plug-Ins/Components/

  3. Open Terminal (Applications -> Utilities -> Terminal), paste
     the following three lines one by one, and press Return:

  cd ~/Library/Audio/Plug-Ins
  xattr -dr com.apple.quarantine "VST3/HATGRAFT.vst3"
  xattr -dr com.apple.quarantine "Components/HATGRAFT.component"

     If nothing is displayed, it succeeded. If you do not run
     this, macOS will show messages like "is damaged and cannot
     be opened" or "cannot be opened because the developer
     cannot be verified", and the DAW will not load the plugin.
     This command only removes the quarantine attribute that
     macOS attaches to downloaded files (you need to run it again
     when updating or reinstalling).
  4. Launch your DAW and perform a plugin rescan.
     (If the AU plugin does not appear in Logic Pro or other
     DAWs, restart your Mac.)

To uninstall, delete HATGRAFT.vst3 and HATGRAFT.component
that you copied. To also remove your user presets, delete
~/Library/Hatgraft/Presets/ as well.


* Quick start

  1. Insert HATGRAFT on an instrument track.
  2. Play F#1 / G#1 / A#1 to trigger closed / pedal / open.
  3. Find a sound close to what you want from the 32 presets in the
     top bar.
  4. Press C3 to B3 to play that key's pattern in time with the
     tempo. To change its contents, press RANDOM; to keep one you
     like, press LOCK.
  5. Move the pedal (CC4) with a foot controller or DAW automation.
     0 is open, 127 is closed.
  6. To layer your own hi-hat sounds, drop WAV or other audio files
     into the CLOSED / OPEN slots in SAMPLE.

For detailed instructions, see the bundled HATGRAFT_Manual_EN.html.

  Keyboard (Ableton display; middle C = C3)
    F#1 = closed / G#1 = pedal / A#1 = open
    Patterns = 12 keys in the octave chosen with ZONE (default C3-B3)


* About the download warning

[Windows]
Because the software is not code-signed, your web browser may show
a warning when downloading the ZIP. In that case, choose to keep or
allow the download.

Also, before unzipping, right-click the ZIP file and open
Properties. If you see "Security: This file came from another
computer..." at the bottom, check "Unblock", click OK, and then
extract the files.

[Mac]
Run the command in Step 3 of the installation instructions. Do the
same when updating or reinstalling.

This product is a VST3 / AU plugin. It does not launch on its own;
your DAW loads it as a plugin.


* Free vs Pro

An upgraded edition, "HATGRAFT Pro", is also available for more
detailed sound shaping. It is the free edition with everything
below added:

  - FLUX adjustment: FLUX and STRENGTH / POSITION (where the stick
    lands) / DRIFT (rushing and dragging)
  - Every control on the EDIT screen; saving, deleting and
    exporting user presets
  - Pattern export as WAV: the full mix plus one file per way of
    playing
  - Individual outputs per way of playing (CLOSED / OPEN / PEDAL)
  - 36 factory presets, including the HUMAN category

In the free edition, Pro controls are shown locked with a PRO mark.
Clicking a PRO mark opens the Pro edition's page in your browser.

  Feature                  Free                 Pro
  --------------------------------------------------------------
  FLUX adjustment          Fixed at 25          Yes
  EDIT screen controls     METAL TYPE / TUNE    All
  Pattern export           MIDI                 + WAV
  Individual outputs       -                    3 stereo pairs
  Save user presets        -                    Yes
  Factory presets          32                   36


* Notes

  - This product is distributed free of charge (freeware) as-is,
    without support.
  - The source code is closed source.
  - The copyright of this product belongs to Tonecraft Tokyo.
  - Modification, reverse engineering, redistribution, and resale
    are prohibited. Please download it only from the official
    Tonecraft Tokyo website or the store pages it links to.
  - Free to use for both commercial and non-commercial purposes.
  - This product uses JUCE.
  - This product uses JetBrains Mono and Noto Sans JP
    (SIL Open Font License 1.1).


* Disclaimer

  - This product is provided "AS IS", without warranty of any kind,
    express or implied, including but not limited to merchantability,
    fitness for a particular purpose, and non-infringement of
    third-party rights.
  - Tonecraft Tokyo is not liable for any damages arising from the use
    of, or inability to use, this product, including but not limited
    to loss or corruption of project files or audio data, equipment
    malfunction, lost working time, or lost profits.
  - Operation is not guaranteed for every combination of DAW,
    operating system, and hardware.
  - Specifications may change, and the product may be discontinued,
    without notice.
  - Use this product at your own risk. Back up your projects before
    important work.


* Version history

[v1.0.0]
  - First release


* Manual

  Latest manual (official site)
  https://www.tonecraft.blue-x.tokyo/hatgraft-user-manual-en
  Japanese: https://www.tonecraft.blue-x.tokyo/hatgraft-user-manual


* Feedback

  We welcome your feedback and impressions.

    info@tonecraft.blue-x.tokyo

  We cannot promise individual support. However, your feedback will
  be used as reference for future product development.


* Distributor

  Tonecraft Tokyo
  https://www.tonecraft.blue-x.tokyo/free-vst-plugins

(c) 2026 Tonecraft Tokyo. All rights reserved.
