Skip to content

Director 2.0.0

Latest
Latest

Choose a tag to compare

View all tags
@EnZhm EnZhm released this 29 Oct 17:46
2.0.0
cc5bd6b

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

Assets 5
Loading