189
edits
Changes
Jump to navigation
Jump to search
Line 2:
Line 2: − + − A headless Zynthian is a Raspberry Pi with ZynthianOS without the screen, the buttons and the knobs. + − All is controlled remotely via another computer, a tablet, a smartphone or a midi controller. − But sometimes, headless configuration could be interesting.+ − + − + Line 35:
Line 34: − + + Line 53:
Line 53: − + − + − To install VNC (or other softwares) on the Raspberry Pi, you need an access to the terminal: + − − * Option 1 : via the WebConf terminal − [http://zynthian.local/zynterm 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'' − − If you are using the WebConf terminal, note that it's normal that the apt update take a long time (and you see nothing, that is just a display bug). After the update, you should scroll down or launch a new WebConf terminal to install vnc. Line 112:
Line 88: + + + + + − + Line 120:
Line 101: − + + + +
Beginners Headless Zynthian Tutorial (view source)
Revision as of 06:26, 15 July 2023
, 06:26, 15 July 2023no edit summary
=== Introduction ===
=== Introduction ===
Here's a simple as possible step by step beginners tutorial to setup a headless Zynthian.
A headless Zynthian is a Raspberry Pi with ZynthianOS [https://en.wikipedia.org/wiki/Headless_computer without the screen], the buttons and the knobs. Here's a simple as possible step by step beginners tutorial to setup a headless Zynthian.
Zynthian can be controlled remotely via another computer, a tablet, a smartphone or a midi controller.
In most of the cases, the Zynthian Kit is the better way to use ZynthianOS.
In most of the cases, the Zynthian Kit is the better way to use ZynthianOS.
However, if you want to try Zynthian before you purchase a Zynthian Kit or experiment with another type of configuration, a headless setup allows this.
=== Hardware ===
=== Hardware ===
# Raspberry Pi (Pi4 recommanded)
# Raspberry Pi (Pi4 recommended)
# 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 recommended sound cards])
=== ZynthianOS ===
=== ZynthianOS ===
* 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
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.
There are tools available to activate the bonjour mechanism to allow using the name which is a much more flexible option.
If you cannot enter to the Zynthian WebConf Tools, wait a little bit more. Then try to reboot by powering off. Then, try to burn another SD card.
If you cannot enter to the Zynthian WebConf Tools, wait a little bit more. Then try to reboot by powering off. Then, try to burn another SD card.
Configure your hardware setup via the WebConf:
Configure your hardware setup via the WebConf:
[http://zynthian.local/hw-kit Hardware / Kit] / Custom
[http://zynthian.local/hw-kit Hardware / Kit] / Custom
[http://zynthian.local/hw-audio 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
[http://zynthian.local/hw-display Hardware / Display] / Generic HDMI Display
[http://zynthian.local/hw-wiring Hardware / Wiring] / DUMMIES
[http://zynthian.local/hw-wiring Hardware / Wiring] / DUMMIES
[http://zynthian.local System/sys-reboot / 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 ===
== OPTIONAL STEPS ==
== OPTIONAL STEPS ==
=== Controlling Headless Zynthian With A Computer Keyboard or MIDI Device===
While a touch interface allows control for a headless Zynthian setup, adding a computer keyboard or MIDI keyboard or controller (such as a NanoKontrol) will allow a greater range of controls at your fingertips.
See [[Zynthian_UI_Users_Guide#CUIA: Callable UI Actions | CUIA: Callable UI Actions]] for info about keyboard shortcuts and MIDI controls.
=== 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 ===