Zynthian Software - Revision history

Riban: Fixed sudo command (thanks @barlik)

2026-04-04T23:46:03Z

Fixed sudo command (thanks @barlik)

Peterluck: Add a one-liner to help with disk usage.

2025-10-24T16:29:54Z

Add a one-liner to help with disk usage.

Jofemodo: /* First Boot */

2025-05-29T17:18:43Z

First Boot

Jofemodo: /* Preparing the SD-card */

2025-05-29T17:14:37Z

Preparing the SD-card

Jofemodo: /* Preparing the SD-card */

2025-05-29T17:09:30Z

Preparing the SD-card

Jofemodo at 16:57, 29 May 2025

2025-05-29T16:57:09Z

Jofemodo: /* First Boot */

2024-09-24T10:37:03Z

First Boot

Jofemodo: /* Preparing the SD-card */

2024-09-24T10:35:38Z

Preparing the SD-card

Jofemodo: /* Official ZynthianOS SD-Images */

2024-09-24T10:29:37Z

Official ZynthianOS SD-Images

Jofemodo at 10:21, 24 September 2024

2024-09-24T10:21:48Z

@@ Line 57: / Line 57: @@
   tar -xf zynthianos-last-stable.img.xz
   sudo umount /dev/sdc1
-  sudo pv zynthianos-last-stable.img.xz.img > /dev/sdc
+  sudo sh -c 'pv zynthianos-last-stable.img.xz.img > /dev/sdc'
   sudo sync

← Older revision		Revision as of 16:29, 24 October 2025
Line 59:		Line 59:
	sudo pv zynthianos-last-stable.img.xz.img > /dev/sdc		sudo pv zynthianos-last-stable.img.xz.img > /dev/sdc
	sudo sync		sudo sync
		+
		+	Also, might you run out of space ''(~7GB + ~16GB = ~25GB !)'' and want to inflate the image directly on the SD card, you can try :
		+
		+	pv zynthianos-last-stable.img.xz \| xz -d \| sudo dd of=/dev/sdc bs=4M status=progress && sync
		+

@@ Line 67: / Line 67: @@
 == First Boot ==
