Director 2.0.0

The music drives the picture. Director 2.0.0 is one repository, one version and one zip for four OBS Studio plugins that share a single beat clock.

DJ mix -> Music Director (the clock) -> Palette Director (palette)
                                     -> Clip Director    (video clips)
                                     -> Scene Director   (MIDI Next / Prev -> Synesthesia playlist)

On every breakdown and drop, the palette change, the clip cut and the Synesthesia Next land on the same beat.

The four plugins

Plugin	Role
Music Director (new, required)	Analyses the mix and runs the only clock: BPM, beats, phrases, breakdown and drop. Includes the Music dock (Tap, Lock BPM, Nudge, Phrase now, Drop now, Force breakdown) and MIDI Director, which maps a controller to any OBS hotkey.
Palette Director	The Palette Lock filter recolours the picture with palette sets and changes palettes on the clock.
Clip Director	Plays folders of clips and cuts them on the clock. Breakdown and drop clips are armed ahead, so the cut lands on the section beat.
Scene Director	Sends Synesthesia playlist Next / Prev over MIDI out on breakdowns, drops, buttons and hotkeys.

Palette, Clip and Scene Director require Music Director. Without it they idle safely and their dock reads "Waiting for Music Director".

Install or upgrade (Windows x64, OBS Studio 32.2.x)

1. Close OBS.
2. Upgrading from 1.x: delete palette-director, clip-director and scene-director from C:\ProgramData\obs-studio\plugins\.
3. Unzip director-2.0.0-windows-x64.zip and copy its four folders (music-director, palette-director, clip-director, scene-director) into C:\ProgramData\obs-studio\plugins\.
4. Start OBS. The log shows plugin loaded successfully (version 2.0.0) once for each plugin.

What carries over from 1.x:

• Palette Lock filters, palettes and sets load exactly as saved.
• On first load, Music Director takes the audio settings (audio source, gain, kick sensitivity, fallback BPM and phrase length) from the first enabled Palette Lock filter that has an audio source, and logs which one it used.
• Clip Director sources load unchanged.

Full steps are in INSTALL.txt, which is attached and also inside the zip.

Synesthesia: MIDI-learn Next and Prev

1. Add a Scene Director source. In its dock, pick your virtual MIDI port as MIDI out (MIDI out > Rescan > the port).
2. In Synesthesia's MIDI settings, enable that port as a MIDI input.
3. In Synesthesia's MIDI mapping, MIDI-learn the playlist's next control and press Next in the Scene Director dock. Do the same for previous with Prev, then save the mapping.

Breakdowns and drops then send Next by themselves. Automatic section changes respect a 16-beat cooldown. Forced sections and manual Next / Prev always go through.

Known limitations

• Memory: Clip Director keeps five decoders (live, spare and three armed clips) so section cuts land on the beat. It uses more memory than Clip Director 1.1.
• MIDI controller hardware: MIDI Director has not yet been tested with a physical controller. The MIDI out to Synesthesia is verified.
• Unsigned build: the DLLs are not code-signed. Check them against SHA256SUMS.txt.

Checksums

director-2.0.0-windows-x64.zip sha256 5b99a863db5152bac179f0457fb6dcbdce5240b5fd7090da5df197edc3494349. Per-file checksums are in SHA256SUMS.txt inside the zip.

Replaces

EnZhm/palette-director 1.2.0, EnZhm/clip-director 1.1.0 and EnZhm/scene-director 2.0.0. Those repositories are archived and their releases stay available. The tag 1.1.0 in this repository marks a playlist-only suite that was never released.

Changelog: CHANGELOG.md

Director 1.1.0

Director 1.1.0: beat-synced palettes and a Synesthesia playlist that switches on the beat, for OBS Studio 32.2.x on Windows x64.

Component	Version
Palette Director	1.2.0
Scene Director	2.0.0 (formerly Clip Director)

What's new

• Scene Director 2.0.0 replaces Clip Director 1.1.0. It follows Palette Director's beat clock and sends MIDI Next / Previous to a virtual MIDI port: the Synesthesia playlist moves at the start of a breakdown and on the drop downbeat, and by hand from the dock or a hotkey. Clip playback and the OSC control are gone (see the Scene Director 2.0.0 notes).
• Palette Director 1.2.0: the Music dock (tap tempo, Lock BPM, nudge, Phrase is now, Drop now, Force breakdown) and the matching hotkeys.

Install

1. Close OBS.
2. If Clip Director is installed, delete C:\ProgramData\obs-studio\plugins\clip-director (Scene Director registers the same source id, and your scene collection keeps loading).
3. Unzip director-1.1.0-windows-x64.zip and copy palette-director and scene-director into C:\ProgramData\obs-studio\plugins\.
4. Start OBS. The log shows [palette-director] plugin loaded successfully (version 1.2.0) and [scene-director] plugin loaded successfully (version 2.0.0).

Synesthesia MIDI learn

1. Install a virtual MIDI port (loopMIDI) and pick it under MIDI out in the Scene Director dock; the link chip turns green.
2. In Synesthesia, enable that port as a MIDI input, enter MIDI learn on the playlist's next control and press Next in the dock; repeat with Prev on previous, then save the mapping.
3. Defaults: Next = note 60, Prev = note 59, channel 16. On the next breakdown and the next drop the playlist moves by itself.

Quick start and requirements: README. Step by step: INSTALL.txt (also inside the zip).

Checksums

7828c1c39024d62d2a9745e4acef6c03383c234dbd48b88acf76def72fbcd8d3  director-1.1.0-windows-x64.zip

SHA256SUMS.txt inside the zip covers every file. The two plugin folders are the released Palette Director 1.2.0 and Scene Director 2.0.0 packages, unchanged; this combination was installed and soaked on the show rig with a real scene collection before release.

Known limitations

• The MIDI Director dock has been exercised without a hardware MIDI controller attached; Scene Director's MIDI out has been verified on a loopMIDI virtual port.

Director 1.0.0

Director 1.0.0: beat-synced palettes, clips and Synesthesia scenes for OBS Studio 32.2.x on Windows x64.

Component	Version
Palette Director	1.2.0
Clip Director	1.1.0

Install

1. Close OBS.
2. Unzip director-1.0.0-windows-x64.zip and copy palette-director and clip-director into C:\ProgramData\obs-studio\plugins\.
3. Start OBS. The log shows [palette-director] plugin loaded successfully (version 1.2.0) and [clip-director] plugin loaded successfully (version 1.1.0).

Quick start and requirements: README. Step by step: INSTALL.txt (also inside the zip).

Checksums

b4b210b0ea763834cb1eb017306fe0fcedf397eb9f386f4baf7c411b19a73ce5  director-1.0.0-windows-x64.zip

SHA256SUMS.txt inside the zip covers every file; the two plugin folders are the CI-built Palette Director 1.2.0 and Clip Director 1.1.0 packages, unchanged.

Known limitations

• The Synesthesia OSC round trip has not yet been verified on hardware; the Scene lead default is 0 ms until scene-load latency is measured (a fix release follows). MIDI Director has been exercised idle only, without a MIDI device attached.