393
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + Line 5:
Line 5: − + − + Line 13:
Line 13: − + + + − − [[File:zynthian_webconf_dashboard.png|right]] + − Manage the snapshots (a stored configuration of instruments and settings.+ + + + − Soundfonts are files that contain a set of sampled sounds for an instrument. − ===Presets===+ Line 42:
Line 45: − Configure soundcards and audio adapters+ − [[File:zynthian_webconf_hardware_audio.png|right]]+ + + + + + + + + − Configure the touchscreen display.+ − [[File:zynthian_webconf_hardware_display.png|right]]+ + + − Configure wiring for the encoders and switches. − + − Controllers/knobs/switches+ Line 67:
Line 79: + + Line 79:
Line 93: + + + − − [[File:zynthian_webconf_MIDI.png|right]] Line 95:
Line 110: − + − ====Devices==== + + − [[File:MIDILog.png|right]]+ + + + + + + + + + − − [[File:zynthian_webconf_ui.png|right]] − ====Colors, Fonts, Sizes, etc.==== − + − + − ====Display Log==== − − [[File:UIlog.png|right]] Line 126:
Line 145: + + Line 131:
Line 152: − + − ===Backups/Restore===+ − + − <br clear=all>
Web Configuration User Guide (view source)
Revision as of 20:01, 27 March 2020
, 20:01, 27 March 2020→Hardware
The '''WebConf Tool''' is the ''Zynthian Web Configuration Tool'', a website hosted inside your Zynthian device that allows you to administer, configure, and inspect attributes of your Zynthian.
The '''WebConf Tool''' is the ''Zynthian Web Configuration Tool'', a website hosted inside your Zynthian device that allows you to configure and inspect the settings and attributes of your Zynthian.
==Login==
==Login==
[[File:zynthian_webconf_login.png|right]]
[[File:zynthian_webconf_login.png|right]]
You can access the Webconf tool from any computer using a web browser. Your Zynthian Box must be connected to your local network, or directly to your computer with an Ethernet cable (link local, point to point).
You can access the Webconf tool from any computer using a web browser. Your Zynthian Box must be connected to your local network, or directly to your computer with an Ethernet cable (link local, point to point).
To connect your Zynthian Box to your local network you can use an Ethernet cable connected from your router to your Zynthian Box. Also, if WiFi has been configured previously in your Zynthian, you should be allowed to connect by WiFi.
To connect your Zynthian Box to your local network you can use an Ethernet cable connected from your router to your Zynthian Box. Also, if WiFi has been configured previously in your Zynthian, you should be able to connect by WiFi.
To access your Zynthian box from your browser, you can use either of these 2 methods:
To access your Zynthian box from your browser, you can use either of these 2 methods:
* Browse to '''http://zynthian.local'''. This doesn't work in all devices. Many Windows-PCs and mobile devices don't fully support the [https://en.wikipedia.org/wiki/Multicast_DNS mDNS] protocol that enable the use of named addresses on a local network.
* Browse to '''http://zynthian.local'''. This doesn't work in all devices. Many Windows-PCs and mobile devices don't fully support the [https://en.wikipedia.org/wiki/Multicast_DNS mDNS] protocol that enable the use of named addresses on a local network.
* If you your browser can’t find the '''zynthian.local''' address, you will then need to figure out what IP address has been assigned to your Zynthian Box. For more details, see [[Finding your IP address]]. Once you have your Zynthian's IP address (xxx.xxx.xxx.xxx), you can browse to '''http://xxx.xxx.xxx.xxx'''. Easy!
* If you your browser can’t find the '''zynthian.local''' address, you will then need to figure out what IP address has been assigned to your Zynthian Box. For more details, see [[Finding your IP address]]. Once you have your Zynthian's IP address (xxx.xxx.xxx.xxx), you can browse to '''http://xxx.xxx.xxx.xxx'''.
<br clear=all>
<br clear=all>
==Dashboard==
==Dashboard==
[[File:zynthian_webconf_dashboard.png|right]]
The Dashboard displays basic configuration information about your Zynthian.
The Dashboard displays basic configuration information about your Zynthian.
<br clear=all>
<br clear=all>
==Library==
==Library==
The library is where multiple configuration snapshots, Instrument soundfonts, Presets, and Capture files are managed.
===Snapshots===
===Snapshots===
[[File:WebLibrarySnapshots.png|right]]
The Snapshots is where you can manage your snapshots (a stored configuration of instruments and settings.)
Bank/Program refers to MIDI Program Change commands that can enable a specific snapshot.
===Soundfonts===
===Soundfonts===
Soundfonts are files which contain a set of sampled sounds for an instrument.
===Captures (Audio & MIDI)===
===Captures (Audio & MIDI)===
===Audio===
===Audio===
[[File:zynthian_webconf_hardware_audio.png|right]]
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.
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'
This will tell you about ALSA settings (the audio hardware handler) and these settings will contain details that will be useful configuring the Jack settings.
More info: https://discourse.zynthian.org/t/audio-setup/2647
<br clear=all>
<br clear=all>
===Display===
===Display===
[[File:zynthian_webconf_hardware_display.png|right]]
This is where you can configure the touchscreen display.
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
<br clear=all>
<br clear=all>
===Wiring Layouts===
===Wiring Layouts===
[[File:zynthian_webconf_hardware_wiring.png|right]]
[[File:zynthian_webconf_hardware_wiring.png|right]]
Configure wiring for the encoders/knobs and switches.
Select dummies for the encoders if you have none.
<br clear=all>
<br clear=all>
===Update===
===Update===
Update the Zynthian OS and associated application software.
===Pianoteq===
===Pianoteq===
==Interfaces==
==Interfaces==
This is where you configure the various interfaces in your Zynthian
===MIDI===
===MIDI===
[[File:zynthian_webconf_MIDI.png|right]]
MIDI configuration page. Setup and store different profiles that are MIDI configurations.
MIDI configuration page. Setup and store different profiles that are MIDI configurations.
<br clear=all>
<br clear=all>
====[[Configure_MIDI_Filter/Router|Filter/Router]]====
====[[Configure_MIDI_Filter/Router|Filter/Router]]====
Visit here to [[Configure_MIDI_Filter/Router|Filter/Router]]
<br clear=all>
<br clear=all>
====MIDI Log====
[[File:MIDILog.png|right]]
Displays all received MIDI messages. Useful for debugging MIDI connection and configuration.
Displays all received MIDI messages. Useful for debugging MIDI connection and configuration.
====Using MIDI controllers instead of Encoders====
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.
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.
And you really can do an awful lot with a mouse! Really easy if you get a wireless(not Bluetooth) one it’s really intuitive once you learn the trick to do the back button.
<br clear=all>
<br clear=all>
===User Interface===
===User Interface===
[[File:zynthian_webconf_ui.png|right]]
Customize the user interface.
Customize the user interface.
<br clear=all>
<br clear=all>
====Restore Status on Startup====
====UI Log====
[[File:UIlog.png|right]]
Display a log of User Interface actions for debugging.
Display a log of User Interface actions for debugging.
<br clear=all>
<br clear=all>
===WIFI===
===WIFI===
This page allows your to connect to WiFi networks, as well as manage stored connections.
[[File:zynthian_webconf_wifi.png|right]]
[[File:zynthian_webconf_wifi.png|right]]
<br clear=all>
<br clear=all>
===Security/Access===
===Backup & Restore===
These pages allow you to backup & restore your system & data components.