222
edits
Changes
Jump to navigation
Jump to search
mLine 36:
Line 36: − + + + + + + − Soundfonts are files which contain a set of sampled sounds for an instrument. − ===Captures (Audio & MIDI)=== − Manage files that contain musical performance data that you have captured. + + + Line 52:
Line 57: − + Line 65:
Line 70: − + + + − the hdmi display setting will deal with an hdmi monitor and the width & height settings will allow you to deal with any aspect ratio issues. The UI ffont settings might need altering to fit the screen+ − + Line 86:
Line 93: + + + + − + − + + + + + + + + + Line 99:
Line 118: − + − Maintain the Zynthian Repositories+ − + + − + − [[File:zynthian_webconf_MIDI.png|600px|right]] − MIDI configuration page. Setup and store different profiles that are MIDI configurations. − ====Profiles====+ − Manage storage of MIDI configuration profiles+ + + + + − + − Master Channel, Active Layer, MIDI over Network, Preload Presets on Note, etc.+ + + + + + + + − + + + + + + + + + + + + + + + + + + + + + + + + + + + − <br clear=all>+ + + + + + − ====Ports==== − [[File:zynthian_webconf_midi_ports.png|600px|right]] − This is an "advanced" option that allows to configure your hardware MIDI ports as INPUT/OUTPUT or for receiving MIDI feedback on controllers that support this feature (i.e. motorized faders). − + − [[File:MIDILog.png|600px|right]]+ − Displays all received MIDI messages. Useful for debugging MIDI connection and configuration.+ + + + + − + − + − The keyboard Binding Page allows configuration of particular functions from a connected USB keyboard this can obviously be a+ − full ASCII keyboard or a small number pad or even 3 foot switches. − − [[File:3footpedal.png|left|400px]] Line 152:
Line 210: − + Line 160:
Line 218: − ===User Interface=== − [[File:zynthian_webconf_ui.png|600px|right]] − Customize the user interface. − <br clear=all> − ====UI Log==== − [[File:UIlog.png|600px|right]] − Display a log of User Interface actions for debugging. − <br clear=all> − + Line 205:
Line 255: − +
Web Configuration User Guide (view source)
Revision as of 10:44, 14 January 2025
, Yesterday at 10:44Update all headings and some images to match current state of webconf
Bank/Program refers to MIDI Program Change commands that can enable a specific snapshot.
Bank/Program refers to MIDI Program Change commands that can enable a specific snapshot.
===Soundfonts===
===Captures (Audio & MIDI)===
Manage files that contain musical performance data that you have captured in various formats.
===Presets & Soundfonts===
This page allows for review of presets across all instruments and effects in your Zynthian box. A simple search is provided. You can also upload and download files containing presets and Soundfonts (files of sampled sounds for an instrument) directly to/from Zynthian.
<br clear=all>
<br clear=all>
==Hardware==
==Hardware==
===Kit===
===Audio===
===Audio===
This page lets you configure your sound cards and audio adapters.
This page lets you configure your sound cards and audio adapters.
Audio is probably the setting that most affects the behaviour. Get it wrong and the GUI probably won’t start (You'll see an error display). Luckily the webconf allows you to set the device up in spite of a non start of the GUI and the generic USB will generally work. If it doesn’t you will need to play around with the USB alsa settings. Understanding of the jackd start up settings is probably what’s required. It’s normally the hw: setting.
Audio is probably the setting that most affects the behaviour. The Zynthian GUI generally won’t start with incorrect audio settings (You'll see an error display). Webconf will still allow you to set the device up in spite of a non start of the GUI and the generic USB soundcard setting will generally work. If it doesn’t you will need to play around with the USB alsa settings. Understanding of the jackd start up settings is probably what’s required. It’s normally the hw: setting.
The audio settings for USB are really just passed to jackd (the audio server) and if they don’t match then jackd won’t start hence no audio. The GUI logging in the webconf will tell you if this is happening. A very good starting point if it’s not working is by logging onto the Zynthian with SSH and giving the command: 'aplay -L'
The audio settings for USB are really just passed to jackd (the audio server) and if they don’t match then jackd won’t start hence no audio. The GUI logging in the webconf will tell you if this is happening. A very good starting point if it’s not working is by logging onto the Zynthian with SSH and giving the command: 'aplay -L'
[[File:zynthian_webconf_hardware_display.png|600px|right]]
[[File:zynthian_webconf_hardware_display.png|600px|right]]
This is where you can configure the touchscreen display.
This is where you can configure the touchscreen display. Zynthian provides a set of preconfigured settings for various displays from the first drop down menu.
If required, use the remaining fields to customise width, height and rotation settings to allow you to deal with any aspect ratio or screen orientation issues. The UI font settings might need altering to fit the screen.
Adjustments to display settings generally require a reboot.
<br clear=all>
<br clear=all>
===Wiring Layout===
===Wiring===
[[File:zynthian_webconf_hardware_wiring.png|600px|right]]
[[File:zynthian_webconf_hardware_wiring.png|600px|right]]
This page allows configuration of the "wiring" for your encoders/knobs and switches. Make a selection from the 'Wiring Layout' drop-down menu based on your hardware used e.g. a kit from the store, a Zynaptik module (I/O expansion purchasable [https://shop.zynthian.org/shop/brd-0021-1-zynaptik-3-midi-242 here]) or your own hardware. Depending on your selection, this will change the available fields that follow. Select "dummies" if your zynthian has none.
This page allows configuration of the "wiring" for your encoders/knobs and switches. Make a selection from the 'Wiring Layout' drop-down menu based on your hardware used e.g. a kit from the store, a Zynaptik module (I/O expansion purchasable [https://shop.zynthian.org/shop/brd-0021-1-zynaptik-3-midi-242 here]) or your own hardware. Depending on your selection, this will change the available fields that follow. Select "dummies" if your zynthian has none.
For a deeper dive on the topic with info about both the Zynaptik modules and how to configure custom hardware see [https://wiki.zynthian.org/index.php/Adding_Extra_I/O_with_the_Zynaptik_Module Adding Extra I/O section].
For a deeper dive on the topic with info about both the Zynaptik modules and how to configure custom hardware see [https://wiki.zynthian.org/index.php/Adding_Extra_I/O_with_the_Zynaptik_Module Adding Extra I/O section].
<br clear=all>
<br clear=all>
===Options===
Configure hardware options on this page such as OTG, USB speed limiting, the level of overclocking for your raspberry pi and areas for custom config and boot commands.
==Software==
==Software==
===Plugins LV2===
===Engines===
[[File:zynthian_webconf_software_plugins.png|600px|right]]
[[File:zynthian_webconf_software_plugins.png|600px|right]]
Manage the installed LV2 plugins. Enable/Disable synthesizers, audio effects and MIDI tools.
Manage and search the installed engines (LV2 plugins). Use the checkbox to Enable/Disable synthesizers, audio effects and MIDI tools.
===Pianoteq===
===Pianoteq===
Configure the Pianoteq plugin. Enable license, add instrument packs, etc.
Configure the Pianoteq plugin. Enable license, add instrument packs, etc.
===DSP56300===
The DSP56300 emulator by The Usual Suspects, is a software emulation of the popular DSP563XX family of DSP chips developed originally by Motorola. They were used in a number of hardware synthesizers and other musical gear from the mid 90s, such as Access Virus A, B, C, TI / Clavia Nord Lead 2X, 3, Modular / Waldorf Q, Microwave II / Novation Supernova, Nova and many others.
For using the emulator you must have legal access to a ROM file containing the firmware for the device you want to emulate. If you are the lucky owner of one of this wonderful pieces of gear, you may have legal access to the firmware ROM file and you could use it with this emulator. Please, be aware that most (if not all!) firmware ROM files are not free software and you are not allowed to share them with anyone without permission from the copyright owners (aka, the device manufacturer).
From this page you can upload the firmware ROM files for the supported devices.
===Update===
===Update===
===Repositories===
===Version===
Allows selection of the Zynthian Repositories to give access to updates and new features.
[[File:Zynthian software repositories.png|600px|right]]
[[File:Zynthian software repositories.png|600px|right]]
<br clear=all>
<br clear=all>
==Interfaces==
==Interface==
This is where you configure the various interfaces in your Zynthian
This is where you configure the various interfaces in your Zynthian
[[File:Webconf interface menu oram.png|150px|frameless|right|Interface menu options]][[File:Webconf User Interface Page Screenshot.png|600px|right]]
===MIDI===
===UI Options===
This pages allows adjustment of various UI settings including:
* Power saving (screen off delay)
* Save current state
* MIDI over Network
* Enable/disable VNC for remote screen access
* Fonts and interface colours
====Options====
<br clear=all>
===UI Key Binding===
[[File:Keyboard binding.png|600px|right]]
The keyboard Binding Page allows configuration of particular functions from a connected USB keyboard this can obviously be a
full ASCII keyboard or a small number pad or even 3 foot switches.
[[File:3footpedal.png|left|400px]]
<br clear=all>
<br clear=all>
====[[Configure_MIDI_Filter/Router|Filter/Router]]====
====UI Log====
[[File:UIlog.png|600px|right]]
Display a log of User Interface actions for debugging.
===MIDI Options===
[[File:zynthian_webconf_MIDI.png|600px|right]]
<br clear=all>
MIDI configuration page. Save, restore and delete profiles for your custom MIDI settings made on this page.
* Program Change ZS3 (Program Change for SubSnapShots)
* Bank Change with CC#0(MSB) & CC#32(LSB)
* Preload Presets with Note-On events
* Enable System Messages (Transport)
====Midi Profile====
Save, restore and delete profiles for your custom MIDI configurations made on this page.
====Midi fine tuning (Hz)====
Make fine tuning adjustments
====Midi Devices====
[[File:zynthian_webconf_midi_ports.png|600px|right]]
This is an "advanced" option that allows to configure your hardware MIDI ports as INPUT/OUTPUT or for receiving MIDI feedback on controllers that support this feature (i.e. motorized faders).
====Configure MIDI Filter/Router====
[[File:zynthian_webconf_midi_router.png|600px|right]]
[[File:zynthian_webconf_midi_router.png|600px|right]]
The MIDI filter allows to filter the MIDI messages using rules. You can use the visual rule builder, or type the rules directly.
The MIDI filter allows to filter the MIDI messages using rules. You can use the visual rule builder, or type the rules directly.
[[Configure_MIDI_Filter/Router|Read the MIDI Filter Rule Language documentation.]]
[[Configure_MIDI_Filter/Router|Read the MIDI Filter Rule Language documentation.]]
====Master Channel====
Allows setting a master midi channel to allow program change and bank change messages and master key actions.
====Master Key Action====
Use this screen to assign midi note values to control the Zynthian UI.
<br clear=all>
<br clear=all>
====MIDI Log====
===VNC-UI===
This link opens a tab with the Zynthian UI, same as you would see with a directly connected display.
===VNC-Engines===
This link opens a tab with a desktop style GUI for and loaded engines (synths, effects etc.) that have a built-in UI.
===Terminal===
Access a terminal window for the OS directly from Webconf to debug, troubleshoot etc.
<br clear=all>
<br clear=all>
====Keyboard Binding====
===MIDI Log===
[[File:Keyboard binding.png|600px|right]]
[[File:MIDILog.png|600px|right]]
Displays all received MIDI messages. This page now provides a filter selection to focus messages on the various midi inputs & outputs in Zynthian. Useful for debugging MIDI connection and configuration.
<br clear=all>
<br clear=all>
Using midi driven encoders instead of encoders bult-in to the Zynthian is a little bit confusing, and that’s conceptual rather than technical. A MIDI controller is normally a pot or an encoder pretending to be a potentiometer. Its value varies from 0 to 127. The problem with that is the Zynthian encoders work as proper encoders using up and down signals. To produce something that could control a list properly when you move to a specific screen after you’ve come from another page is rather complicated because most pots will simply send the maximum value but not repeatedly send if further turns are made.
Using midi driven encoders instead of encoders bult-in to the Zynthian is a little bit confusing, and that’s conceptual rather than technical. A MIDI controller is normally a pot or an encoder pretending to be a potentiometer. Its value varies from 0 to 127. The problem with that is the Zynthian encoders work as proper encoders using up and down signals. To produce something that could control a list properly when you move to a specific screen after you’ve come from another page is rather complicated because most pots will simply send the maximum value but not repeatedly send if further turns are made.
The next issue is handling the pushbutton functions of the encoder and bold presses and long presses.
The next issue is handling the push button functions of the encoder and bold presses and long presses.
You can send CUIA commands to drive the GUI and that would allow you to drive the whole device from push buttons but it might be a lot of switches.
You can send CUIA commands to drive the GUI and that would allow you to drive the whole device from push buttons but it might be a lot of switches.
<br clear=all>
<br clear=all>
==System Management==
==System==
===WIFI===
===WIFI===
These pages allow you to backup & restore your system & data components.
These pages allow you to backup & restore your system & data components.
== Configuration with ssh ==
== Configuration with SSH ==
For Linux savvy users:
For Linux savvy users: