Black Magik Studios Documentation

Sigil

Sigil Overview

Start here for Sigil's core workflow, main views, and first-session setup.

Sigil Overview

Sigil is Black Magik’s local AI MIDI composition tool for retro game music. You build songs from reusable patterns, arrange bars across tracks, shape the sound with instruments and effects, and use local generation when you want fresh melodies, bass lines, harmony, drums, infill, or continuation material.

The workflow is designed for music you own and can finish: set the musical rules, build the track list, sketch the arrangement, generate where useful, edit every result in the piano roll, preview loops with SoundFont playback, then export game-ready MIDI or audio.

Sigil full UI

Sigil generate ideas workflow


Main Areas

Area Purpose
Song Overview Arrangement grid where tracks and bars are organized.
Piano Roll Note editor for the selected pattern.
Velocity Lane Per-note loudness and accent editing.
Transport Bar Play, stop, loop, metronome, undo, save, export, marquee mode, and quick edit controls.
Project Tab Key, scale, tempo, bars, loop, pitch range, groove, metronome, soundfont, and note defaults.
Instruments Tab Track setup, instruments, mixer controls, per-track groove, soundfont overrides, effects, automation, and modulation.
Generation Tab Local AI controls for generating, filling, or continuing MIDI.
Notepad Tab Rich-text project notes for lyrics, arrangement plans, and reminders.

Sigil song overview and track arrangement workflow Song overview, piano roll, and side-panel workflow


First Session Checklist

  1. Open File > New Blank Project, or choose a template from File > Templates.
  2. Use the Project tab to set tempo, key, scale, time signature, and song length.
  3. Use the Instruments tab to add tracks, name them clearly, and choose General MIDI instruments or drum kits.
  4. Click a cell in the Song Overview to select a pattern.
  5. Draw notes in the Piano Roll.
  6. Press Space to play or stop.
  7. Use the Generation tab when you want the AI to create, fill, or continue music.
  8. Save with Ctrl+S and export from the transport bar when finished.

What Persists

  • Project files keep the tempo, key, scale, time signature, tracks, patterns, notes, automation, effects, and notepad content.
  • Reused patterns stay linked across the song until you make a unique copy.
  • Generation history keeps recent AI results so you can compare takes before committing to one.
  • Preferences keep audio, theme, generation, recovery, and shortcut settings between sessions.

Good Habits

  • Start with a short loop, usually 4 or 8 bars, so you can iterate quickly.
  • Name tracks clearly before generating. Track identity and instrument setup both feed the model useful context.
  • Save a copy before large generation experiments.
  • Use the Notepad for arrangement plans, sound direction, lyrics, and cleanup tasks.
  • Treat AI output as draft material, then tighten timing, voicing, and dynamics manually in the piano roll.

System Requirements

Platform Requirements
Windows 10 / 11 (64-bit) Currently supported. Requires a 64-bit Intel or AMD processor, 8 GB RAM minimum, 16 GB RAM recommended for larger projects and smoother local AI generation, 3 GB free disk space, and a Windows-compatible audio output device.
macOS Coming soon.
Linux Coming soon.