Changes

Jump to navigation Jump to search
Line 1: Line 1:  
== Network Connection ==
 
== Network Connection ==
   −
The easier way of connecting 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" and its filesystem can be accessed with '''sftp''' and '''scp''' (If you are using Windows, use '''Winscp''' - free software needed to communicate using this Internet protocol).  
+
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" and the filesystem can be accessed with '''sftp''' and '''scp''' (If you are using Windows, use '''Winscp''' - free software needed to communicate using this Internet protocol).  
   −
You can also login with '''ssh''' to access the Linux console. see [[Command_Line_User_Guide]] (use '''PuTTY''' software for Windows). The username and default password are:
+
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:
    
  user=root
 
  user=root
 
  password=raspberry
 
  password=raspberry
   −
If the link-local address (zynthian.local) is not found, test 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]]
+
If the link-local address (zynthian.local) 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]]
    
== Accessing the Web Configuration Tool ==
 
== Accessing the Web Configuration Tool ==
Line 21: Line 21:  
{{NoteBox|If zynthian.local does not work, see [[Finding your IP address]]}}
 
{{NoteBox|If zynthian.local does not work, see [[Finding your IP address]]}}
   −
The web config tool will load and prompt for the admin password. It is "raspberry".
+
The web config tool will load and ask for the admin password. The default password is "raspberry".
    
[[File:zynthian_webconf_login.png]]
 
[[File:zynthian_webconf_login.png]]
   −
Here's details on using the Web configuration tool: [[Configuration_Users_Guide]]
+
Here are the details on using the Web configuration tool: [[Configuration_Users_Guide]]
    
== Wifi Configuration ==
 
== Wifi Configuration ==
Line 35: Line 35:  
You can access the MOD-UI web interface using the web browser from your computer:
 
You can access the MOD-UI web interface using the web browser from your computer:
   −
* Create a Special Layer with "MOD-UI" engine from the Zynthian's UI
+
* Create a Special Layer with a "MOD-UI" engine from the Zynthian's UI
 
* Connect your Zynthian to your local network using the ethernet connector (RJ45) or directly to your computer (ethernet to ethernet)
 
* Connect your Zynthian to your local network using the ethernet connector (RJ45) or directly to your computer (ethernet to ethernet)
* Open the browser in your camputer and navigate to:
+
* Open the browser in your computer and navigate to:
    
  zynthian.local:8888
 
  zynthian.local:8888
   −
The MOD-UI webpage should appear. Enjoy! ;-)
+
The MOD-UI webpage should appear.
   −
When a MOD-UI layer exist, this link is also accessible from the webconf's software menu (reload webconf after creating the layer!).
+
When a MOD-UI layer exist, this link is also accessible from the webconf's software menu (reload webconf after creating the layer).
   −
If the link-local address (zynthian.local) is not found, test that the link-local feature is enabled in your system. Sometimes is disabled and local names are not recognized. Instead, you can use the zynthian's IP address. See: [[Finding your IP address]]
+
If the link-local address (zynthian.local) 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]]
   −
== Opening Synth Engine Native GUIs in your Computer ==
+
== Opening Synth Engine Native GUIs on your Computer ==
    
Some engines have a native GUI that can be accessed from your desktop/laptop computer. There are several methods for achieving this:
 
Some engines have a native GUI that can be accessed from your desktop/laptop computer. There are several methods for achieving this:
Line 53: Line 53:  
====X11 Server====
 
====X11 Server====
   −
For using this method, you need an X11 Server running on your desktop/laptop computer.
+
To use this method, you need an X11 Server running on your desktop/laptop computer.
   −
* If you use Linux, probably you already have it, so you don't need to do nothing special. Simply login into your zynthian using the ssh with the "-Y" option for forwarding the X session:
+
* If you use Linux, you probably already have it, so you don't need to do anything special. Simply login into your zynthian using the ssh with the "-Y" option for forwarding the X session:
    
   $ ssh -Y root@zynthian.local
 
   $ ssh -Y root@zynthian.local
   −
* If you are a "Mac" user, you should install and enable the '''XQuartz''' package. After that, login into your zynthian with the same command.
+
* If you are a Mac user, you should install and enable the '''XQuartz''' package. After that, login into your zynthian with the same command.
   −
* If you are a "Windows" user, then you should install the '''XMing''' package and login into your zynthian using Putty with the "X11 forwarding" option enabled.  
+
* If you are a Windows user, then you should install the '''XMing''' package and login into your zynthian using Putty with the "X11 forwarding" option enabled.  
    
[[File:Putty-on-zynth-X11.png]]
 
[[File:Putty-on-zynth-X11.png]]
Line 67: Line 67:  
====VNC====
 
====VNC====
   −
