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 or directly to your computer (Ethernet to Ethernet). Your Zynthian box uses the link-local name "zynthian.local" and its files can be accessed with '''sftp''' and '''scp''' (If you are using Windows, get '''Winscp''' - free software needed to communicate using this Internet protocol). Of course, you can login with '''ssh''' too. (use '''PuTTY''' software for Windows). The username and password are: | + | 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 or directly to your computer (Ethernet to Ethernet). Your Zynthian box uses the link-local name "zynthian.local" and its files can be accessed with '''sftp''' and '''scp''' (If you are using Windows, get '''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 password are: |
| | | |
| 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 is disabled and local names are not recognized. | + | 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 (i.e. on Windows). |
− | Instead, you can use the zynthian's IPaddress. Find out what that is using the "Network Info" utility in the Zynthian's Admin menu. | + | Instead, you can use the Zynthian's IP address. Find out what that is using the "Network Info" utility in the Zynthian's Admin menu. or See: [[Finding your IP address]] |
| | | |
| == Accessing the Web Configuration Tool == | | == Accessing the Web Configuration Tool == |
Line 14: |
Line 16: |
| | | |
| # 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 type in the address bar: | + | # Open the browser in your computer and type in the address bar: |
| | | |
| zynthian.local (or the IP address of your Zynthian) | | zynthian.local (or the IP address of your Zynthian) |
| + | |
| + | (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 prompt for the admin password. It is "raspberry". |
| | | |
− | [[File:ZynLogin.png]] | + | [[File:zynthian_webconf_login.png]] |
| + | |
| + | Here's details on using the Web configuration tool: [[Configuration_Users_Guide]] |
| | | |
| == Wifi Configuration == | | == Wifi Configuration == |
| | | |
− | When you are logged in with ssh, you can configure the wifi access by editing this file:
| + | 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'. |
| | | |
− | $ sudo vi /etc/wpa_suppplicant/wpa_supplicant.conf
| + | ==Audio Configuration== |
| | | |
− | Note that this file is protected and you have to edit as root user (sudo).
| + | [[Configuring_Audio_Devices]] |
− | | |
− | After editing the WPA settings, you can restart the network interface using a command like this:
| |
− | | |
− | $ sudo ifdown wlan0
| |
− | $ sudo ifup wlan0
| |
| | | |
| == Accessing the MOD-UI web interface == | | == Accessing the MOD-UI web interface == |
Line 51: |
Line 52: |
| == Opening Synth Engine Native GUIs in your Computer == | | == Opening Synth Engine Native GUIs in your Computer == |
| | | |
− | You can attach an HDMI monitor, mouse and keyboard to your Zynthian, run '''startx''' to display the LINUX desktop and access the various synth engines,
| + | Some engines have a native GUI that can be accessed from your desktop/laptop computer. There are several methods for achieving this: |
| | | |
− | or
| + | ===X11 Server=== |
| | | |
− | You can remote login from another computer/laptop. To do this, you need an XServer running on your computer. Linux is best, but i've tested with Mac and Windows too.
| + | For using this method, you need an X11 Server running on your desktop/laptop computer. |
− | The only thing you have to do is login into your Zynthian Box with '''ssh''' using the "-Y" option to tunnel the X connection (or the equivalent option if you are not using a standard ssh client):
| + | |
| + | * 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: |
| | | |
| $ 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 "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]] |
| + | |
| + | ===VNC=== |
| + | |
| + | You also could use VNC on any platform, although it's slighty complex: |
| + | |
| + | * Login into your zynthian box and enter: |
| + | |
| + | # apt-get install vnc4server blackbox |
| + | # pico ~/.vncrc |
| + | |
| + | * enter this line to set the desktop size: |
| + | |
| + | $geometry = “2048x1600”; |
| + | |
| + | * start the vnc server: |
| + | |
| + | # vnc4server |
| + | |
| + | * Connect to the vnc server using (e.g.) windows TightVNC viewer. |
| | | |
− | Currently only ZynAddSubFX have a supported native GUI.
| + | ===Supported Engines with Native GUI=== |
| | | |
| + | Currently ''ZynAddSubFX'', ''Aeolus'' and ''Pure Data'' have support for native GUI, that is launched automatically when layer is created. Other GUI software can be launched, like ''qjackctl'' or a virtual MIDI keyboard for testing. Support for Soundfont GUI using ''Polyphone'' will be added in the future ;-) |
| | | |
− | '''IMPORTANT:''' Try to use an ethernet-to-ethernet connection as it will reduce latency and improve usability. | + | '''IMPORTANT:''' Using an ethernet-to-ethernet (cable) connection will reduce latency and improve usability. |
| | | |
| == Copying your presets/soundfonts to Zynthian == | | == Copying your presets/soundfonts to Zynthian == |