WWM Bard Tool v1.0

WWM Bard Tool v1.0 is a Windows MIDI-to-keystroke tool for Where Winds Meet.
It reads standard .mid files, analyzes their pitch content to detect a major key, maps notes into a 1–7 diatonic scale across low/medium/high ranges, and sends the corresponding key presses to your bard/guqin layout.

---

Key Features

• MIDI input

  • Reads standard .mid / .midi files from a user-selected folder.
  • Supports building a playlist from the loaded files.

• Scale & mapping logic

  • Analyzes pitch distribution to detect a likely major key for the track.
  • Maps every note into:
    • Scale degree: 1–7
    • Accidental: natural, sharp, or flat
    • Octave bucket: low, medium, high
  • Converts those into in-game keybinds:
    • Low: Z X C V B N M
    • Medium: A S D F G H J
    • High: Q W E R T Y U
    • Sharps via Shift + key (degrees 1, 4, 5 where available)
    • Flats via Ctrl + key (degrees 3, 7 where available)
  • Any note outside the playable range is snapped to the closest available note so every MIDI event produces a valid keypress.

• Playback control

  • Start: configure the current track and start from 0:00 with a short 3–2–1 countdown.
  • Resume: configure the current track and start from the current seek position.
  • Seek bar: shows playback progress; when stopped, you can scrub to any position and then Resume from there.
  • Autoplay playlist: automatically advances to the next track in the playlist when one finishes.
  • Loop current track: when enabled (and autoplay is on), replays the same track instead of advancing.
  • Global hotkey: Scroll Lock toggles between Resume and Stop without leaving the game.

• Local behavior

  • Configuration (e.g., last MIDI folder) is stored locally in a small JSON file under your user profile.
  • No networking, no cloud, no telemetry: it only translates MIDI events into simulated keystrokes.

---

Basic Usage

1. Launch
   Run WWM Bard Tool v1.0 on Windows. If the game doesn’t pick up the inputs reliably, run it as Administrator.

2. Select MIDI folder

   • Click “Browse…” and choose a folder containing .mid files.
   • The Library list will populate with all .mid / .midi files found.
   • Click ⟳ to refresh after adding/removing files in that folder.

3. Build a playlist (optional)

   • Select tracks in Library and click “Add →” to add them to the Playlist.
   • Use “← Remove” and “Clear” to manage the Playlist.

4. Configure controls in-game

   • Make sure your in-game instrument keybinds match the layout described above (Z–M, A–J, Q–U with Shift/Ctrl modifiers).
   • Make sure you are in free play, and your instrument is set to 36-keys.

5. Play

   • Use Start to play from the beginning with a countdown.
   • Use Resume to play from the current position on the seek bar.
   • Use the Seek bar (while stopped) to jump to a different point before resuming.
   • While you’re in Where Winds Meet, you can hit Scroll Lock to quickly stop or resume. (Requires Administrator)

---

Limitations & Notes

• The tool assumes a major-key, diatonic mapping. MIDI files with heavy chromaticism, modulations, or complex harmonies may not translate cleanly to the limited in-game scale.
• Some songs will inevitably sound different or “off” due to the instrument limitations in the game (restricted range and diatonic layout), not because the tool is failing to process the file.
• This is effectively a macro tool:
  • It simulates keyboard input and listens for a global hotkey.
  • Antivirus or anti-cheat systems may classify it as macro/automation behavior.

Virus Scan: https://www.virustotal.com/gui/file/a6d8baf781a38f3d28cba1bd475be2212f6eb815f6261604e4cf8ecdee4f9d52

• You are responsible for ensuring that using this tool complies with the Terms of Service of Where Winds Meet and any other software you use it with. Use at your own risk.