Accessing Zynthian from your computer - Revision history

Niels: Document ZYN_CC

2026-01-31T11:56:16Z

Document ZYN_CC

Toff at 09:20, 25 December 2025

2025-12-25T09:20:00Z

Riban: Add CUIA_POWER_SAVW

2025-10-27T15:44:40Z

Add CUIA_POWER_SAVW

Riban: /* Viewing Zynthian UI and Synth Engine Native GUIs on your Computer */

2025-02-12T06:46:14Z

Viewing Zynthian UI and Synth Engine Native GUIs on your Computer

Jofemodo: /* Accessing the MOD-UI web interface */

2024-10-11T09:11:18Z

Accessing the MOD-UI web interface

Jofemodo: /* Accessing the MOD-UI web interface */

2024-10-11T09:10:19Z

Accessing the MOD-UI web interface

Jofemodo: /* Accessing the MOD-UI web interface */

2024-10-11T09:09:28Z

Accessing the MOD-UI web interface

Jofemodo: /* Network Connection */

2024-10-11T09:07:11Z

Network Connection

Jofemodo at 09:04, 11 October 2024

2024-10-11T09:04:06Z

Jofemodo: /* Accessing the Web Configuration Tool */

2024-10-11T08:56:58Z

Accessing the Web Configuration Tool

@@ Line 213: / Line 213: @@
   liblo.send(('zynthian.local', 1370), "/CUIA/CHAIN_CONTROL", ('i', 2))
-And finally, the full list of CUIAs:
+And finally, the (not so) full list of CUIAs:
 {| class="wikitable"
@@ Line 403: / Line 403: @@
 |-
 | ZYNSWITCH || %i, %t || Simulates button %i action of type %t (Push, Short, Bold, Long)
 |}

@@ Line 135: / Line 135: @@
      + ...
      + bank-n
    + '''gig'''
      + bank-1

@@ Line 282: / Line 282: @@
 |-
 | POWER_OFF || ||
 |-
 | PRESET || ||

@@ Line 77: / Line 77: @@
 * Assert Enable VNC Server option and press Save
 * Reload webconf and navigate to INTERFACE->UI-Engines
-* Enter the Zynthian password (default: raspberry)
+* Enter the Zynthian password (default: opensynth)
 Note: There is also an option to access the Zynthian main UI by navigating to INTERFACE-VNC UI. This is a mirror of the main UI and may be driven from VNC and/or the physical interface.
@@ Line 91: / Line 91: @@
 * 5901 (Engines desktop)software can be launched, like ''qjackctl'' or a virtual MIDI keyboard for testing.
-Tip: You can automatically connnect and login to web-based VNC by appending parameters to the URL, e.g. http://zynthian.local:6080/vnc.html?autoconnect=true&password=raspberry
+Tip: You can automatically connnect and login to web-based VNC by appending parameters to the URL, e.g. http://zynthian.local:6080/vnc.html?autoconnect=true&password=opensynth
 ====Supported Engines with Native GUI====

@@ Line 177: / Line 177: @@
 The MOD-UI webpage should appear. When a MOD-UI chain does exist, this link is also accessible from the webconf's software menu (reload webconf after creating the chain).
-If the link-local address (''zynthian.local'' or ''zynthian.lan'') is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized. You can also use the zynthian's IP address instead. See [[Finding your IP address]].
+If the link-local address (''zynthian.local'' or ''zynthian.lan'') is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized.
 == OSC (Open Sound Control)==

@@ Line 173: / Line 173: @@
 or