-First boot could take some time. Be patient and wait until you see the splash screen with the logo. If you have a recent kit (V3, V4 & V5) and the display remains black after 1 minute, please, re-check the instructions above and re-burn the SD-card again. If this still doesn't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi status LEDs].
+First boot could take some time. Don't be impatient and wait until you see the splash screen with the logo. If the display remains black after 1 minute, please, re-check the [[Zynthian Software|instructions]] and re-burn the SD-card again. If this still don't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi5 status LEDs].
-Once you see the splash screen, it could take some minutes until the system is ready. You deserve a beer, or at least some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.
+Once you see the splash screen, it could 1-2 minutes to finish the configuration process. You deserve a beer (hey!! don't abuse if you already took one!!), or at less some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.
 <br>

@@ Line 42: / Line 42: @@
 Latest SD-card image weight around 7 GB compressed and around 16 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits.
-After downloading, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like, but big SD-card can be more problematic than smaller ones. We don't recommend to go above 64GB.
+After downloading, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like, but big SD-card can be more problematic than smaller ones. We don't recommend to go above 64GB. Please, use SD-cards from trusted sources and well-known brands and models. Sandisk Extreme & Pro are known to work fine. Samsung SD-cards also are good candidates. Kingston are more prone to fail.
-If you are a GUI guy, we recommend to use [https://www.raspberrypi.com/software/ RPi-Imager] to write the image into the SD-card. The gnome disk tool also works fine, and probably others too. We don't recommend BalenaEtcher anymore because it's causing much trouble lately.
+If you are a GUI guy, we recommend to use '''[https://www.raspberrypi.com/software/ RPi-Imager]''' to write the image into the SD-card. The '''Gnome Disk Tool''' also works fine, and probably others too. We don't recommend BalenaEtcher anymore because it's causing much trouble lately.
 If you are a terminal guy, ''dd'' or ''pv'' will do the task. Don't forget to uncompress the file, ''unmount'' the SD partition before burning and ''sync'' before extracting the card. With root privileges. Run something like this:

@@ Line 42: / Line 42: @@
 Latest SD-card image weight around 7 GB compressed and around 16 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits.
-After downloading and unzipping the SD-image, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like.
+After downloading, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like, but big SD-card can be more problematic than smaller ones. We don't recommend to go above 64GB.
-You can use [https://etcher.io/ Etcher], a free software that works on Mac, Windows and Linux, to write the image into the SD-card. There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
+If you are a GUI guy, we recommend to use [https://www.raspberrypi.com/software/ RPi-Imager] to write the image into the SD-card. The gnome disk tool also works fine, and probably others too. We don't recommend BalenaEtcher anymore because it's causing much trouble lately.
-If you are a terminal guy, ''dd'' or ''pv'' will do the task. Don't forget to ''unmount'' the SD partition before burning and ''sync'' before extracting the card. With root privileges, run something like this:
+If you are a terminal guy, ''dd'' or ''pv'' will do the task. Don't forget to uncompress the file, ''unmount'' the SD partition before burning and ''sync'' before extracting the card. With root privileges. Run something like this:
   umount /dev/sdc1
-  pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
+  pv zynthianos-last-stable.img.xz.img > /dev/sdc
   sync
 or if you are a ''sudoer'':
   sudo umount /dev/sdc1
-  sudo pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
+  sudo pv zynthianos-last-stable.img.xz.img > /dev/sdc
   sudo sync

@@ Line 2: / Line 2: @@
 '''Full Version:'''
-  '''[https://os.zynthian.org/zynthianos-last-stable.img.xz Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.img.xz.md5 MD5-sum])
+  '''[https://os.zynthian.org/zynthianos-last-stable.img.xz Stable ZynthianOS - Oram (Bookworm arm64)]''' ([https://os.zynthian.org/zynthianos-last-stable.img.xz.md5 MD5-sum])
 '''Lite Version (reduced soundfont library):'''
-  '''[https://os.zynthian.org/zynthianos-last-stable-nosfz.img.xz Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.img-nosfz.xz.md5 MD5-sum])
+  '''[https://os.zynthian.org/zynthianos-last-stable-nosfz.img.xz Stable ZynthianOS - Oram (Bookworm arm64)]''' ([https://os.zynthian.org/zynthianos-last-stable.img-nosfz.xz.md5 MD5-sum])
 == Testing ZynthianOS SD-image ==
@@ Line 19: / Line 19: @@
 <br>
 == Unzipping ==

@@ Line 40: / Line 40: @@
 == Preparing the SD-card ==
-Latest SD-card image weight around 8 GB compressed and around 14 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits. Completely ready to use. Plug and play!
+Latest SD-card image weight around 7 GB compressed and around 16 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits.
+After downloading and unzipping the SD-image, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like.
 You can use [https://etcher.io/ Etcher], a free software that works on Mac, Windows and Linux, to write the image into the SD-card. There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
@@ Line 59: / Line 58: @@
-{{NoteBox|RBPi2 is not supported by recent zynthian SD-images. If you want to use a RBPi2, you may need to build your own SD-image.}}
+{{NoteBox|RBPi2 is not longer supported by zynthianOS. If you want to use a RBPi2, you have to build your own SD-image.}}
 <br>

@@ Line 1: / Line 1: @@
-== Official ZynthianOS SD-Images ==
+== Stable ZynthianOS SD-image ==
-You can download the stable ZynthianOS SD-image from here:
+'''Full Version:'''
-<br>
+== Testing ZynthianOS SD-image ==
   '''[https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz.md5 MD5-sum])
 <br>

@@ Line 3: / Line 3: @@
 You can download the stable ZynthianOS SD-image from here:
-  '''[https://os.zynthian.org/zynthianos-last-stable.zip Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.zip.md5 MD5-sum])
+  '''[https://os.zynthian.org/zynthianos-last-stable.xz Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.xz.md5 MD5-sum])
 <br>
@@ Line 9: / Line 9: @@
 The latest testing image, called Oram, is available here:
-  '''[https://os.zynthian.org/test/2024-09-14-zynthianos-bookworm-aarch64-oram-2409.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-14-zynthianos-bookworm-aarch64-oram-2409.img.xz.md5 MD5-sum])
+  '''[https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz.md5 MD5-sum])
 <br>