View source for Zynthian UI User's Guide - Oram

{{VersionBar}}

==Introduction==

==Basic concepts==
===Processors & Chains===
The fundamental building block of zynthian's sound architecture is the processor. A processor generates or manipulates audio or MIDI signals. Zynthian includes over 1000 processors to choose from.

Processors are grouped together and interconnected within '''''chains'''''. Chains are a key concept in Zynthian. The first thing you will do after powering-on your zynthian for first time, once you stop celebrating your success, is creating a chain and adding some processors. It does little without any chains!

Processors may be positioned within the chain in series or in parallel with other processors. The quantity of series or parallel processors is only limited by available processing power. Audio signals coming out from chains feed a stereo mixer with typical mixer strip controls: fader, balance, mute, solo, phase reverse, etc. Audio processors may be positioned pre-fader or post-fader.

The audio and MIDI signals are routed between physical inputs, chain inputs, chain outputs and physical outputs. This provides a lot of flexibility whilst maintaining a simple, chain-based approach to signal routing.
<br>
<br>
[[File:Chains processors.png|An example of a chain|center]]

====Type of chains====
When you create a chain, you must choose a '''type''' for it:
<br>
* '''Synth Chain''' => Receives MIDI note-events and generate audio output. It must have a synth processor.
* '''Audio Chain''' => Receives audio-input and generates audio-output. It only has audio-FX processors.
* '''MIDI Chain''' => Receives MIDI-input and generates MIDI-output. It only has MIDI processors.
* '''MIDI + Audio Chain''' => Receives MIDI + Audio input and generates MIDI + Audio output. It has MIDI and audio-FX processors.
* '''Generator Chain''' => Generate audio output using an algorithm. The first processor is an audio generator.
* '''Special Chain''' => It can contains special processors, a MOD-UI pedalboard or a Pure Data patch. It can process audio and MIDI.
<br>
The chain's type can't be changed after creating the chain. Processors can be added, removed and positioned within the chain.

'''Synth and MIDI chains''' must have a '''MIDI channel''' assigned. MIDI channels are not exclusive, so you can assign the same MIDI channel to several chains.

In '''MIDI+Audio chains''', all audio processors in the chain receive all the MIDI events in the assigned channel. This is very convenient for some processors, like vocoder and auto-tune ones.

'''MIDI chains''' can be configured to receive '''all MIDI channels'''. This is specially useful when using zynthian as a MIDI router.

{{NoteBox|If Master MIDI channel is enabled (from webconf), it is excluded from the MIDI channels available for chain assignment.}}

<br clear=all>

===MIDI input===
Chains receive MIDI input from a set of devices (sequencers, keyboards and other MIDI controllers) that can be configured for each chain separately. Each input device can work in 2 different modes:

====ACTI mode==== 
When an MIDI input device is configured in ACTI mode, the '''active chain''' (the highlighted/selected chain) receives all MIDI input from it and all MIDI events are translated to the active chain's MIDI channel. It's the default mode for all input devices. When using ACTI mode you don't need to worry about the MIDI channel your keyboard/controller is using. You change the instrument you play by changing the active chain in your zynthian (see below). 

