17
edits
Changes
Jump to navigation
Jump to search
Line 13:
Line 13: − + Line 20:
Line 20: − + Line 34:
Line 34: + Line 41:
Line 42: − + − + − + − + − + −
Hardware / Display / Generic HDMI Display
+ − + − + − + − To install VNC (or other softwares) on the Raspberry Pi, you need an access to the terminal: + − − * Option 1 : via the WebConf terminal − System / Terminal − − * Option 2 : via SSH (that's mean via another terminal) − − - On MacOS, open the MacOS Terminal and type: − ssh zynthian.local − It will first ask for your mac password and then the Zynthian password (raspberry). − Then, if you see root@zynthian:~ you are on the Raspberry Pi terminal. − − Note : On MacOS, if you need to re-burn your SD card and have the error message “Host key verification failed” when you try to connect via SSH, you need to erase the previous SSH information with the nano text editor in the ssh known_hosts by running this command: − sudo nano /var/root/.ssh/known_hosts
− In nano, delete the zynthian line (control K), then write the file (control O + enter), then quit (control X). − − - On Windows, download [https://www.putty.org/ PuTTy] and do the same that for MacOS. − − # When you are on the Raspberry Pi terminal, run the following commands: − sudo apt update − sudo apt install realvnc-vnc-server − sudo raspi-config
− ''Interfacing Options / VNC / Yes'' − # Download and install VNC viewer in your devices:+ − # Connect to the Zynthian UI via VNC:+ Line 99:
Line 78: − + Line 106:
Line 85: − + − + Line 117:
Line 96: − + + + + − # install an SFPT client on your computer:+ + − # Open an SFPT connection:+ − # If, for exemple, you want to access to the Pure Data externals folders for manually installing externals that aren’t available via another way, simpli use it as a normal finder, go to:+
Beginners Headless Zynthian Tutorial (view source)
Revision as of 08:29, 25 February 2021
, 08:29, 25 February 2021Update now that VNCserver is already in ZynthianOs
# SD card (class 10)
# SD card (class 10)
# Power supply (take the official one)
# Power supply (take the official one)
# I2S DAC (sound card) ([https://wiki.zynthian.org/index.php/Unofficial_hardware recommanded sound cards])
# (optionnal but recommended for the best audo experience) an I2S DAC (sound card) ([https://wiki.zynthian.org/index.php/Unofficial_hardware recommanded sound cards])
=== ZynthianOS ===
=== ZynthianOS ===
# Burn the ZynthianOS image on an SD card
# Burn the ZynthianOS image on an SD card
=== Network Connexion ===
=== Network Connection ===
* The more simple way for making a network connexion is to directly connect an ethernet cable from the Raspberry Pi to the computer.
* The more simple way for making a network connexion is to directly connect an ethernet cable from the Raspberry Pi to the computer.
* Another way is to connect the two devices to an Ethernet switch.
* Another way is to connect the two devices to an Ethernet switch.
# Open your web browser
# Open your web browser
* On MacOS, go to http://zynthian.local to access the Zynthian WebConf Tool
* On MacOS, go to http://zynthian.local to access the Zynthian WebConf Tool
password = raspberry
* On Windows, first [https://wiki.zynthian.org/index.php/Finding_your_IP_address find the IP address of the Raspberry Pi], then type the IP address on the web browser to access the Zynthian WebConf Tool
* On Windows, first [https://wiki.zynthian.org/index.php/Finding_your_IP_address find the IP address of the Raspberry Pi], then type the IP address on the web browser to access the Zynthian WebConf Tool
* If you are connected via an ethernet switch, connect the switch to your internet box
* If you are connected via an ethernet switch, connect the switch to your internet box
* If you are directly connected via an ethernet cable, configure the Wifi on the WebConf page:
* If you are directly connected via an ethernet cable, configure the Wifi on the WebConf page:
System / WIFI / Add Network
[http://zynthian.local/sys-wifi System / WIFI] / Add Network
Mode = ON
Mode = ON
=== Update ZynthianOS ===
=== Update ZynthianOS ===
Now that you are connected to the Internet, you can update Zynthian OS via the WebConf:
Now that you are connected to the Internet, you can update Zynthian OS via the WebConf:
Software / Update
[http://zynthian.local/sw-update Software / Update
]
System / Reboot
[http://zynthian.local/sys-reboot System / Reboot]
=== Configure the hardware ===
=== Configure the hardware ===
Configure your hardware setup via the WebConf:
Configure your hardware setup via the WebConf:
Hardware / Kit / Custom
[http://zynthian.local/hw-kit Hardware / Kit] / Custom
Hardware / Audio / ''Select your soundcard on the list''
[http://zynthian.local/hw-audio Hardware / Audio] / ''Select your soundcard on the list'' or choose RBPiHeadphones
[http://zynthian.local/hw-display Hardware / Display] / Generic HDMI Display
Hardware / Wiring / DUMMIES
[http://zynthian.local/hw-wiring Hardware / Wiring] / DUMMIES
System / Reboot
[http://zynthian.local System/sys-reboot / Reboot]
=== Install VNC Server on the Raspberry Pi ===
=== Activate VNC Server on the Raspberry Pi ===
VNC allows you to remotely have the Raspberry Pi screen on your personal computer, your tablet or your smartphone.
VNC allows you to remotely have the Raspberry Pi screen on your personal computer, your tablet or your smartphone.
With your browser pointing to http://zynthian.local, navigate to Interface => UI Options scroll at the bottom and check "Enable VNC server"
=== Install VNC Viewer in your Devices ===
=== Install VNC Viewer in your Devices ===
1. Download and install VNC viewer in your devices:
* [https://www.realvnc.com/connect/download/vnc/ MacOS and Windows]
* [https://www.realvnc.com/connect/download/vnc/ MacOS and Windows]
* [https://itunes.apple.com/us/app/vnc-viewer/id352019548?mt=8 iOS]
* [https://itunes.apple.com/us/app/vnc-viewer/id352019548?mt=8 iOS]
* [https://play.google.com/store/apps/details?id=com.realvnc.viewer.android&gl Android]
* [https://play.google.com/store/apps/details?id=com.realvnc.viewer.android&gl Android]
2. Connect to the Zynthian UI via VNC:
You should be on the same network (ethernet cable and/or Wifi).
You should be on the same network (ethernet cable and/or Wifi).
Type the raspberry pi IP address (on Windows and android) or zynthian.local (on MacOS and iOS) in VNC Viewer.
Type the raspberry pi IP address (on Windows and android) or zynthian.local (on MacOS and iOS) in VNC Viewer.
For a better use, configure Zynthian UI for headless use in the WebConf:
For a better use, configure Zynthian UI for headless use in the WebConf:
Interface / UI options
[http://zynthian.local/ui-options Interface / UI options
]
Advanced view : ON
Advanced view : ON
Enable Touch Widgets: ON
Enable Touch Widgets: ON
On stage, you can disconnect the Zynthian from internet and configure it as a hotspot for connecting your devices to it.
On stage, you can disconnect the Zynthian from internet and configure it as a hotspot for connecting your devices to it.
For this, go to the WebConf:
For this, go to the WebConf:
System / WIFI / Hotspot
[http://zynthian.local/sys-wifi System / WIFI] / Hotspot
== OPTIONAL STEPS ==
== OPTIONAL STEPS ==
=== Accessing the Native GUI ===
=== Accessing the Native GUI ===
If you want to access from your computer to the Graphical User Interface of softwares like Pure data that run on the Raspberry Pi, you need to install an X11 server on your computer:
If you want to access from your computer to the Graphical User Interface of softwares like Pure data or Pianoteq that run on the Raspberry Pi, you need to install an X11 server on your computer:
* On MacOS: [https://www.xquartz.org/ Xquartz]
* On MacOS: [https://www.xquartz.org/ Xquartz]
* On Windows: [https://sourceforge.net/projects/xming/ Xming]
* On Windows: [https://sourceforge.net/projects/xming/ Xming]
On the X11 server’s terminal (xterm) that run on your computer, send the command:
On the X11 server’s terminal (xterm) that run on your computer, send the command:
ssh -Y root@zynthian.local
ssh -Y root@zynthian.local
On the Zythian UI, create a new Pure Data layer (or other engine with supported native GUI: ZynAddSubFX, Aeolus and Pianoteq) and thehe Pure Data GUI should appears on your computer screen.
On the Zythian UI, create a new Pure Data layer (or other engine with supported native GUI) and the Pure Data GUI should appears on your computer screen.
* Note that you can access MOD-UI (the virtual pedal board) without X11. When you have created a MOD-UI layer, just go to the WebConf :
[http://zynthian.local:8888 Software / MOD-UI]
=== Accessing the ZynthianOS Folders ===
=== Accessing the ZynthianOS Folders ===
If you want to graphically access to the Zynthian OS files and folders (not recommended for beginners):
If you want to graphically access to the Zynthian OS files and folders (not recommended for beginners):
1. install an SFPT client on your computer:
* On MacOS: [https://cyberduck.fr/ Cyberduck]
* On MacOS: [https://cyberduck.fr/ Cyberduck]
* On Windows: [https://www.putty.org/ PuTTy]
* On Windows: [https://www.putty.org/ PuTTy]
2. Open an SFPT connection:
Server : zynthian.local (MacOS) or IP Address (Windows)
Server : zynthian.local (MacOS) or IP Address (Windows)
User : root
User : root
Password : raspberry
Password : raspberry
3. If, for exemple, you want to access to the Pure Data externals folders for manually installing externals that aren’t available via another way, simply use it as a normal finder and go to:
/usr/lib/pd/extra
/usr/lib/pd/extra
And upload your custom externals.
And upload your custom externals.