Zynthian Web Configuration Tool User Guide

From ZynthianWiki
Jump to navigation Jump to search

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.

1 Login

Zynthian webconf login.png

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 able to connect by WiFi.

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 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.

2 Dashboard

Zynthian webconf dashboard.png

The Dashboard displays basic configuration information about your Zynthian.

3 Library

The library is where multiple configuration snapshots, Instrument soundfonts, Presets, and Capture files are managed.

3.1 Snapshots


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.

3.2 Soundfonts

Soundfonts are files which contain a set of sampled sounds for an instrument.

3.3 Captures (Audio & MIDI)

Manage files that contain musical performance data that you have captured.

4 Hardware

4.1 Audio

Zynthian webconf hardware audio.png

This page lets you configure your sound cards and audio adapters

4.2 Display

Zynthian webconf hardware display.png

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

4.3 Wiring Layouts

Zynthian webconf hardware wiring.png

Configure wiring for the encoders/knobs and switches.

Select dummies for the encoders if you have none.

5 Software

5.1 Update

Update the Zynthian OS and associated application software.

5.2 Pianoteq

configure the Pianoteq plugin. (enable paid license)

5.3 Plugins

Manage the installed plugins.

Zynthian webconf software plugins.png

6 Interfaces

This is where you configure the various interfaces in your Zynthian

6.1 MIDI

Zynthian webconf MIDI.png

MIDI configuration page. Setup and store different profiles that are MIDI configurations.

6.1.1 Profiles

Manage storage of MIDI configuration profiles

6.1.2 Options

Master Channel, Active Layer, MIDI over Network, Preload Presets on Note, etc.

6.1.3 Filter/Router

Visit here to Filter/Router

6.1.4 MIDI Log


Displays all received MIDI messages. Useful for debugging MIDI connection and configuration.

6.2 User Interface

Zynthian webconf ui.png

Customize the user interface.

6.2.1 UI Log


Display a log of User Interface actions for debugging.

7 System Management

7.1 WIFI

This page allows your to connect to WiFi networks, as well as manage stored connections.

Zynthian webconf wifi.png

7.2 Backup & Restore

These pages allow you to backup & restore your system & data components.