Command Line User Guide

From ZynthianWiki
Jump to: navigation, search

Use ssh to remotely access the console (terminal) of the Zynthian from another computer. Use the ssh command in Mac Terminal or use the freely downloadable PuTTY software for Windows. You need to know the IP address of the Zynthian on your local network to use ssh. See Finding your IP address for help on this.

SSH/SFTP access:

login: root
password: raspberry

User pi doesn't exist any more and ... it's a good idea to change the password :wink:

Base Directory:


Almost all the zynthian stuff like synth engines, audio plugins, soundfonts, zynthian user interface, setup scripts and other specific software is in this directory.

UI configuration file


This file contains some configuration parameters for the Zynthian User Interface:

  • Logging level
  • Wiring layout
  • Font & Color scheme
  • etc.

Stopping/Starting the Zynthian UI

You must use systemd-style commands to stop & start any system service, that includes the zynthian UI:

systemctl stop zynthian
systemctl start zynthian

If you want to run the Zynthian UI in the console, you must stop the zynthian service and run the zynthian UI as a normal script using these commands:

 systemctl stop zynthian

Running zynthian from the console (terminal) allows you to view the logging/debug messages, which is necessary for debugging (posting these to the forum will enable experts to help you.)

Viewing the Zynthian graphics display on a computer

If you are using Linux on your PC (or MacOSX with a X window server installed), you can login into your Zynthian box with ssh using the “-Y” flag:

ssh -Y root@zynthian.local

this will allow you to run graphic applications in your Zynthian, while displaying the graphics window on your PC/laptop.

Debugging MIDI

You can use commands to see what's going on with MIDI I/O Debugging MIDI

More detailed info

More info on this page Accessing_Zynthian_from_your_computer