Voynich MIDI Sequencer (Tk)

Přehled & Pozadí

Voynich MIDI Sequencer je originální monolitická aplikace navržená pro vytváření MIDI sekvencí se zaměřením na:

• Rychlého experimentování: Step sequencer grafické rozhraní pro intuitivní MIDI editaci
• Algoritmickou generaci: Randomizátor, kombinovací engine, humanizátor
• Multi-track sekvenčování: Vizuální gridový editor s 1–32+ stopami
• Real-time playback: MIDI output přes pygame.midi backend
• Flexibilní správu knihoven: Ukládání, načítání, export MIDI souborů

Status aplikace (2026-02): Toto je legacy referenční implementace Voynich MIDI Sequenceru. Zatímco modernizovaný Qt port je ve vývoji, tato verze zůstává plně funkční, stabilní a slouží jako primární zdroj dat pro migrační procesy.

Cílová použití: Návrh bicích vzorů, melodické fráze, basové linie, harmonické progrese, edukační sekvenčování, archivace groove šablon.

Účel & Scénáře Use-Case

Voynich MIDI Sequencer je optimalizován pro:

1. Návrh bicích vzorů s swing/groove feelem
2. Melodické fráze a harmonické progrese
3. Basové linie a funkční groovy
4. Explorativní kompozici s algoritmickou generací
5. Edukační sekvenčování a učení MIDI
6. Archivaci groove šablon a reuse vzorů
7. Vytvoření MIDI mockup/reference skladby

Klíčové vlastnosti

Editace patternů

• ✓ Multi-track gridový editor (1–32+ stop)
• ✓ Volně nastavitelné délky vzorů (8–256 kroků)
• ✓ Velocity noty na krok (0–127)
• ✓ Swing + humanizátor
• ✓ Transpozice, accent, program change
• ✓ Undo/Redo stack

Generování vzorů

• ✓ Randomizátor (hustota, spread, seed)
• ✓ Kombinovací engine (union, intersection, mutation)
• ✓ Humanizátor (swing, velocity, note length variation)

Playback & kontrola

• ✓ Real-time MIDI playback (pygame)
• ✓ Výběr MIDI zařízení
• ✓ Tempo 2–480 BPM
• ✓ Play/Stop/Pause + metronome
• ✓ Record mode + live monitoring

Soubor & persistence

• ✓ Ukládání vzorů (JSON)
• ✓ Export do MIDI (.mid)
• ✓ Drag-and-drop import
• ✓ Auto-save (30s interval)
• ✓ Recovery system

Uživatelské rozhraní

Hlavní okno:

• Menu bar (File, Edit, View, Tools, Patterns, Help)
• Toolbar (BPM, Swing, Quantize, Play, Stop, Pause, Metronome)
• Grid editor (pattern vizualizace, step editing)
• Library sidebar (pattern management)
• Status bar (playback info, step counter, time)
• Output meter (L/R peak level visualization)

Persistence & Export

• Projekt soubor: projekt.voynich (JSON + metadata)
• Auto-save: 30 sekund interval
• Recovery: Backup systém na startup
• MIDI Export: Standard SMF (.mid)
• CSV Export: Tabular formát

Workflow scénáře

Scénář 1: Kick Drum Pattern

Scénář 2: Kombinování patternů

Klávesové zkratky

• Ctrl+N: Nový projekt
• Ctrl+O: Otevři projekt
• Ctrl+S: Uložit
• Ctrl+Z: Undo
• Ctrl+Y: Redo
• Spacebar: Play/Pause
• U/D: Transpozice
• M: Mute | S: Solo
• Delete: Smaž vzorek
• F1: Help

Troubleshooting

Aplikace se nespustí

• Zkontroluj Python 3.8+
• Instaluj dependencies:

Bez zvuku

• Tools → MIDI Device Selection → vyber dostupné zařízení
• Fallback: FluidSynth (internal synth)

Playback se zastaví

• MIDI buffer overflow: Zkus omezit počet stop (16 → 8)
• CPU overload: Zavři další aplikace, snížit BPM
• Restart aplikace

Projekt se neuloží

• Zkontroluj místo na disku
• Zkontroluj oprávnění k zapsání
• Smaž corrupted backup file

FAQ

Q: Mohu si Voynich MIDI Sequencer upravit?

Ano! Je Open Source. Kód je v `/BONUS_TOOLS/MIDI_SUITE/VMS/`. Můžeš ho klonovat, forkovat, upravit a distribuovat dle licence Bazooka_CZ.

Q: Jak exportuju projekt do DAW?

File → Export MIDI → [ Save As ]. Soubor `.mid` můžeš otevřít v jakémkoliv DAW-u (FL Studio, Ableton, Reaper, ...).

Q: Jak sdílím pattern soubory?

Pattern soubory jsou JSON `.data` formátu — můžeš je poslat emailem nebo přes cloud. Příjemce je načte přes File → Open Pattern.

Q: Jaká je maximální délka sekvence?

Teoreticky neomezená (limituje jen RAM). Prakticky max. 256 kroků na vzorek, max. 32 stop. MIDI je limitován na 16 kanálů.

Q: Je Voynich kompatibilní s hardwarovými kontroléry?

Aktuálně ne — jenom MIDI výstup. Hardware input support je plánován pro budoucí verzi.

Q: Kde jsou uloženy moje projekty?

Defaultně v pracovním adresáři. Můžeš si ho změnit v File → Preferences → Set project directory.