GuitarToolkit

Русская версия

GuitarToolkit is an open-source Windows toolkit for guitar practice, writing, music theory, and DAW work. It ships as both a standalone WPF desktop app and a VST3 plugin with the same shared interface.

The project is built around practical guitar workflows: tune, practice with a metronome, inspect chords and scales, train intervals, build progressions, view Guitar Pro / MusicXML tabs, and sketch harmonic ideas with a local ONNX-based inspiration model.

Download

Get the latest Desktop, VST3, and ML Trainer builds from GitHub Releases.

For installation details, use the Quick Start guide.

Highlights

• Standalone Windows desktop app and VST3 plugin.
• Real-time tuner with alternate tunings and adjustable A4 reference.
• Metronome with tap tempo, quick tempos, visual beat feedback, and playback.
• Chord library with diagrams, voicings, formulas, favorites, and synthesized playback.
• Scale fretboard with modes, pentatonic, blues, harmonic minor, melodic minor, and chromatic views.
• Interval trainer with statistics and repeat/auto-advance workflow.
• Progression builder with presets, custom saved progressions, playback, and looping.
• Circle of fifths with related keys, diatonic chords, and common progressions.
• Tabs viewer for Guitar Pro / MusicXML files through alphaTab, including GP3, GP4, GP5/GPX, and MusicXML when supported by the importer.
• Inspiration Engine with a bundled local ONNX progression model, plus a separate ML Trainer utility for dataset generation, training, checkpoint comparison, ONNX export, and model installation.
• Melody sketchbook with a bundled local ONNX Transformer model, backing progressions, synchronized playback, editable notes, and a three-octave piano.
• Dark and light themes.

Screenshots

Tuner	Inspiration Engine

Chords	Tabs

More screenshots are stored in docs/images.

Project Status

Target	Status
Desktop app	Usable on Windows 10/11 x64
VST3 plugin	Usable, with DAW compatibility still being collected
Tabs viewer	Active development; alphaTab import limits may apply
Inspiration Engine	Local ONNX progression generation and playback
Melody sketchbook	Local ONNX short-phrase generation with editable playback
ML Trainer	Separate utility for training, evaluating, comparing, exporting, and installing local models
Platform	Windows-only for now

Documentation

• Documentation index
• Quick Start
• Supported DAWs
• FL Studio setup
• Reaper setup
• Known tab import issues
• Inspiration Engine model notes
• Roadmap
• Release process

Development

Open GuitarToolkit.sln in Visual Studio 2022 and use x64.

Command line:

dotnet restore GuitarToolkit.sln
dotnet build GuitarToolkit.sln --configuration Debug
dotnet test GuitarToolkit.sln --configuration Debug

Release package build:

powershell -ExecutionPolicy Bypass -File .\build-release.ps1 -Version 1.7.0 -Configuration Release

Architecture:

GuitarToolkit.Core      DSP, music theory, engines, settings
GuitarToolkit.UI        Shared WPF controls used by Desktop and VST3
GuitarToolkit.Desktop   Standalone Windows app integration
GuitarToolkit.Plugin    VST3 plugin integration
GuitarToolkit.Tests     xUnit tests for Core behavior
tools/ml                Local model tooling and ML Trainer utility

Community

• Releases
• Discussions
• Support
• Contributing
• Security
• Changelog

Use Discussions for questions, ideas, and DAW compatibility reports. Use Issues for reproducible bugs and scoped development tasks.

License

GuitarToolkit is released under the MIT License.

VST is a trademark of Steinberg Media Technologies GmbH. Third-party dependency notes are listed in THIRD_PARTY_NOTICES.md.

---

GuitarToolkit RU

English version

GuitarToolkit - open-source набор инструментов для гитаристов под Windows: практика, теория, наброски идей и работа в DAW. Проект поставляется как standalone WPF-приложение и как VST3-плагин с общим интерфейсом.

Идея простая: держать основные гитарные инструменты в одном месте. Настройка, метроном, аккорды, гаммы, интервалы, прогрессии, круг квинт, табулатуры Guitar Pro / MusicXML и локальная ONNX-модель для генерации идей.

Скачать

Актуальные сборки Desktop, VST3 и ML Trainer находятся в GitHub Releases.

Подробная установка описана в Quick Start.

Что есть

• Desktop-приложение для Windows и VST3-плагин для DAW.
• Тюнер в реальном времени, альтернативные строи и настройка эталона A4.
• Метроном с tap tempo, быстрыми темпами, визуальными долями и воспроизведением.
• Справочник аккордов с аппликатурами, формулами, избранным и синтезом звука.
• Гриф с гаммами, ладами, пентатоникой, блюзовой гаммой, гармоническим и мелодическим минором.
• Тренажер интервалов со статистикой, повтором и авто-переходом.
• Конструктор прогрессий с пресетами, сохранением, воспроизведением и циклом.
• Круг квинт с родственными тональностями, диатоническими аккордами и популярными прогрессиями.
• Просмотр табулатур через alphaTab: GP3, GP4, GP5/GPX и MusicXML, если конкретный файл поддерживается импортёром.
• Inspiration Engine: встроенная локальная ONNX-модель для генерации прогрессий.
• Отдельная утилита ML Trainer для датасетов, обучения, сравнения чекпоинтов, экспорта ONNX и установки модели в программу.
• Вкладка “Мелодии” со встроенной локальной ONNX Transformer-моделью коротких фраз.
• Тёмная и светлая темы.

Скриншоты

Тюнер	Inspiration Engine

Аккорды	Табы

Больше изображений лежит в docs/images.

Статус

Цель	Статус
Desktop	Можно использовать на Windows 10/11 x64
VST3	Можно использовать, совместимость с DAW ещё собирается
Табы	Активная разработка; возможны ограничения alphaTab
Inspiration Engine	Экспериментальный локальный ONNX-процесс
ML Trainer	Отдельная утилита для обучения и сравнения моделей
Платформа	Пока только Windows

Документация

• Индекс документации
• Быстрый старт
• Поддерживаемые DAW
• FL Studio
• Reaper
• Известные ограничения импорта табов
• Заметки по Inspiration Engine
• Roadmap
• Процесс релиза

Разработка

Откройте GuitarToolkit.sln в Visual Studio 2022 и используйте x64.

dotnet restore GuitarToolkit.sln
dotnet build GuitarToolkit.sln --configuration Debug
dotnet test GuitarToolkit.sln --configuration Debug

Сборка релизных архивов:

powershell -ExecutionPolicy Bypass -File .\build-release.ps1 -Version 1.7.0 -Configuration Release

Коротко по структуре:

GuitarToolkit.Core      DSP, теория музыки, движки, настройки
GuitarToolkit.UI        Общие WPF-контролы для Desktop и VST3
GuitarToolkit.Desktop   Standalone Windows-приложение
GuitarToolkit.Plugin    VST3-интеграция
GuitarToolkit.Tests     xUnit-тесты Core
tools/ml                ML-инструменты и ML Trainer

Сообщество

• Релизы
• Discussions
• Поддержка
• Участие в разработке
• Безопасность
• Changelog

В Discussions лучше писать вопросы, идеи и отчёты по DAW. В Issues лучше заводить воспроизводимые баги и конкретные задачи.

Лицензия

GuitarToolkit распространяется по MIT License.

VST является товарным знаком Steinberg Media Technologies GmbH. Сведения о сторонних зависимостях перечислены в THIRD_PARTY_NOTICES.md.