You also could use VNC on any platform, although it's slighty complex:
+
You could also use VNC, although it's a bit complex:
    
* Login into your zynthian box and enter:
 
* Login into your zynthian box and enter:
Line 82: Line 82:  
   # vnc4server
 
   # vnc4server
   −
* Connect to the vnc server using (e.g.) windows TightVNC viewer.
+
* Connect to the vnc server using (e.g.) Windows TightVNC viewer.
 +
 
 +
====RealVNC====
 +
 
 +
[[File:VNCReal_Zynthians.png]]
 +
 
 +
[[File:Vncreal-setup.png]]
 +
 
 +
[[File:Realvnc-step2.png]]
 +
 
 +
[[File:Realvnc-step3.png]]
 +
 
 +
[[File:Realvnc-step4.png]]
 +
 
 +
[[File:Realvnc-step5.png]]
 +
 
 +
[[File:Realvnc-help.png]]
    
====Supported Engines with Native GUI====
 
====Supported Engines with Native GUI====
   −
Currently ''ZynAddSubFX'', ''Aeolus'', ''Pianoteq'' and ''Pure Data'' have support for displaying remotely their native GUIs, that is launched automatically when layer is created. Other GUI software can be launched, like ''qjackctl'' or a virtual MIDI keyboard for testing.
+
Currently ''ZynAddSubFX'', ''Aeolus'', ''Pianoteq'' and ''Pure Data'' have support for remotely displaying their native GUIs, which is launched automatically when layer is created. Other GUI software can be launched, like ''qjackctl'' or a virtual MIDI keyboard for testing.
    
{{NoteBox|Using an ethernet-to-ethernet (cable) connection will reduce remote GUI latency and improve usability.}}
 
{{NoteBox|Using an ethernet-to-ethernet (cable) connection will reduce remote GUI latency and improve usability.}}
Line 96: Line 112:  
   http://zynthian.local/lib-presets
 
   http://zynthian.local/lib-presets
   −
From there you manage your preset & soundfont libraries: renaming, deleting and uploading, including automatic convertion from some native formats:
+
From there you manage your preset & soundfont libraries: renaming, deleting, and uploading, including automatic conversion from some native formats:
    
* DX7 SysEX files
 
* DX7 SysEX files
Line 103: Line 119:  
* padthv1 native format
 
* padthv1 native format
   −
If it's not working for you or you prefer to do it by hand, you can copy your presets/soundfonts/pedalboards into the next folder:
+
If if this doesn't work for you, or you prefer to do it by hand, you can copy your presets/soundfonts/pedalboards into the next folder:
    
  /zynthian/zynthian-my-data
 
  /zynthian/zynthian-my-data
Line 143: Line 159:  
  /zynthian/zynthian-data
 
  /zynthian/zynthian-data
   −
Here you will find the same folder structure, and could help you to udnerstand.
+
Here you will find the same folder structure, and could help you to understand.
    
Also it's interesting:
 
Also it's interesting:
Line 157: Line 173:  
Open Sound Control (OSC) is a protocol for networking sound synthesizers, computers, and other multimedia devices for purposes such as musical performance or show control. Zynthian implements OSC in various ways.
 
Open Sound Control (OSC) is a protocol for networking sound synthesizers, computers, and other multimedia devices for purposes such as musical performance or show control. Zynthian implements OSC in various ways.
   −
=== CUIA ===
+
==== CUIA ====
 
The CUIA features described in the [[Zynthian_UI_Users_Guide#CUIA:_Callable_UI_Actions|user's guide]] can be accessed using OSC on port UDP 1370. The OSC base path for CUIA messages is
 
The CUIA features described in the [[Zynthian_UI_Users_Guide#CUIA:_Callable_UI_Actions|user's guide]] can be accessed using OSC on port UDP 1370. The OSC base path for CUIA messages is
 
  /cuia
 
  /cuia
Line 170: Line 186:  
  /CUIA/REBOOT
 
  /CUIA/REBOOT
   −
This is why you should operate secure networks ... :-D
+
==== TouchOSC ====
 
+
The TouchOSC protocol is supported if the option is enabled in the Zynthian admin menu. This accepts OSC on port 12101 using UDP datagrams and includes raw MIDI data interpretation on OSC path
=== TouchOSC ===
  −
TouchOSC protocol is supported if the option is enabled on the Zynthian admin menu. This accepts OSC on port 12101 using UDP datagrams and includes raw MIDI data interpretation on OSC path
   
  /midi
 
  /midi
 
This path accepts an OSC MIDI type message. An example Python script to send MIDI note on / off messages:
 
This path accepts an OSC MIDI type message. An example Python script to send MIDI note on / off messages:
584

edits

Navigation menu