preferences.yaml¶

preferences.yaml allows you to customise various settings of the zcx script.

two levels of preferences¶

At the root of your zcx installation is a file _global_preferences.yaml. Inside your _config folder, you may create the file preferences.yaml.

As zcx allows per-set configs, the purpose of having multiple files is to allow you to have certain preferences across all of your configs, and expand or modify those preferences per-config. If you only use one zcx config, you may choose to use either of these files.

preference reference¶

Each of these headings represents a top-level yaml entry.

configs¶

Allows you to configure per-set configs.

This setting must be set in _global_preferences.yaml

configs:
  - config: dj
    pattern: dj_set

  - config: solo_set
    pattern: >
      [solo]

  - config: mixing
    pattern: MIX

session_ring¶

session_ring:
  width: 8
  height: 8

Sets the dimensions of the session ring. You may disable the ring by setting one or both of width and height to 0.

inital_hw_mode¶

initial_hw_mode: zcx

Options:

zcx - When zcx loads, switch the device to user mode.
live - Do not attempt to take control of the hardware on set load.

plugins¶

plugins:
  plugin_name:
    plugin_option_1: true
    plugin_option_2: false

Consult the documentation of your plugin to see the available options. If the plugin came with zcx you will find this information in the hardware reference for your controller.

log_level¶

logging: info

Configures how detailed the zcx logs are. From most to least detailed, the options are:

debug
info
warning
error
critical

load_hardware_plugins¶

load_hardware_plugins: true

Determines whether any hardware-specific plugins (located in zcx/hardware/plugins) will be loaded.

load_user_plugins¶

load_user_plugins: true

Determines whether any user plugins (located in zcx/plugins) will be loaded.

action_log¶

action_log: true

When set to true, all triggered ClyphX Pro action lists will be logged.