- C++ 95%
- PowerShell 3.1%
- CMake 1.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| Assets | ||
| Scripts | ||
| Source | ||
| .clang-format | ||
| .gitattributes | ||
| .gitignore | ||
| ARCHITECTURE.md | ||
| BUILD.md | ||
| CMakeLists.txt | ||
| CMakePresets.json | ||
| HANDOFF.md | ||
| LICENSE | ||
| LICENSES.md | ||
| PARAMETERS.md | ||
| PRESET_COOKBOOK.md | ||
| QUICKSTART.md | ||
| README.md | ||
NEURO//LAB
Standalone-first neuro bass synthesizer. Source delivery, version 0.1.0.
Старт на Windows
Распакуйте весь архив непосредственно в D:\projects\neurolab: CMakeLists.txt должен оказаться в корне этой папки. Откройте папку в VS Code, Visual Studio или локальном coding agent.
Нужны Visual Studio 2022 с Desktop development with C++, MSVC v143 и Windows SDK, CMake 3.22+, Git. Первый configure скачивает фиксированный JUCE 8.0.16-security. Python, Node.js и DAW не нужны.
Set-Location D:\projects\neurolab
powershell -NoProfile -ExecutionPolicy Bypass -File .\Scripts\build-windows.ps1
& .\build\NeuroLab_artefacts\Release\Standalone\NEUROLAB.exe
После локальной сборки: выберите THROAT ENGINE, поставьте C2 и нажмите HOLD NOTE. Начинайте с низкой громкости колонок/наушников. Крутите четыре макроса; назначения находятся на странице MATRIX. PANIC немедленно останавливает внутреннее исполнение и сбрасывает голоса.
Статус проверки: реальная DSP-библиотека успешно собрана через CMake/Ninja/GCC 14.2 в Linux. Полное приложение JUCE и Windows EXE здесь не собраны и не запускались. Звук и заводские патчи не прослушивались. Попытка полного configure остановилась на DNS-ошибке скачивания JUCE. Перед первым использованием требуется локальная сборка; возможные ошибки интеграции JUCE/MSVC ещё не исключены. Это исходный MVP, не подтверждённый готовый бинарный релиз.
What is implemented in the source
| Area | Implementation |
|---|---|
| Oscillators | Two original interpolated wavetable oscillators, four classic shapes plus eight complex families, eight frames per family, nine band-limited mip levels, up to four unison lanes per oscillator |
| PM / sub | Genuine oscillator-B-to-A phase modulation, independent B audible level, separately mixed mono sine/triangle sub, root or one octave down |
| Voices | Last-held-note mono mode, legato, exponential glide, eight-voice polyphony, velocity, sustain, pitch bend, mod wheel, three ADSRs |
| Character | TPT LP12/LP24/HP12/BP/notch, extra sweeping notch, fractional-delay comb, three-resonator A/E/I/O/U formant bank |
| Distortion | Two six-algorithm stages, drive/mix/output/bypass, routable first stage, whole-engine 2x oversampling, DC removal, final linked peak protection |
| Modulation | Four free/synced LFOs, seven shapes, phase/polarity/retrigger, editable 16-step shapes, 16 modulation slots, four renameable multi-destination macros |
| Playing | Mouse/typing piano, HOLD NOTE, PANIC, BPM, standalone 16-step sequencer with note/gate/velocity, native audio/MIDI settings |
| GUI | Graphite/cyan/amber controls, five pages, numerical entry, tooltips, modulation dots, scrolling at smaller sizes, output meter, oscilloscope and GUI-thread spectrum |
| Presets | 24 complete factory JSON states in six categories; embedded resources, previous/next/category browser, editable user presets, current-state persistence |
| Build | One processor/editor/DSP for NeuroLab_Standalone and NeuroLab_VST3; optional reusable NeuroLabDSP library |
All 260 parameter values, LFO steps, 16 routes, macro names and sequencer settings belong to each patch. No sampled bass recordings or external licensed wavetable packs are used.
Factory collection
| Category | Presets |
|---|---|
| Reese / Detuned | IRON REESE, DARK CURRENT, RUSTED MOTOR, DRIFT CHAMBER |
| Wobble / Rhythmic | CONCRETE EIGHTHS, TRIPLET GRINDER, SWITCHBLADE, BROKEN PULSE |
| FM / Growl | THROAT ENGINE, JAW CRUSHER, ACID GARGLE, FM LEVIATHAN |
| Talking / Vocal | VOWEL BEAST, RUBBER MOUTH, RADIO SNARL, YOI MACHINE |
| Metallic / Robotic | CHROME TEETH, SERVO CLASH, RAZOR COMB, STEEL MUTATION |
| Rolling / Experimental | PISTON ROLLER, TECHSTEP PUNCH, GLIDE RUNNER, FRACTURE MUTATION |
The recipes are distinct authored synthesis configurations, not auditioned commercial sound-bank masters. Exact routes, macro depths and recommended notes are in PRESET_COOKBOOK.md.
Source map
Source/
PluginProcessor.* JUCE audio/MIDI adapter, parameters, state and performance commands
PluginEditor.* Browser, shared instrument UI and standalone settings access
Parameters/ Stable IDs, ranges, labels and modulation destinations
DSP/
Oscillators/ Original additive wavetable generation and interpolation
Voices/ PM, unison, envelopes, per-voice signal path
Filters/ TPT filters, comb and formant bank
Distortion/ Six nonlinear algorithms and stage smoothing
Modulation/ ADSRs, LFOs and 16-slot routing
SynthEngine/ Note allocation, MIDI, sequencer, 2x decimation, output protection
Presets/ Versioned JSON, factory resources and user file storage
GUI/ Components, industrial LookAndFeel, scope/spectrum
Utilities/ Fixed-capacity UI MIDI queue and atomic meter data
Assets/Presets/Factory/ 24 editable source JSON files, embedded when building
Assets/Wavetables/ Explanation of runtime-generated original waveform resources
Scripts/ Windows build and package commands
Read QUICKSTART.md to play, BUILD.md to compile, ARCHITECTURE.md to modify DSP, PARAMETERS.md for IDs and HANDOFF.md before passing the project to the local coding agent. Licensing and redistribution are addressed separately in LICENSES.md.
There is intentionally no Tests directory, CI workflow, test harness, offline renderer or WAV preview archive.