ACTI mode's behavior can be modified by the global flag '''Active MIDI channel''' ([[#blablabla|see admin menu]]):
<br>
* Active MIDI channel => '''Disabled''': Only the active chain receives MIDI input from the devices in ACTI mode. It's the default.
* Active MIDI channel => '''Enabled''': All chains with the same MIDI channel that the active chain receive MIDI input from the devices in ACTI mode. This is very useful for layering sounds without any extra routing. You simply create several synth chains, assigning the same MIDI channel to all of them and they will play unison. You can also create keyboard splits with by adjusting note range and transpose for each chain from the chain options menu.

====MULTI mode==== 
When an MIDI input device is configured in MULTI mode, only chains matching the device's MIDI channel will receive MIDI from the device. No MIDI channel translation is performed. MULTI mode allows receiving and managing separately every MIDI channel. Each MIDI controller drives the chains assigned to the controller's MIDI channel. If you are using an external sequencer or a MIDI controller that can sequence multiple tracks (Beatstep Pro, Keystep Pro, Novation Circuit etc.), you may want to use ACTI mode for it.

{{NoteBox|Note that MIDI CC (Continuous Controllers) events are handled differently and they are not routed to chains. See section on [[#MIDI-learning_.2F_binding|MIDI Learning & binding]].}}

===Signal workflow===
As introduced above, zynthian's signal workflow is based around chains of audio & MIDI processors that feed an audio summing mixer and external MIDI devices.

[[File:Zynthian Signal Flow.png|800px|center]]

<br clear=all>

===Snapshots===
A snapshot is the captured state of zynthian at the time of saving the snapshot. Snapshots are saved in a JSON file with ''.zss'' extension and can be loaded at any time, what effectively restores the state of the zynthian device when the snapshot was saved. Snapshots include:

* '''chains layout:''' for each chain, processors and how they are arranged
* '''chains configuration:''' MIDI channel, note-range, transpose, etc.
* '''processors state:''' bank, preset & parameter values for each processor
* '''mixer settings:''' fader, balance, mute, solo, etc. for each mixer strip
* '''audio levels''' (optional)
* '''MIDI devices configuration'''
* '''MIDI & Audio routing'''
* '''MIDI learning'''
* '''patterns & sequences'''
* '''some configuration options'''
* '''sub-snapshots (ZS3s)'''
* etc. 

Each time you overwrite an existing snapshot file, a backup copy is created. Backups can also be restored at any time, what can avoid much suffering. When you feel the panic, remember that zynthian stores the full ''save history'' for '''all''' snapshots!

{{NoteBox|Many zynthian users like to see snapshots as "zynthian project" files and it's not a a bad approach.}}

====Last state snapshot====
When zynthian starts, it always try to restore the last state saved on this snapshot. It always try to save the current state before performing some operations, like:

* power-off
* restart
* update
* clean all
* etc.

For convenience, the last state snapshot can also be saved or restored manually. 

===Sub-snapshots: ZS3===
ZS3 means '''Z'''ynthian '''S'''ub-'''S'''nap'''S'''hot. A ZS3 is a partial state that is stored in memory and can be recalled very fast. ZS3s can be easily associated (learned) to MIDI Programs (program change events). Of course, all ZS3s are saved/restored with snapshots.

ZS3s include:

* '''chains configuration:''' MIDI channel, note-range, transpose, etc.
* '''processors state:''' bank, preset & parameter values for each processor
* '''mixer settings:''' fader, balance, mute, solo, etc. for each mixer strip
* MIDI devices configuration
* MIDI & Audio routing
* MIDI learning
* some configuration options

The key concept to understand how ZS3s work is noting that '''chains layout is not stored in ZS3s'''. In other words, chain's layout is not modified when retoring ZS3s. You can't add/remove chains or processors by restoring ZS3s because this is a slow operation and ZS3s need to be restored very fast.

When loading a snapshots that contains ZS3s, all the chains and processors are created. Later, when recalling the ZS3s, chain's layout will remain the same. Although ZS3s can modify routing, splits, banks, presets, etc., the chains and processors will be the same all the time.

{{NoteBox|For instance, if you are keyboardist that plays with several bands, you could have a snapshot for each band and one or several ZS3s for each song.}}

<br clear=all>

==The physical interface==
===Description===

<div class="show_only_v5">
[[File:v5_render_zenital_mixer_leds.jpg|1024px|center]]

The V5 physical user interface is composed of:

* '''5x4 silicone push button grid with RGB-LED feedback'''
* '''5 inch display with capacitive touch'''
* '''4 infinite knobs (rotary encoders) with push switches'''

The 20 silicone push buttons and the 4 knobs with switches are the primary user input mechanism to navigate the UI:

* '''access the different views'''
* '''select options on menus and lists'''
* '''modify parameters'''

Each push button is engraved with a text legend or icon and backlit with RGB LED that gives status feedback. The knobs are numbered from top to bottom, so the top one is knob#1 and the bottom one is knob#4. We will refer knobs in this way throughout this guide.
</div>

<div class="show_only_v4">
[[File:v4_render_zenital_mixer.jpg|1024px|center]]

The V4 physical user interface is composed of:

* '''3,5 inch display with resistive touch'''
* '''4 infinite knobs (rotary encoders) with push switches'''
* '''4 silicone push buttons'''

The four knobs with switches are the primary user input mechanism to navigate the UI: 

* '''access the different views'''
* '''select options on menus and lists'''
* '''modify parameters'''
</div>

<div class="show_only_touch">
[[File:zynthian_barebones.png|800px|center]]

The barebones user interface is composed of a display with capacitive touch or mouse. A minimum display size of 5 inches is strongly advised when touch is the primary user input method.
</div>

===User interaction===
<span class="show_only_v4 show_only_v5">
Users interact with the system by pushing the silicone buttons or knob-switches or rotating the knobs. Touch can be used too for most operations and some interactions are only available from the touch interface, like the X-Y control ''ala kaos pad''.
</span>
<span class="show_only_touch">
Users interact with the system by touching/clicking the display elements and performing touch/mouse gestures, like horizontal or vertical swipes, pitch-zoom, etc.
</span>
User actions normally produce some feedback in the display. <span class="show_only_v5">Also, the V5's RBG LEDs give feedback and status info.</span>
</div>

===Types of push action===

There are 3 types of push actions that can be performed, depending on how long you hold down the button, knob-switch or display widget:

* '''short-push:''' Less than 0.3 seconds
* '''bold-push:''' Between 0.3 and 2 seconds
* '''long-push:''' More than 2 seconds (until the long-action is triggered!)

You can change the timings from the [[Web_Configuration_User_Guide#User_Interface|webconf's UI options tab]].
Not all buttons have actions assigned to all three push types. You can modify the assigned actions from the webconf tool, accessing the advanced options in the ''wiring layout'' section.

===Using the push buttons===
<div class="show_only_v5">
The V5 push buttons grid is divided in 5 groups:
<br>
<br>
'''<span style="color:#00D000;">View buttons</span>'''
[[File:v5_buttons_outlined.png|400px|right]]

View buttons are outlined on green in the image. Most of these buttons have 2 different functions assigned to them, with a horizontal line separating the two function labels. The primary function is printed at the top and the secondary function is printed at the bottom. The "metronome" button is the exception to this and has a single function assigned to it. Well, not exactly, as it's the Tap-Tempo button too (try it!).

LED color depends on current selection:

* when the primary function is selected, the button lights green.
* when the secondary function is selected, the button lights orange.
* when none of the button's functions are selected, the button lights blue.

A short-push on the button will:

* select primary function, when none of the button's functions is selected 
* select secondary function, when button's primary function is selected 

A bold-push on the button will always access the secondary function, not matter what is currently selected.

For instance, if you are in the mixer view and short-push the OPT/ADMIN button, the ''Chain'' menu will be opened. If you short-push it again, the ''Admin'' menu will be opened. Then, if you bold-push the MIX/LEVEL button, the ''Audio Levels'' view will be opened. You click "metronome" button and the ''Tempo'' view will be opened. If you tap-it several times, tempo will be adjusted, e.g. tap twice per second to set tempo to 120BPM.

View buttons are, from left to right and top to bottom:

[[File:v5_buttons_outlined-3-detail2.png|400px|right]]

* '''OPT/ADMIN''' 
** Options or Menu: Contextual. Click several times to reach the main menu.
** Admin menu
* '''MIX/LEVEL'''
** Mixer
** Audio Levels
* '''CTRL/PRESET'''
** Chain Control (Instrument)
** Preset/Bank
* '''ZS3/SNAPSHOT'''
** SubSnapShots (ZS3s)
** Snapshots
* '''METRONOME'''
** Tempo options / Tap-Tempo
* '''PAD/STEP'''
** Scene (ZynPad)
** Pattern
** Arranger => Keep pressed to open!

Some buttons have a tertiary function assigned to long-push:

* '''OPT/ADMIN''' => Long-push to power off.
* '''CTRL/PRESET''' => Long-push to enter/leave preset favorites
* '''PAD/STEP''' => Long-push to access Arranger
<br clear=all>

'''<span style="color:#D000D0;">ALT button</span>'''
[[File:v5_buttons_outlined-4.png|400px|right]]

The ALT button toggles the alternate function mode. When you click it, ALT button and buttons having an alternate function will change their default color from blue to purple. Currently only transport and custom buttons (F1-F4) have alternate function:

* '''Transport buttons''' will toggle between Audio Player/Recorder <span style="color:#0000F0">(normal)</span> and MIDI Player/Recorder <span style="color:#D000D0">(alternate)</span>.
* '''Customizable F1-F4 buttons''' will toggle between Program Change 1-4 <span style="color:#0000F0">(normal)</span> and Program Change 5-8 <span style="color:#D000D0">(alternate)</span>, so you can use it for easily learning and recalling up to 8 subsnapshots (ZS3s).
<br>

'''<span style="color:#F00000;">Transport buttons</span>'''<br>
By default, transport buttons control the '''global audio recorder/player''' and default color is blue. When "ALT" button is pushed (ALT mode enabled), transport buttons control the '''MIDI recorder/player''' and default color is purple.

* '''short-push the record button''' (solid circle) to start/stop a recording. When a recording is in progress, the record button lights red and you should also see the rec icon in the display status area, at top-right.

* '''short-push the play button''' (solid triangle) to play/pause the currently selected track. The last recorded track is selected by default. When a track is being played, the play button lights green. After pausing, pushing again will resume the playing in the point it was paused.

* '''bold-push the play button''' to open the track list. After selecting a track, the audio player control view will be shown.
 
* '''short-push the stop button''' (solid square) to stop playing a track and rewind. Pushing play again will start playing from the beginning.

* '''bold-push the stop button''' to stop all sounds, including any audio/midi track and sequences.

In some views, transport buttons have specific (contextual) functionality. When this happens, they will light orange to help you to remember their normal behavior is altered. The views that have specific transport functionality are:

[[File:v5_buttons_outlined-3-detail.png|400px|right]]
'''Pattern editor view'''<br>
From pattern editor , transport buttons are used to control pattern recording/playing. Note that for recording a pattern, you may want to start playing before recording, so notes are captured live in the time grid. If not, notes are captured step by step. While recording, pressing the back button may be used to undo the last recording.

'''Zynsampler control view'''<br>
From the control view of any zynsampler processor, transport buttons are used to control the processor's recording/playing functions (instead of the global audio recorder/player).

From all other views, transport buttons behave normally as explained above, controlling global audio recorder/player or MIDI recorder/player (ALT mode).
<br>
<br>

'''<span style="color:#F0C000;">Navigation buttons</span>'''<br>
Navigation buttons are used for basic navigation:

* '''Up/Down arrow buttons:'''
** Browse lists and menus.
** Move cursor (selected item) vertically in pattern editor, zynpad, etc.
* '''Left/Right arrow buttons:'''
** Select active chain in the mixer and chain-control views.
** Move cursor (selected item) horizontally in pattern editor, zynpad, etc.
* '''Select/Yes button:'''
** Select items in lists and menus.
** Enter ''select mode'' in chain-control view for browsing controller pages.
** Add/remove notes in pattern editor.
** Play/Stop sequences in zynpad.
** Answer "Yes" in confirmation dialogs.
* '''Back/No button:'''
** Close current view, returning to previous view.
** Answer "No" in confirmation dialogs.

<br>

{{NoteBox|When not in the control view, '''knob#4 acts as the ''select'' knob''' similar to the classic V1-V4 UI. Rotate to browse lists and move the cursor horizontally in grids (zynpad, pattern editor, etc.). Push to select items, same than SELECT button. Knob#3 can be used to move the cursor vertically in grids (zynpad, pattern editor, etc.).}}
<br>

