Line 1: |
Line 1: |
− | Using either ethernet or wifi connection, Zynthian offers additional ways to access the system from your computer. The ''Zynthian Web Configuration Tool'' is a web interface to view and configure settings e.g. midi devices, preset libraries etc. Graphical user interfaces for synth engines and the pedalboard style LV2 plugin patch ''MOD-UI'' are also accessible from your web browser.
| + | Zynthian offers additional ways to access the system from your computer using either an ethernet or wifi connection. The ''Zynthian Web Configuration Tool'' is a web interface to view and configure settings e.g. midi devices, preset libraries etc. Graphical user interfaces for synth engines and the pedalboard style LV2 plugin patch ''MOD-UI'' are also accessible from your web browser. |
| | | |
| == Network Connection == | | == Network Connection == |
Line 7: |
Line 7: |
| 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]] | | 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]] |
| | | |
− | ==== Connecting via SSH and Accessing the File System ==== | + | === Wifi Configuration === |
| | | |
− | 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).
| + | 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'. |
− | | |
− | 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
| |
− | password=raspberry
| |
| | | |
− | | + | === Wifi Hotspot === |
− | | |
− | == 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. |
Line 30: |
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. | | 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. |
| | | |
− | == Accessing the Web Configuration Tool == | + | == Ways to Access Zynthian From Your Computer == |
| + | |
| + | === Connecting via SSH and Accessing the File System === |
| + | |
| + | 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''' for Windows). The username and default password is: |
| + | |
| + | user=root |
| + | password=raspberry |
| + | |
| + | === Accessing the Web Configuration Tool === |
| | | |
| You can access the web configuration tool using the web browser from your computer: | | You can access the web configuration tool using the web browser from your computer: |
Line 50: |
Line 54: |
| <br clear=all> | | <br clear=all> |
| | | |
− | == 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'.
| |
| | | |
− | == Accessing the MOD-UI web interface == | + | === Accessing the MOD-UI web interface === |
| [[File:MODUI.png|right|500px|MOD-UI pedal board style interface]] | | [[File:MODUI.png|right|500px|MOD-UI pedal board style interface]] |
| 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: |
Line 70: |
Line 72: |
| 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]] | | 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]] |
| | | |
− | == Viewing Zynthian UI and Synth Engine Native GUIs on your Computer == | + | === Viewing Zynthian UI and Synth Engine Native GUIs on your Computer === |
| [[File:Synth engines native gui.png|right|500px|Synth engines native GUI]] | | [[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: | | 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 162: |
Line 164: |
| {{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.}} | | {{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 == | + | == OSC (Open Sound Control)== |
| | | |
| 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. |
| + | |
| + | For more information about the protocol see [https://en.wikipedia.org/wiki/Open_Sound_Control Open Sound Control] at Wikipedia and [https://youtu.be/rf8YNPjVvF4 this explanatory video]. |
| | | |
| ==== CUIA: Callable User Interface Actions ==== | | ==== CUIA: Callable User Interface Actions ==== |
Line 183: |
Line 187: |
| | | |
| Some examples using the command line tool "send_osc": | | Some examples using the command line tool "send_osc": |
− | # send_osc 1370 /CUIA/SCREEN_MAIN | + | # send_osc 1370 /CUIA/SCREEN_MENU |
| # send_osc 1370 /CUIA/LAYER_CONTROL 2 | | # send_osc 1370 /CUIA/LAYER_CONTROL 2 |
| | | |
Line 193: |
Line 197: |
| | | |
| {| class="wikitable" | | {| class="wikitable" |
− | |+ CUIA list | + | |+ |
| |- | | |- |
− | ! Action !! Parameters !! Description | + | ! CUIA Name !! Parameters !! Description |
| |- | | |- |
| | ACTION_MIDI_UNLEARN || || | | | ACTION_MIDI_UNLEARN || || |