Skip to content

Speqmo/FestFx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FestFx VJ Controller

Become a VJ - (or let the computer take over)

With FestFx, you can control LED strips and lights live, like a VJ - something LedFx isn’t really suited for. FestFx is designed to act as a bridge between LedFx and countless integrations, enabling greater control over things like: presets (e.g. choosing your own color instead of using the one stored in the preset), more advanced auto play modes (playing effects based on music segments like verse, build-up, and chorus), and other extended functionalities.

The aim is to develop an advanced, VJ-worthy interface that can be controlled by anyone and supports both manual and (semi-)automatic control. The interface is designed for tablets but can also be used via smartphones, Zigbee controllers, MIDI controllers, and more.

What you need

FestFx was developed for Home Assistant because it’s a stable system that allows fast development and offers countless built-in options to connect different systems. This enables endless functionality — for example, automatically changing light colors based on the album art of the current track. All you need to use FestFx is Home Assistant and LedFx.

  • Home Assistant can be easily installed on a wide range of devices: Home Assistant’s own hardware, Raspberry Pi, macOS, Windows, ODROID, Generic x86-64, Linux, and more.

  • LedFx is an awesome piece of software that actually controls the lights - synced to the music! - and is just as easily installed on a computer or Raspberry Pi.

Manual

Below you can find an image of the interface and explanations of some controls. The current version is stable and serves as a concept to explore the feasibility of our plans. In the short term, the interface will be improved and new features will be added. The colors indicate the type of control: red (slider), green (toggle), blue (select).

Live lights Preview lights (settings)

Header

  • Live effect name
  • Playlist: Start Auto Mode
  • Force: Prevent a [touch action] on an effect/Preset (do a [hold action] instead)
  • Live effect
  • Tabs: Switch between different modes

Main - Effects

  • Effects: [touch action] activate live, [hold action] preview/edit the effect

Main - Presets

  • Presets: [touch action] activate live, [hold action] preview/edit the preset
  • Save: Save mode, save current effect to a preset
  • Rename: Rename mode, rename a Preset
  • Playlist: Playlist mode, set a preset to 'verse', 'build-up' or 'chorus' for auto mode
  • Waves: Waves mode, always show playlist type
  • Current colors: When activating a preset, use the current color (in settings) instead of saved color
  • Current brightness: When activating a preset, use the current brightness (in settings) instead of saved brightness

Header

  • Preview effect name
  • Sync: Green if the preview/edditing == live
  • Direct: Changing a parameter is directly actived live mode
  • Launch: Activate preview settings to live
  • Preview effect
  • Quick colors: Color presets [touch] activate colors, [hold] save current colors to preset
  • (Background) Colors: Set colors (low, mid, high, color, color brightness, background, background brightness

Main

  • Parameters: Change effect parameters

Installation

  1. Install HACS: 'Vertical Stack In Card', 'Bubble Card', 'card-mod', 'browser_mod'
  2. Install Services: 'RESTful command', 'MQTT'
  3. Copy the repository files to HA '/config' folder
  4. Change text within the files:
    • The URL's in '/festfx/scripts_rest.yaml' and '/www/' files (LedFx API)
    • Add the following to your config file:
      rest_command: !include festfx/scripts_rest.yaml
      homeassistant:
        packages: !include_dir_named festfx
      
  5. Copy YAML from the dashboard file ('/config/festfx-dashboard/') into a new dashboard and apply the FestFx theme
  6. Restart HA