'''<span style="color:#0000D0;">Custom function buttons (F1-F4)</span>'''<br>
These buttons are considered to be customizable buttons, e.g. if you want direct access to other views, etc. you may reconfigure these buttons using the webconf's wiring layout tab.

As explained above, while describing the ALT-mode, these buttons are assigned by default to MIDI Program Change messages:

* '''Normal mode''': Program Change 1-4 
* '''ALT mode''': Program Change 5-8

This default configuration is fine for learning/recalling subsnapshots (ZS3) and you may find this really useful if you use your zynthian as a keyboard expander.

<br clear=all>

{{NoteBox|Although all buttons and switches are fully configurable from the webconf tool (''hardware->wiring->advanced''), this guide refers to the official V5 profile configuration, that matches printed button legends. Of course, you are very welcome to experiment with button assignment and try different configurations. In fact, if you reach a sweet point, we may be able to produce an alternative keypad with custom printings. Simply contact us at the [https://discourse.zynthian.org zynthian forum]!}}

<br clear=all>
</div>

<div class="show_only_v4">
This is the basic V4 workflow based in the 4 knob switches:

[[File:zynthian_v4_workflow.png|800px|center]]

It's a good cheat sheet to have at hand when starting with zynthian. These views and others will be discussed in detail along the next sections.

The V4's extra silicone push buttons (S1-S4) can be configured depending of the user preference. This can be done from the webconf tool, accessing the advanced options in the wiring layout section. Some predefined  customization profiles are available from there:

* '''V4 Stage:''' The 4 silicone push buttons are assigned to MIDI program change 1-4. It's specially thought to use with ZS3.
** '''S1''' => MIDI Program 1
** '''S2''' => MIDI Program 2
** '''S3''' => MIDI Program 3
** '''S4''' => MIDI Program 4

* '''V4 Studio:''' The 4 silicone push buttons are assigned like this:
** '''S1'''
***Short => Audio Recorder/Player
***Bold => MIDI Recorder/Player
***Long => All Sounds Off
** '''S2'''
***Short => Zynpad
***Bold => Pattern Editor
***Long => All Sounds Off
** '''S3'''
***Short/Bold => Arrow Up
***Long => All Sounds Off
** '''S4'''
***Short/Bold => Arrow Down
***Long => All Sounds Off

* '''V4 CC Switches:''' The 4 silicone push buttons are assigned to MIDI CC 47-50. It's specially thought to MIDI learn toggle parameters (i.e. to use with SooperLooper)
** '''S1''' => CC 47 (value 0/127)
** '''S2''' => CC 48 (value 0/127)
** '''S3''' => CC 49 (value 0/127)
** '''S4''' => CC 50 (value 0/127)
</div>

===Using the knobs===
<div class="show_only_v5">
[[File:v5_render_knobs_numbered.jpg|140px|right]]
The V5 knobs behave quite differently to V1-V4 knobs. Because of the 20 silicone buttons, there is no need to use the knobs' switches to navigate the UI which now is best achieved with the push buttons, so when appropriate, knobs' switches have been mapped to drive the MIDI learning functionality, which is quite intuitive. The knobs are numbered from top to bottom, so the top one is knob#1 and the bottom one is knob#4. We will refer knobs in this way throughout this guide.
<br>

'''General rule'''

Although knob's functionality is contextual in V5, there is a kind of pattern that can serve as a ''general rule'' and applies to many views:
<br>
* '''Knob#4''' acts as the '''select knob''' similar to the classic V1-V4 UI.
** ''rotate'' to browse lists and move the cursor horizontally in grids (zynpad, pattern editor, etc.).
** ''short-push'' to select items, same than the SELECT button.
* '''Knob#3'''
** ''Rotate'' to move the cursor vertically in grids (zynpad, pattern editor, etc.).
<br>

{{NoteBox| MAIN Volume is always available with one click. Push '''MIX button''' and rotate '''Knob#3''' to change the MAIN volume.}}
</div>

<div class="show_only_v4">
'''General rule'''

Although knob's functionality is contextual in V4, there is a kind of pattern that can serve as a ''general rule'' and applies to many views:
<br>
* '''SELECT Knob''' acts as the '''select knob''' similar to the classic V1-V4 UI.
** ''rotate'' to browse lists and move the cursor horizontally in grids (zynpad, pattern editor, etc.).
** ''short-push'' to select items.
* '''BACK Knob'''
** ''Rotate'' to move the cursor vertically in grids (zynpad, pattern editor, etc.).
<br>

{{NoteBox| MAIN Volume is always available with one click. Bold-push '''BACK Knob''' to open the mixer view, then rotate '''Learn/Shot Knob''' to change the MAIN volume.}}
</div>

==The top-bar==
===The title-bar===
[[File:Screenshot 2024-06-22 11.41.54.png|400px|right|Title Bar]]

The title bar acts as a kind of breadcrumb. It normally shows the view's title or current chain information: MIDI channel, engine, bank & preset.

<br clear=all>

===The status area===
[[File:Zynthian_Status_Bar.png|400px|right]]

On the top-right corner, aside the title bar, is an area where some useful information is displayed in real time:

* '''Digital Audio Peak Meter (DPM)''': horizontal bars indicating digital audio level and peaks
* '''Status icons''': indication of various zynthian states

====The Digital Audio Peak Meter (DPM)====
The DPM 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 yellow segment covers the range -10dBFS to -3dBFS.
* The red segment covers the range -3dBFS to 0dBFS.

There are independent meters for left and right channels which monitor the system output, i.e. the mix of audio that feeds the Zynthian output. Level decays with a logarithmic rule, taking one second to decay to -200dBFS so will decay to -50dBFS (the displayed range) in about quarter of a second. Peaks are displayed instantly, i.e. the attack of the meter is immediate (*). The peak hold bar remains for two seconds or until a higher peak is reached.

This meter is the same as the main mixbus DPM that is always visible in the mixer view and is therefore hidden when the audio mixer view is shown.

(*) Meter is updated 5 times per second so there can be 200 ms delay in peak being displayed.

====The status icons====
{| class="wikitable"
!colspan="3"|1st row: Health & Load
|-
|style="padding:10px"|<span style="color:#00FF00">{{#fas:heart}}</span>
|style="padding:10px;width: 200px;|'''Cpu Load'''
|style="padding:10px"|Heart, indicating CPU load. It displays as green when under 50%, yellow when load is over 50% and red over 75%.
|-
|style="padding:10px"|<span style="color:#00FF00">{{#fas:recycle}}</span>
|style="padding:10px;width: 200px;|'''Software update available'''
|style="padding:10px"|When a software update is available, the green recycle symbol is shown. You can update from the admin menu, webconf or terminal.
|-
|style="padding:10px"|<span style="color:#FF0000">{{#fas:exclamation-triangle}}</span>
|style="padding:10px"|'''XRun'''
|style="padding:10px"|It's shown when there are XRuns. This may be accompanied by clicks and pops on audio output. This means the CPU can't process or transfer audio fast enough and you should consider disabling some CPU-hungry option (like VNC, headphones, etc.) or reducing the complexity of your chains.
|-
|style="padding:10px"|<span style="color:#FF0000">{{#fas:bolt}}</span>
|style="padding:10px"|'''Under-voltage'''
|style="padding:10px"|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 that icon and if you do so, you should consider looking for a better power source.
|-
|style="padding:10px"|<span style="color:#FF0000">{{#fas:temperature-high}}</span>
|style="padding:10px"|'''Over-temperature'''
|style="padding:10px"|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 that icon and if you do so, you should improve heat dissipation (using a heat sink, etc.)
|-
!colspan="3"|2nd row: MIDI activity & Playing/Recording
|-
|style="padding:10px"|<span style="color:#8080FF">'''m'''</span>
|style="padding:10px;width: 200px;|'''MIDI-IN'''
|style="padding:10px"|It's shown when MIDI messages are received. Underscore indicates system message such as MIDI clock.
|-
|style="padding:10px"|<span style="color:#B00000">{{#fas:circle}}</span>
|style="padding:10px"|'''Recording Audio'''
|style="padding:10px"|Audio is being recorded.
|-
|style="padding:10px"|<span style="color:#00B000">{{#fas:play}}</span>
|style="padding:10px"|'''Playing Audio'''
|style="padding:10px"|Audio track is being played.
|-
|style="padding:10px"|<span style="color:#F000F0">{{#fas:circle}}</span>
|style="padding:10px"|'''Recording MIDI'''
|style="padding:10px"|MIDI is being recorded.
|-
|style="padding:10px"|<span style="color:#F000F0">{{#fas:play}}</span>
|style="padding:10px"|'''Playing MIDI'''
|style="padding:10px"|MIDI track is being played.
|-
|style="padding:10px"|<span style="color:#F07000">{{#fas:circle}}</span>
|style="padding:10px"|'''Recording Pattern'''
|style="padding:10px"|A sequencer's pattern is being recorded.
|-
|style="padding:10px"|<span style="color:#F07000">{{#fas:play}}</span>
|style="padding:10px"|'''Playing Sequence'''
|style="padding:10px"|A sequence or pattern is being played.
|}

==Basic Views==

===Mixer===
[[File:Mixer.jpg|800px|right]]
Blablablablabla

'''THIS NEEDS TO BE MOVED TO A BETTER PLACE'''

From the mixer, you can change the active chain by <span class="show_only_v5">rotating the '''knob#4''' or using the '''left/right arrows'''</span><span class="show_only_v4">rotating the '''SELECT knob'''</span><span class="show_only_touch">touching the chain's strip fader</span>.

If you push the <span class="show_only_v5"> '''knob#4''' or the '''SEL button'''</span><span class="show_only_v4">'''SELECT knob'''</span><span class="show_only_touch">legend area under the chain's strip fader</span>, you enter the '''chain control''' view, what turns the chain active if it's not yet. <span class="show_only_v5">From the '''chain control''' view you can change the active chain using the '''left/right arrows'''.</span><span class="show_only_v4">From the '''chain control''' view you can short-push the '''LAYER knob''' to rotate the active chain.</span>

Finally, you can also change the active chain by recalling ZS3s (subsnapshots).


<br clear=all>

<div class="show_only_v5">
[[File:v5_mockup_mixer_01.png|800px|right]]

* '''Knob#4'''
** ''rotate'' to '''select active chain'''.
** ''short-push'' to open the '''chain control''' view with the selected chain.
** ''bold-push'' to open the '''chain options''' for the selected chain.
* '''Knob#3'''
** ''rotate'' to change the '''MAIN volume'''.
** ''short-push'' / ''bold-push'' to open the mixer's '''MIDI-learning menu'''.
* '''Knob#2'''
** ''rotate'' to change the '''balance''' of the selected chain.
** ''short-push'' to '''mute''' the selected chain.
* '''Knob#1'''
** ''rotate'' to change the '''volume''' of the selected chain.
** ''short-push'' to '''solo''' the selected chain.

<br clear=all>
</div>

===Selectors: menus and lists===

===Engine selector===

===Chain-control===
<div class="show_only_v5">
[[File:v5_mockup_control_01.png|800px|right]]

* '''Knob#1 - #4'''
** ''rotate'' any knob to '''change the value''' of the assigned parameter.
** ''short-push'' any knob to '''start MIDI-learning''' for the associated parameter. If wanted, a second push for global learning. Move a knob/fader in your MIDI controller to complete the learn or push back to cancel.
** ''bold-push'' any knob to open the '''options menu''' for the associated parameter.

<br>

{{NoteBox|To '''navigate the controller pages''' (select mode), you must '''push the SEL button'''. Bold-pushing knob#4 doesn't work for this in V5. }}

<br clear=all>
</div>

===Chain options===

===MIDI input/output config===
You can configure the chain's MIDI input devices from the chain's option menu. Use short-push for selecting/unselecting devices and bold-push for accessing the device options. All input devices are selected by default when creating a new chain.

===Banks & Presets===

===Confirmation dialog===

===On-screen keyboard===

===Admin===

===Others===

==Basic workflow==
===Chain creation===
===Basic chain manipulation===
===Layering chains===
===Etc.===

==Advanced workflow==
===MIDI learning===
===Audio routing===
===MIDI routing===

==The Sequencer==

===Zynpad (Scene)===
<div class="show_only_v5">
[[File:v5_mockup_zynpad_01.png|800px|right]]

* '''Knob#4'''
** ''rotate'' to move cursor horizontally.
** ''short-push'' to play/stop the selected sequence.
** ''bold-push'' to open the pattern editor for the selected sequence.
* '''Knob#3'''
** ''rotate'' to move cursor vertically.
** ''short-push'' to MIDI-learn the current pad by pushing a note in your MIDI controller.
* '''Knob#2'''
** ''rotate'' to change the scene.
* '''Knob#1'''
** ''rotate'' to adjust tempo BPM.

<br>

{{NoteBox|Before MIDI-learning pads, you have to select a trigger device. Push OPT to access the zynpad menu and choose your trigger device. Note that if the selected device is already supported (have a driver!), MIDI-learning is not needed at all and the device will be mapped automatically.}}

<br clear=all>
</div>

===Pattern Editor===
<div class="show_only_v5">
[[File:v5_mockup_pated_01.png|800px|right]]

* '''Knob#4'''
** ''rotate'' to move cursor horizontally.
** ''short-push'' to add/remove a note at cursor position.
** ''bold-push'' to '''edit note parameters''':
*** rotate knob#4 to select the parameter to edit
**** duration
**** velocity
**** offset
**** stutter count
**** stutter duration
**** play chance
*** rotate knob#3 to change coarse value.
*** rotate knob#2 to change fine value (when available).
*** short-push knob#4 to end editing
*** bold-push knob#4 again to enter EDIT ALL mode
* '''Knob#3'''
** ''rotate'' to move cursor vertically.
* '''Knob#2'''
** ''rotate'' to change the zoom level.
** ''short push'' to restore default zoom level.
* '''Knob#1'''
** ''rotate'' to adjust tempo BPM.

<br>

{{NoteBox| Bold-push in an empty position to edit the default note parameters. These are the values used when adding new notes.}}

<br clear=all>
</div>

===Arranger===

==Learning Pills==

===Basics===

* '''[[Creating a synth chain and adding a MIDI chorder + audio FXs]]''' (tutorial)
* '''[https://zynthian.org/mockup/index.html?capture=Zynthian_V5:_Creating_a_synth_chain Creating a synth chain]''' (workflow capture)
* '''[https://zynthian.org/mockup/index.html?capture=Zynthian_V5:_Creating_another_synth_chain Creating another synth chain]''' (alternate workflow capture)
* '''[https://zynthian.org/mockup/index.html?capture=Zynthian_V5:_Audio_Mixer Audio Mixer]''' (workflow capture)
* '''Banks & Presets'''
* '''Chain Control'''
* '''Chain Options'''
* '''Chain FXs'''
* '''MIDI-learning: sound engine parameters'''
* '''MIDI-learning: audio mixer'''
* '''MIDI-learning: '''ZS3s''' ('''Z'''ynthian '''S'''ub'''S'''nap'''S'''hots)
* '''Audio Recording'''
* '''MIDI Recording'''

===Sequencer===

* '''Pattern Editor''': Creating & Editing patterns
* '''ZynPad''': Launching patterns
* '''Audio Player''': Loops & One-shots
* '''Arranger''': Linear composing

===Mini-HowTos===

* '''MIDI Clone''': Make 2 chains to play unison
* '''Arppeggiator & Chorder'''
* '''SooperLooper''': Live audio looping

===Contribute your workflow captures===

This collection of workflow animations have been recorded with the "''capture workflow''" option from UI's admin menu and subtitled later with the webconf tool: 

 '''library->captures->log'''

With this tools, you can also capture, subtitle and share your favorite workflows, helping others to learn and contributing to improve zynthian documentation.
If you do so, please, share your workflows in the forum:

 https://discourse.zynthian.org