Легковесное и высокопроизводительное C++17 приложение для Windows (MSVC), превращающее MIDI-клавиатуру Arturia Minilab 3 в многофункциональный пульт управления звуком, медиаплеером, макросами и системными хоткеями.
** Скачать последнюю версию (.zip)** • ** Справка по настройке** • ** Архитектура**
- ?? Основные возможности
- ?? Быстрый старт и скачивание
- ?? Карта элементов по умолчанию
- ?? Схема работы приложения
- ?? Первый запуск и Windows SmartScreen
- ?? Документация
- ?? Сборка из исходников
- ?? Структура проекта
- ?? Лицензия
- ?? Управление громкостью (Master & Focus) — Регулировка общей мастер-громкости Windows на 1-м фейдере и громкости активного фокусного окна на 1-м энкодере через WASAPI Core Audio API.
- ? Перемотка и Масштабирование — Плавная перемотка медиафайлов/треков и изменение масштаба страниц в браузерах с помощью энкодеров (Encoders 1–2).
- ?? Быстрые макросы и системные действия — Мгновенный показ рабочего стола (
Win+D), запуск Telegram, скриншот области (Win+Shift+S) и приглушение звука (Smart Ducking 10%). - ?? Полупрозрачный OSD Overlay — Стильный индикатор поверх всех окон с анимацией таймера, отображающий уровень громкости и статус выполненных действий.
- ?? Системный трей и Автозапуск — Фоновая работа возле часов, контекстное меню управления и интеграция с реестром Windows для автозагрузки.
- ?? Графическая карта-шпаргалка (
MappingWindow) — Встроенное окно с визуальной схемой назначения клавиш в тёмном дизайне.
- Перейдите в раздел Releases и скачайте
MidiControl-vX.Y.Z-win64.zip. - Распакуйте архив в удобную папку (например,
C:\Tools\MidiControl). - Подключите вашу MIDI-клавиатуру Arturia Minilab 3 по USB.
- Запустите
MidiControl.exe. Приложение автоматически найдёт клавиатуру и свернётся в трей.
| Элемент | MIDI CC | Действие (type) |
Описание |
|---|---|---|---|
| Fader 1 | 82 (Arturia) / 14 (DAW) |
master_volume |
Общая мастер-громкость Windows |
| Faders 2–4 | 83, 85, 15 |
— | Свободны для пользовательской настройки |
| Элемент | MIDI CC | Действие (action) |
Описание |
|---|---|---|---|
| Encoder 1 | 74 |
seek_media |
Перемотка видео / трека (Вперед при CC > 64, Назад при CC < 64) |
| Encoder 2 | 71 |
zoom_browser |
Масштабирование сайтов (Ctrl+Plus при CC > 64, Ctrl+Minus при CC < 64) |
| Пэд | Note / CC | Действие (action) |
Сочетание / Описание |
|---|---|---|---|
| Pad 1 | Note 36 / CC 102 |
master_mute |
Включить / Выключить звук Windows (VK_VOLUME_MUTE) |
| Pad 2 | Note 37 / CC 103 |
smart_ducking |
Временное приглушение звука до 10% |
| Pad 3 | Note 38 / CC 104 |
media_prev |
Предыдущий трек (VK_MEDIA_PREV_TRACK) |
| Pad 4 | Note 39 / CC 105 |
media_play_pause |
Воспроизведение / Пауза (VK_MEDIA_PLAY_PAUSE) |
| Pad 5 | Note 40 / CC 106 |
media_next |
Следующий трек (VK_MEDIA_NEXT_TRACK) |
| Pad 6 | Note 41 / CC 107 |
launch_telegram |
Быстрый запуск Telegram по протоколу tg:// |
| Pad 7 | Note 42 / CC 108 |
show_desktop |
Свернуть все окна / Показать рабочий стол (Win + D) |
| Pad 8 | Note 43 / CC 109 |
snipping_tool |
Захват области экрана Ножницами (Win + Shift + S) |
flowchart TD
A[Arturia Minilab 3] -->|WinMM Callback| B[MidiController]
B -->|Чтение настроек| C[ConfigManager / config.json]
B -->|Громкость| D[AppVolumeManager WASAPI]
B -->|Медиа / Хоткеи| E[MediaController SendInput]
B -->|Уведомления| F[OSDWindow Layered UI]
G[TrayManager] -->|Контекстное меню| H[MappingWindow UI]
G -->|Автозапуск| I[Windows Registry]
D --> K[Windows Audio Engine]
E --> L[Windows OS & Apps]
При первом запуске файла MidiControl.exe фильтр Microsoft Defender SmartScreen в Windows может показать синее окно предупреждения: «Система Windows защитила ваш компьютер».
Note
Это стандартное поведение Windows для любых новых утилит и Open-Source проектов, у которых нет платной коммерческой цифровой подписи (Code Signing Certificate). Приложение абсолютно безопасно, не требует установки и не содержит вредоносного кода.
- В синем окне SmartScreen нажмите ссылку «Подробнее» (More info).
- В появившемся меню нажмите кнопку «Выполнить в любом случае» (Run anyway).
- Приложение запустится и свернётся в системный трей возле часов.
- ?? Руководство по конфигурации (CONFIGURATION.md) — Справочник всех параметров
config.json, привязка MIDI CC/Note и настраиваемые команды. - ?? Архитектура приложения (ARCHITECTURE.md) — Подробное техническое описание устройства WASAPI, WinMM, GDI Overlay и многопоточности.
- Компилятор MSVC (Visual Studio 2019 / 2022 / 2026)
- CMake 3.16+
.\build.batИсполняемый файл будет собран по пути: build\Release\MidiControl.exe.
.
+-- .github/workflows/
¦ L-- release.yml # CI/CD автоматический релиз при push тега
+-- CMakeLists.txt # Скрипт сборки CMake
+-- config.json # Пользовательский файл конфигурации
+-- Doxyfile # Конфигурация Doxygen
+-- build.bat # Скрипт сборки в 1 клик для MSVC
+-- docs/
¦ +-- ARCHITECTURE.md # Описание архитектуры и подсистем
¦ L-- CONFIGURATION.md # Справочник конфигурации
+-- include/
¦ +-- Utils.h # Утилиты кодировок UTF-8/UTF-16
¦ +-- ConfigManager.h # Парсер и структура конфигурации JSON
¦ +-- AppVolumeManager.h # Управление громкостью WASAPI
¦ +-- MediaController.h # Эмуляция мультимедиа и хоткеев
¦ +-- OSDWindow.h # Полупрозрачный OSD-индикатор
¦ +-- MappingWindow.h # Окно интерактивной шпаргалки
¦ +-- TrayManager.h # Системный трей Windows
¦ L-- MidiController.h # Диспетчер событий MIDI
L-- src/
+-- Utils.cpp
+-- ConfigManager.cpp
+-- AppVolumeManager.cpp
+-- MediaController.cpp
+-- OSDWindow.cpp
+-- MappingWindow.cpp
+-- TrayManager.cpp
+-- MidiController.cpp
L-- main.cpp # Точка входа приложения
Распространяется под лицензией MIT. Вы можете свободно использовать, изменять и распространять данное программное обеспечение.