MiniLab Key Deck

Играй в ритм-игры (Fortnite Festival и др.) на MIDI-клавишах и пэдах — с живой светомузыкой. Play rhythm games (Fortnite Festival & more) with MIDI keys and pads — plus a live pad light show.

🌍 Русский · English · Українська · Deutsch · Español · Français

Arturia MiniLab 3 · MIDI to keyboard · Fortnite Festival · osu! · Clone Hero · rhythm games · MIDI controller · pad light show · key mapper

⬇️  Скачать MiniLabKeyDeck.exe  →

---

✨ Что это / What it is

MiniLab Key Deck превращает MIDI-контроллер (первым делом Arturia MiniLab 3, но подойдёт любой MIDI) в клавиатуру для ритм-игр. Нажатие клавиши/пэда на контроллере → нажатие клавиши на ПК. Плюс — живая светомузыка на RGB-пэдах MiniLab, реагирующая на звук с компьютера.

• 🎹 Играй в Fortnite Festival, osu!, Clone Hero и др. клавишами и пэдами.
• 💡 Пэды переливаются под музыку (бас разгоняет радугу, хай-хеты вспыхивают белым).
• 📦 Один .exe, всё внутри. Без подписки, без облака, работает офлайн.

MiniLab Key Deck turns a MIDI controller into a keyboard for rhythm games (key/pad press → PC keypress), with an always-on audio-reactive light show on the MiniLab pads. One .exe, no subscription.

---

🚀 Быстрый старт / Quick start

1. Скачай MiniLabKeyDeck.exe — установка не нужна.
2. Подключи MiniLab (или другой MIDI-контроллер) по USB.
3. Открой приложение → выбери профиль игры → нажми «Запустить маппинг» → играй.

💡 Если в игре нажатия не проходят — запусти игру и приложение от имени администратора (нужно для игр с анти-читом).

---

🎛 Возможности / Features

	Функция	Описание
🎯	Маппинг любой клавиши	Каждой клавише/пэду — своя кнопка на клавиатуре (или комбо shift+a). Режимы Hold (держится для длинных нот) и Tap (быстрый тык).
🎓	MIDI-Learn	Нажал контрол на устройстве → назначил клавишу. Работает с любым MIDI-контроллером.
🎚	Velocity-зоны	Одна нота шлёт разные клавиши по силе нажатия: слабо → одна, сильно (выше порога) → другая.
🎛	Крутилки, фейдеры, pitch/mod	Назначай на колесо мыши, системную громкость или клавиши по направлению (вправо/влево).
🎹	Индикатор октавы	Показывает активную октаву MiniLab в реальном времени: подсвечивает активные клавиши, прокручивает пианино, метка диапазона.
💡	Светомузыка на пэдах	RGB-пэды реагируют на звук с ПК: бегущая радуга, разгон на басу, белые вспышки на хай-хетах.
🗂	Профили и пресеты	Готовые раскладки: Fortnite Festival (4/5 линий), osu! mania (4K), osu! (Z-X), Clone Hero. Переключение мгновенно, свои профили — без ограничений.
🖥	Трей + глобальный хоткей	Сворачивается в трей (MIDI работает фоном). Ctrl+Alt+M — вкл/выкл маппинг откуда угодно, даже прямо в игре.
🌍	6 языков	Русский, English, Українська, Deutsch, Español, Français — интерфейс и обучение.
💾	Надёжное сохранение	Все изменения пишутся атомарно — данные не теряются при краше/выключении ПК.
🎬	Анимации	Плавный запуск и анимация закрытия. Обучение из 13 шагов при первом запуске.

---

🎹 Поддерживаемые устройства / Supported devices

• Arturia MiniLab 3 — полная поддержка: 25 клавиш, 8 RGB-пэдов (светомузыка), крутилки/фейдеры, pitch/mod, индикатор октавы.
• Любой MIDI-контроллер — клавиши, пэды, CC-контролы маппятся через MIDI-Learn. Пианино в приложении покрывает весь диапазон (годится и для 88-клавишных).

Светомузыка на пэдах реализована для MiniLab 3 (Arturia SysEx). Маппинг клавиш работает с любым MIDI-устройством.

---

🧩 Как назначать / How to assign

Клавиши и пэды: кликни пэд/клавишу на экране (или MIDI-Learn → нажми контрол на устройстве) → нажми клавишу, что используется в игре → выбери Hold/Tap → Сохрани.

Velocity-зоны: в окне назначения включи «Разные клавиши по силе нажатия», задай вторую клавишу и порог.

Крутилки/фейдеры/pitch: MIDI-Learn → покрути контрол → выбери действие: Клавиши (вверх/вниз), Колесо мыши или Громкость.

Пример (Fortnite Festival, 5 линий):

Контрол	→ Клавиша
Клавиши/пэды 1–5	D F J K L
Пэд овердрайва	Space

---

💡 Светомузыка / Light show

Нажми «Светомузыка на пэдах» — 8 RGB-пэдов оживают под звук с ПК:

• 🌈 бегущая радуга по пэдам,
• 💥 разгон радуги на бас-удар,
• ⚪ белые вспышки на хай-хеты,
• 🔈 авто-подстройка под громкость.

Работает одновременно с маппингом — играешь и пэды переливаются.

---

🛠 Сборка из исходников / Build from source

python -m venv .venv
.venv\Scripts\pip install numpy soundcard pygame pywebview pystray pillow pyinstaller

.venv\Scripts\pyinstaller --onefile --windowed --name "MiniLab Key Deck" --icon app_icon.ico ^
  --add-data "web;web" ^
  --collect-all pygame --collect-all soundcard --collect-all webview ^
  --collect-all clr_loader --collect-all pystray ^
  --hidden-import webview.platforms.winforms --hidden-import clr app.py

⚙️ Как устроено / Tech notes

• Движок — Python; интерфейс — HTML/CSS/JS в Edge WebView2 через pywebview. Всё в одном процессе.
• Ввод MIDI — pygame.midi; вывод на пэды — Arturia SysEx (F0 00 20 6B 7F 42 02 01 16 …).
• Впрыск клавиш — scancode SendInput (видят игры/анти-чит как настоящую клавиатуру), колесо/громкость — mouse/media SendInput.
• Захват звука — WASAPI loopback (soundcard) + FFT/onset (numpy). Трей — pystray. Глобальный хоткей — RegisterHotKey.
• Профили/настройки хранятся в %APPDATA%\MiniLab Key Deck (атомарная запись).

---

💜 Поддержать проект / Support

Проект бесплатный. Если он тебе помог — можно поддержать автора криптой TON (Toncoin):

UQAK1sIJqPVn9ND8JTOEUlrBFyAiVU0j6IiiXczTM7YmX4CB

💎 Отправить TON →

---

👤 Автор и права / Author & rights

Автор: Оськин Даниил Андреевич · Universe Music Records

© Все права защищены. Переработка, изменение и распространение — только по согласованию с автором-разработчиком.

• ✈️ Telegram: @universemusicrecords
• ✉️ Email: doskin50@gmail.com

Понравилось? Поставь ⭐ — это помогает другим найти проект.

_{MiniLab Key Deck © Universe Music Records · Arturia и MiniLab — товарные знаки Arturia. Fortnite — Epic Games. Проект не аффилирован с Arturia или Epic Games.}