-[http://zynthian.lan:8888 http://zynthian.lan:8888]
+ [http://zynthian.lan:8888 http://zynthian.lan:8888]
 The MOD-UI webpage should appear. When a MOD-UI chain does exist, this link is also accessible from the webconf's software menu (reload webconf after creating the chain).
-If the link-local address (''zynthian.local'' or ''zynthian.lan'') is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized. You can use the zynthian's IP address instead. See: [[Finding your IP address]]
+If the link-local address (''zynthian.local'' or ''zynthian.lan'') is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized. You can also use the zynthian's IP address instead. See [[Finding your IP address]].
 == OSC (Open Sound Control)==

@@ Line 169: / Line 169: @@
 * Open the browser in your computer and navigate to:
-[http://zynthian.local:8888 http://zynthian.local:8888] or  [http://zynthian.lan:8888 http://zynthian.lan:8888]
+ [http://zynthian.local:8888 http://zynthian.local:8888]
-The MOD-UI webpage should appear.
+or
-When a MOD-UI layer exist, this link is also accessible from the webconf's software menu (reload webconf after creating the layer).
+[http://zynthian.lan:8888 http://zynthian.lan:8888]
-If the link-local address (zynthian.local or zynthian.lam) is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized. You can use the zynthian's IP address instead. See: [[Finding your IP address]]
+The MOD-UI webpage should appear. When a MOD-UI chain does exist, this link is also accessible from the webconf's software menu (reload webconf after creating the chain).
 == OSC (Open Sound Control)==

@@ Line 3: / Line 3: @@
 == Network Connection ==
-The easiest way to connect your Zynthian is to use the Ethernet RJ45 connector with a CAT-5 cable to connect your unit to your local network (DHCP) or directly to your computer (Ethernet to Ethernet, aka link-local). Your Zynthian box uses the link-local name "zynthian.local" or "zynthian.lan", depending on your system.
+The easiest way to connect your Zynthian is to use the Ethernet RJ45 connector with a CAT-5 cable to connect your unit to your local network (DHCP) or directly to your computer (Ethernet to Ethernet, aka link-local). Your zynthian box uses link-local name, depending on your system:
-If the link-local address (zynthian.local or zynthian.lan) is not found, make sure that the link-local feature is enabled in your system. Sometimes it's disabled and link-local names are not recognized (windows). If you can't manage to get link-local names to work, you can use the Zynthian's IP address.  The zynthian's IP address can be found int the UI's "Admin->Network Info" menu, and it's also printed on the zynthian's error screen. See: [[Finding your IP address]]
+ ''zynthian.local''
 === Wifi Configuration ===
-All WiFi management is done from the zynthian-ui admin menu. You can configure your WiFi networks from there.
+All wifi management is done from the zynthian-ui admin menu. You can configure your wifi networks from there.
 === Wifi Hotspot ===
-You can connect to your Zynthian using the built-in Wifi Hotspot mode. This is less convenient than using Ethernet or an existing Wifi network, and is mostly useful to configure connections to other wifi networks.
+You can connect to your zynthian using the built-in Wifi Hotspot mode. This is less convenient than using Ethernet or an existing wifi network, and is mostly useful to configure connections to other wifi networks.
-# Open the Admin screen on your Zynthian.
+# Open the Admin screen on your zynthian.
 # Select the "Wifi Hotspot" option. This could take up to 30 seconds to complete.
 # Connect to the "zynthian" network with another device.
-# In the Admin screen on your Zynthian, select "Network Info".
+# In the Admin screen on your zynthian, select "Network Info".
 # Connect to the displayed IP address with the browser on your other device.
-Note that the wifi network created in hotspot mode allows anyone to connect. If using the wifi hotspot in a public place, ensure you've changed your Zynthian password.
+Note that the wifi network created in hotspot mode allows anyone to connect. If using the wifi hotspot in a public place, ensure you've changed your password.
 === Accessing the terminal with SSH / Accessing the file system with SFTP ===

@@ Line 9: / Line 9: @@
 === Wifi Configuration ===
-Wifi credentials can be set via the web config tool: System - Wifi - Add Network. Wifi must be enabled in the Zynthian Gui: press the Back button until you are in the Admin menu. Then select 'Start WIFI'.
+All WiFi management is done from the zynthian-ui admin menu. You can configure your WiFi networks from there.
 === Wifi Hotspot ===
@@ Line 23: / Line 23: @@
 Note that the wifi network created in hotspot mode allows anyone to connect. If using the wifi hotspot in a public place, ensure you've changed your Zynthian password.
-== Ways to Access Zynthian From Your Computer ==
+=== Accessing the terminal with SSH / Accessing the file system with SFTP ===
 You can also login with '''ssh''' to access the Linux console. see [[Command_Line_User_Guide]] (use '''PuTTY''' for Windows). The username and default password is:
@@ Line 33: / Line 29: @@
   '''user:''' root
   '''password:''' opensynth
 {{NoteBox|For legacy SD-images before Oram Bookworm the password is ''raspberry''}}
@@ Line 64: / Line 62: @@
 <br clear=all>
-=== Accessing the MOD-UI web interface ===
+=== Viewing Zynthian UI and Synth Engine Native GUIs on your Computer ===
 [[File:Synth engines native gui.png|right|500px|Synth engines native GUI]]
 Some engines have a native GUI that can be accessed from your desktop/laptop computer. Zynthian provides a VNC viewer for a desktop that allows access to these native GUI. By default VNC is disabled and it is recommended to disable for performance (as it has a small overhead which is best saved for your audio). To enable VNC and access the desktop and engines' native GUI:
@@ Line 171: / Line 154: @@
 {{WarningBox|If you add or change something inside the ''zynthian-data'' folder, your changes will be lost on the next update, or, in a worst case scenario, you could break the update system.}}
 == OSC (Open Sound Control)==
@@ Line 179: / Line 178: @@
 ==== CUIA: Callable User Interface Actions ====
 The CUIA is an unidirectional remote API that can be used to send simple control messages to zynthian UI. The CUIA can be accessed in several ways, as described in the [[Zynthian_UI_Users_Guide#CUIA:_Callable_UI_Actions|user's guide]] and this section explains how to access the CUIA using OSC on port UDP 1370.

@@ Line 43: / Line 43: @@
 # Open the browser in your computer and type in the address bar:
-  [http://zynthian.local http://zynthian.local] or [http://zynthian.lan http://zynthian.lan]  (or the IP address of your Zynthian)
+  [http://zynthian.local http://zynthian.local]
-{{NoteBox|If zynthian.local does not work, see [[Finding your IP address]]
+or
-<br>''If you can't access WebConf with your browser, there is a command-line option. See [[Command_Line_User_Guide#Configuration_without_WebConf]]''}}
+ [http://zynthian.lan http://zynthian.lan]
-The web config tool will load and ask for the admin password. The default password is "opensynth".
+or
 [[File:zynthian_webconf_login.png|right|500px]]
 Here are the details on using the Web configuration tool: [[Zynthian Web Configuration Tool User Guide]]