2,705
edits
Changes
Jump to navigation
Jump to search
Line 49:
Line 49: − + + + + Line 61:
Line 64: − + − + − + − When the '''Red Lightning''' or '''Red Thermometer''' flag is shown, your zynthian is working in a degraded state, with the CPU frequency capped to 600-800 MHz, trying to stabilize the system and avoid a system crash. You shouldn't see any of them and if you do so, you should consider looking for a better power source (under-voltage) or using a heat sink (over-temperature).+ − + + + − + − + − + Line 87:
Line 92: + + + + − + + + + + + + + + + + + + + + + + + + − Although the '''MIXER''' is shown in the layer list, it's not a real layer. This pseudo-layer allows to adjust the soundcard output/input levels and other audio-hardware related options. Technically speaking, it's a user interface for the ALSA (Audio Linux Sound Architecture) mixer.+ + + + + + + + Line 130:
Line 164: − + − + − + − + − + − + Line 150:
Line 184: − + − + Line 158:
Line 192: + + + + + + + + + + + + − * '''Effect List''' => The list of effects in the layer's FX-chain. By bold-clicking on an effect and you will access the Effect's Options:+ − ** '''Effect Presets''' − ** '''Move Upchain''' − ** '''Move Downchain''' − ** '''Remove Effect'''
Zynthian UI User Guide (oldstable-2109) (view source)
Revision as of 14:16, 2 April 2020
, 14:16, 2 April 2020→Layer List
* Recording Audio => '''Red Circle''' flag
* Recording Audio => '''Red Circle''' flag
* Playing Audio => '''Green Play''' flag
* Playing Audio => '''Green Play''' flag
The Audio Peak-meter is shown by default. The meter covers the range -50dBFS to 0dBFS, i.e. maximum permissible level at full scale (far right) down to 50dB below that at far left:
===The Peak-meter===
The Audio Peak-meter is shown by default. The meter covers the range -50dBFS to 0dBFS, i.e. maximum permissible level at full scale (far right) down to 50dB below (far left):
* The green segment covers the range -50dBFS to -10dBFS.
* The green segment covers the range -50dBFS to -10dBFS.
Alternately, CPU-load bar can be enabled from webconf, replacing the Audio Peak-meter. The CPU-load bar shows the CPU usage as calculated by the Jack Audio Server:
Alternately, CPU-load bar can be enabled from webconf, replacing the Audio Peak-meter. The CPU-load bar shows the CPU usage as calculated by the Jack Audio Server:
This is a running average of the time it takes to execute a full process cycle for all clients as a percentage of the real time available per cycle determined by the buffer size and sample rate.
This is a running average of the time it takes to execute a full process cycle for all clients as a percentage of the real time available per cycle determined by the buffer size and sample rate.
The '''Blue M''' flag is shown when MIDI messages pass thru the MIDI router. Not all messages are detected. Only CC, Program Change and Note On/Off.
===The Flags===
The '''Red Warning''' flag is shown when there are Xruns. You should hear clicks and pops too.
* The '''Blue M''' flag is shown when MIDI messages pass thru the MIDI router. Not all messages are detected. Only CC, Program Change and Note On/Off.
* The '''Red Warning''' flag is shown when there are Xruns. You should hear clicks and pops too.
Finally, the '''Red Circle''' and '''Green Play''' flags show the status of audio/MIDI capture: recording / playing
* When the '''Red Lightning''' or '''Red Thermometer''' flag is shown, your zynthian is working in a degraded state, with the CPU frequency capped to 600-800 MHz, trying to stabilize the system and avoid a system crash. You shouldn't see any of them and if you do so, you should consider looking for a better power source (under-voltage) or using a heat sink (over-temperature).
* Finally, the '''Red Circle''' and '''Green Play''' flags show the status of audio/MIDI capture: recording / playing
=Layers=
=Layers=
[[File:Zynthian_ui_mixer_layers.png|400px|right]]
[[File:Zynthian_ui_layers.png|400px|right]]
Layers are a key concept on Zynthian-UI: the first thing you do when you power-on your zynthian is create a layer.
Layers are a key concept on Zynthian-UI: the first thing you do when you power-on your zynthian is, probably, create a layer.
A layer is an '''Audio Processing Chain''', normally assigned to a MIDI channel, which can be composed of one or more Audio Processing Units. these units are chained by default, although you can customize the audio routing. The first unit in a layer is the '''root''' which determines the layer's type:
A layer is an '''Audio Processing Chain''', normally assigned to a MIDI channel, which can be composed of one or more Audio Processing Units. These units are chained in the same order they are created, but you can change the order from the '''Layer Options''' menu. The first unit in a layer is the '''root''' and it determines the layer's type:
* '''Synth Layer''' => Receives MIDI note-events and generate audio output.
* '''Synth Layer''' => Receives MIDI note-events and generate audio output.
All units in a layer receive all the MIDI events coming from the assigned channel. Some special layers (MOD-UI) don't have an assigned MIDI channel and receive all MIDI channels.
All units in a layer receive all the MIDI events coming from the assigned channel. Some special layers (MOD-UI) don't have an assigned MIDI channel and receive all MIDI channels.
You can always access the Layers screen from any place by:
* '''Bold-push''' on layer knob (CTRL-1)
<br clear=all>
<br clear=all>
=Mixer=
=Apps=
[[File:Zynthian_ui_apps.png|400px|right]]
The Apps menu allows to access special features like:
* '''Audio Recorder'''
* '''MIDI Recorder'''
* '''ALSA-Mixer'''
* '''Auto-EQ'''
There are several ways of accessing this menu:
* '''Long-push''' on snapshot knob (CTRL-3)
* From the Layers screen, '''short-push''' on snapshot knob (CTRL-3)
<br clear=all>
=ALSA Mixer=
[[File:zynthian_ui_mixer_control.png|400px|right]]
[[File:zynthian_ui_mixer_control.png|400px|right]]
The '''ALSA Mixer''' app is a pseudo-layer that allows to adjust the soundcard output/input levels and other audio-hardware related options. Technically speaking, it's a user interface for the ALSA (Audio Linux Sound Architecture) mixer.
For accessing the '''ALSA-Mixer''' app, you have several options:
* '''Long-push''' on the layer knob (CTRL-1)
* From the Apps menu:
** '''Short-push''' on the snapshot knob (CTRL-3)
** Select the '''ALSA-Mixer''' option from the menu
You can configure the mixer controllers from the webconf's hardware->audio menu. Simply click the '''+''' button on the "Mixer Controls" text area.
You can configure the mixer controllers from the webconf's hardware->audio menu. Simply click the '''+''' button on the "Mixer Controls" text area.
* '''NEW Synth Layer''' => Create a new Synthesizer Layer.
* '''NEW Synth Layer''' => Create a new Synthesizer Layer.
* '''NEW Effect Layer''' => Create a new Effect Layer that will be connected to soundcard's Audio Input.
* '''NEW Effect Layer''' => Create a new Effect Layer that will be connected to soundcard's Audio Input. You can route the audio from other layers to an Effect Layer.
* '''NEW Generator Layer''' => Create a new Generator Layer that self-generates audio or midi.
* '''NEW Generator Layer''' => Create a new Generator Layer that self-generates audio or midi.
* '''NEW Special Layer''' => Create a new Special Layer which will receive all MIDI channels.
* '''NEW Special Layer''' => Create a new Special Layer (MOD-UI, Pure Data, ...).
* '''REMOVE ALL''' => Remove all Layers (Root layers and its associated Effect-Chains), returning to the initial state.
* '''REMOVE ALL''' => Remove all Layers & Effects, returning to the initial state.
* '''PANIC! All Notes/Sounds Off''' => All notes and sounds are stopped abruptly by sending CC#123 and CC#120 to all channels.
* '''PANIC! All Notes/Sounds Off''' => Stop All Notes and sounds by sending CC#123 and CC#120 to all channels.
The last option, ''All Notes/Sounds Off'', can be triggered by bold clicking CTRL-1 (layer) from the layer screen (contextual action). You can trigger this actions from any point in the workflow by simply bold-clicking CTRL-1 twice. You can also add a ''panic-button'' to your zynthian using the extra pins from the AllInOne circuit or the Zynscreen. [[Adding Extra Switches|Read this for a detailed explanation about how to add a panic button to your Zynthian]].
The last option, ''All Notes/Sounds Off'', can be triggered by bold clicking CTRL-1 (layer) from the layer screen. So, you can trigger this action from any point in the workflow by simply bold-clicking CTRL-1 twice. You can also add a ''panic-button'' to your zynthian using the extra pins from the AllInOne circuit or the Zynscreen. [[Adding Extra Switches|Read this for a detailed explanation about how to add a panic button to your Zynthian]].
<br clear=all>
<br clear=all>
[[File:Zynthian_ui_layer_list_mixer.png|400px|right]]
[[File:Zynthian_ui_layer_list_mixer.png|400px|right]]
When you select '''NEW Synth/Effect/Generator Layer''', you create a new root-layer (first of a chain), choosing a free MIDI channel for it. You can create up to 16 layers (as many there are MIDI channels), each one having an independent effect-chain.
When you select '''NEW Synth/Effect/Generator Layer''', you create a new root-layer (first of a chain), choosing a free MIDI channel for it. You can create up to 16 layers (as many as MIDI channels), each one having an independent effect-chain.
Having several layers in the same MIDI channel is not allowed. If you want two or more layers playing unison (like being in the same MIDI channel), you should use the "Clone" feature, which allow you to bind several layers while keeping MIDI CCs and other MIDI messages (Program Change, Channel Pressure, etc.) independent.
Having several layers in the same MIDI channel is not allowed. If you want two or more layers playing unison (like being in the same MIDI channel), you should use the "Clone" feature, which allow you to bind several layers while keeping MIDI CCs and other MIDI messages (Program Change, Channel Pressure, etc.) independent.
If you bold-click the select switch over a layer from the list, the "Layer Options" menu will be displayed for the selected layer. This menu allows you to:
If you bold-click the select switch over a layer from the list, the "Layer Options" menu will be displayed for the selected layer. This menu allows you to:
* '''Clone MIDI to...''' => clone the '''layer's MIDI channel''' messages to other MIDI channels. Note that only note on/off, pitch-bending, and key-press messages are cloned, while the rest are kept independent (CC, channel-pressure, program change, ...)
* '''Clone MIDI to...''' => clone the '''layer's MIDI channel''' messages to other MIDI channels. Note that only note on/off, pitch-bending, and key-press messages are cloned, while the rest are kept independent by default (CC, channel-pressure, program change, ...). You can select what CC will be cloned by bold-clicking on the channel list.
* '''Transpose''' => transpose the '''layer's MIDI channel''' up and down, by semitones.
* '''Transpose''' => transpose the '''layer's MIDI channel''' up and down, by semitones.
* '''Audio Routing''' => route the '''layer's''' audio output to the available audio input ports, allowing to process the audio in any way you imagine. You can use this feature for creating your own customized/bizarre FX chains. If this is not enough for you, try MOD-UI engine with the MOD-UI web GUI.
* '''Audio Routing''' => route the '''layer's''' audio output to the available audio input ports, allowing to process the audio in almost any way you can imagine. You can use this feature for creating your own customized/bizarre FX chains. If this is not enough for you, try MOD-UI engine with the MOD-UI web GUI.
* '''MIDI chan''' => change the MIDI Channel assigned.
* '''MIDI chan''' => change the MIDI Channel assigned.
* '''Remove Layer''' => Remove the layer.
* '''Remove Layer''' => Remove the layer.
* '''Add Effect''' => Add an effect to the FX-chain.
* '''Add Effect''' => Add an effect to the FX-chain.
* '''Remove All Effects''' => Clean the FX-chain, deleting all the effects.
* '''Remove All Effects''' => Clean the FX-chain, deleting all the effects.
* '''Effect List''' => The list of effects in the layer's FX-chain.
<br clear=all>
[[File:Zynthian_ui_layer_effect_options.png|400px|right]]
By bold-clicking on an effect from the list, you will access the Effect's Options:
* '''Replace Effect'''
* '''Effect Presets'''
* '''Move Upchain'''
* '''Move Downchain'''
* '''Remove Effect'''
Note that not all these options will be available all the time. For instance, if there is only one effect in the chain, "Move" options won't be shown.
<br clear=all>
<br clear=all>