Difference between revisions of "Zynthian Software"

From ZynthianWiki
Jump to navigation Jump to search
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Official "Gorgona Omega" SD-Images==
+
== Official Aruk Buster SD-Images (Buster-based) ==
  
The easiest way of getting the software is to download the torrent file for the latest ''official'' SD card image from here:
+
The current official Zynthian SD-Image is called '''Aruk Buster''' and it's based on Raspbian Buster. Currently we have a second Release Candidate (RC-2):
  
  '''[http://zynthian.org/download/zynthian_gorgona_omega_rbpi3_kitv2-2018-04-03.zip.torrent Download Zynthian "Gorgona Omega" SD-image, configured for Kits v2]'''
+
  '''[https://os.zynthian.org/2020-05-27-zynthianos-buster-lite-1.0.0-RC2.zip ZynthianOS "Aruk Buster" RC-2]''' ([https://os.zynthian.org/2020-05-27-zynthianos-buster-lite-1.0.0-RC2.zip.md5 MD5-sum])
SHA1: 601ab5e58d3f08b7cda6f5821d396f6622e93106
 
  
'''[http://zynthian.org/download/zynthian_gorgona_omega_rbpi3_kitv1-2018-04-03.zip.torrent Download Zynthian "Gorgona Omega" SD-image, configured for Kits v1]'''
+
Nightly builds are available too, so '''[https://os.zynthian.org/ you could consider using the last one]''' and help developers to test the latest features and find the bugs ...
SHA1: 53ce2ba3c055698d27108750c2b80313f904c921
 
  
It's a 8GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3. (Please, keep feeding the torrent after downloading!)
+
{{NoteBox|Aruk Buster SD images are pre-configured for official '''Kit v3 Pro'''. If you are using a different hardware, your first step should be accessing the webconf and configuring your hardware.}}
  
These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!
+
== Legacy Aruk Stretch SD-Images (Stretch-based) ==
  
After downloading the SD-image, you have to write it to a SDcard. You need a SD card with a minimum size of 16GB, although you can use a bigger one if you want.
+
The former official Zynthian SD-Image was called '''Aruk'''. It was based on Raspbian Stretch and the first ZynthianOS SD image built using the [https://github.com/guysoft/CustomPiOS CustomPiOS] system (thanks @guysoft!!):
  
Use [https://etcher.io/ Etcher] (free software works on Mac, Windows or Linux) to write the image onto the SDcard. Or do it manually! There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
+
[https://os.zynthian.org/2019-06-26-zynthianos-stretch-lite-1.0.0-RC3.zip ZynthianOS "Aruk Stretch" RC-3] ([https://os.zynthian.org/2019-06-26-zynthianos-stretch-lite-1.0.0-RC3.zip.md5 MD5-sum])
  
'''NOTE:''' RBPi2 is not currently supported by the latest official zynthian SD images, so if you want to use a RBPi2, you may need to build your own SD image.
+
You shouldn't be using Aruk Stretch without a good reason. We have moved to Buster!!
  
==Experimental ZynthianOS Aruk SD-Images (Stretch-based)==
+
{{NoteBox|Aruk Stretch SD-Image is pre-configured for official '''Kit v2'''.}}
  
We are working on the next Zynthian SD-Image, Aruk, based in Raspbian Stretch and built using a the CustomPiOS system. Currently we are quite close to the final release and have a Release Candidate (RC1):
+
== Nightly Build SD-Images ==
  
[https://os.zynthian.org/2019-04-10-zynthianos-stretch-lite-1.0.0-RC1.zip ZynthianOS "Aruk" RC-1]
+
If you like to be in the cutting edge, try the nightly builds:
  
and if you like to be in the cutting edge, try the nightly builds:
+
'''[https://os.zynthian.org ZynthianOS nightly builds]'''
  
[https://os.zynthian.org ZynthianOS nightly builds]
+
Our nightly build system is based on the fantastic work of @guysoft, the [https://github.com/guysoft/CustomPiOS CustomPiOS] system:
  
Thanks @guysoft!!
+
''CustomPiOS is a Raspberry Pi and other ARM devices distribution builder. CustomPiOS opens an already existing image, modifies it and repackages the image ready to ship.''
  
== Build your own image ==
+
'''@guysoft has largely contributed to the project by configuring and setting up the ZynthianOS build server. Really big thanks!!'''
  
If you like, you can build your own SD image following these instructions:
+
== Preparing the SD-card ==
  
[https://discourse.zynthian.org/t/new-sd-image-setup-script/283 Building the SD Image using the Setup Script]
+
Current images are 8GB compressed image file compiled for Raspberry Pi 3. These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!
  
Also, you would like to try the new experimental docker-builder:
+
After downloading the SD-image, you have to write it to a SD-card. You need a SD card with a '''minimum size of 16GB''', although you can use a bigger one if you want.
  
[https://discourse.zynthian.org/t/building-zynthian-image-now-works-with-docker/2499 Building Zynthian with Docker]
+
Use [https://etcher.io/ Etcher] (free software works on Mac, Windows or Linux) to write the image onto the SDcard. Or do it manually! There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
  
Thanks @guysoft!!
+
{{NoteBox|RBPi2 is not currently supported by the latest official zynthian SD images, so if you want to use a RBPi2, you may need to build your own SD image.}}
  
==Problems with Torrent?==
+
== Build your own image ==  
  
In case you have troubles using Torrent because some reason, you can download the official Gorgona Omega image from these links:
+
If you like, you can build your own SD image following these instructions:
  
* [http://zynthian.org/download/zynthian_gorgona_omega_rbpi3_kitv2-2018-04-03.zip Gorgona Omega, Kit v2]
+
[https://discourse.zynthian.org/t/new-sd-image-setup-script/283 Building the SD Image using the Setup Script]
  
* [http://zynthian.org/download/zynthian_gorgona_omega_rbpi3_kitv1-2018-04-03.zip Gorgona Omega, Legacy Kit V1]
+
Also, you would like to try the new docker-builder (thanks @guysoft!!):
  
Please, try first with torrent and don't use these "direct download" links unless you really need it:
+
[https://discourse.zynthian.org/t/building-zynthian-image-now-works-with-docker/2499 Building Zynthian with Docker]
 
 
* Zynthian server have limits and if everybody is trying to download the SD images directly from there, it will get overloaded and forum, wiki and other Zynthian services will be slower.
 
* Torrent should download faster than direct download links because you are downloading from several sources at once.
 

Revision as of 16:52, 2 June 2020

1 Official Aruk Buster SD-Images (Buster-based)

The current official Zynthian SD-Image is called Aruk Buster and it's based on Raspbian Buster. Currently we have a second Release Candidate (RC-2):

ZynthianOS "Aruk Buster" RC-2 (MD5-sum)

Nightly builds are available too, so you could consider using the last one and help developers to test the latest features and find the bugs ...

Note:

Aruk Buster SD images are pre-configured for official Kit v3 Pro. If you are using a different hardware, your first step should be accessing the webconf and configuring your hardware.

2 Legacy Aruk Stretch SD-Images (Stretch-based)

The former official Zynthian SD-Image was called Aruk. It was based on Raspbian Stretch and the first ZynthianOS SD image built using the CustomPiOS system (thanks @guysoft!!):

ZynthianOS "Aruk Stretch" RC-3 (MD5-sum)

You shouldn't be using Aruk Stretch without a good reason. We have moved to Buster!!

Note:

Aruk Stretch SD-Image is pre-configured for official Kit v2.

3 Nightly Build SD-Images

If you like to be in the cutting edge, try the nightly builds:

ZynthianOS nightly builds

Our nightly build system is based on the fantastic work of @guysoft, the CustomPiOS system:

CustomPiOS is a Raspberry Pi and other ARM devices distribution builder. CustomPiOS opens an already existing image, modifies it and repackages the image ready to ship.

@guysoft has largely contributed to the project by configuring and setting up the ZynthianOS build server. Really big thanks!!

4 Preparing the SD-card

Current images are 8GB compressed image file compiled for Raspberry Pi 3. These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!

After downloading the SD-image, you have to write it to a SD-card. You need a SD card with a minimum size of 16GB, although you can use a bigger one if you want.

Use Etcher (free software works on Mac, Windows or Linux) to write the image onto the SDcard. Or do it manually! There is a really good manual for this at this link.

Note:

RBPi2 is not currently supported by the latest official zynthian SD images, so if you want to use a RBPi2, you may need to build your own SD image.

5 Build your own image

If you like, you can build your own SD image following these instructions:

Building the SD Image using the Setup Script

Also, you would like to try the new docker-builder (thanks @guysoft!!):

Building Zynthian with Docker