Disk Images
Disk images simplify Peppy player installation and configuration processes. That can save a lot of time especially for people who are not so familiar with Linux or don't want to learn all the details involved into the configuration process. All software components of the Peppy Player can be also installed and configured manually by following the steps for the Headless Disk Image creation.
The latest disk images exceed a maximum allowed size for a single file (2GB) on GitHub. Therefore all disk image files have been divided into two files. To get a disk image both files should be downloaded. To extract a disk image use such programs as 7-Zip (free, open-source), WinRAR etc. Then write an extracted disk image to your SD card. Minimum SD card size is 8GB. Insert SD card with image into your Raspberry Pi and you are ready to go. The initial startup process usually takes longer than the regular one. Please be patient.
The disk images for the previous releases can be found here. The username for each release is pi and the password is the name of the edition e.g. Turner.
The new features for each release can be found in the README file.
The following hardware is required for all disk images:
- Any model of Raspberry Pi.
- Micro SD flash card (8GB minimum).
Any additional hardware (e.g. DAC or Amplifier) can be configured after the disk image installation.
Base Operating System: Raspberry Pi OS (32-bit) Lite 12/11/2023 (Bookworm)
The upgrade to the new versions of the OS (Bookworm) and other software (e.g. Python 3.11, Pygame 2) caused many changes in the player's code. As a result of these changes the following functionality is not available in the player anymore:
- Support for CD players was dropped as SDL 2/Pygame 2 dropped it.
- The disk images for SPI displays are not available anymore as it was impossible to make the latest OS and Pygame 2 working with those displays.
- Sliding actions are not available for touchscreens (e.g. adjusting volume). The touch actions should be used instead.
I hope that eventually all these issues will be resolved. If you still need any of these functionalities you can continue using the old disk images (Kandinsky Edition). Although the new player functionality (e.g. Radio Browser) is unavailable there.
| Display | Image File Name | Disk Image Parts |
|---|---|---|
| Headless | malevich-headless.img | part1 part2 |
| Waveshare 3.5" HDMI | malevich-waveshare.3.5.hdmi.img | part1 part2 |
| Waveshare 5.0" LCD | malevich-waveshare.5.0.hdmi.img | part1 part2 |
| Waveshare 7.0" HDMI LCD | malevich-waveshare.7.0.hdmi.img | part1 part2 |
The login is pi the password Malevich. It's highly recommended to change the password after the first login using raspi-config utility.
Base Operating System: Raspberry Pi OS (32-bit) Lite 05/07/2021 (Buster)
These old disk images have been listed here for those who still need functionality (e.g. CD player, SPI display) which is not available in the new images anymore.
| Display | File Name | File Size |
|---|---|---|
| Headless | kandinsky-headless.img.xz | 1.73 GB (1,860,341,640 bytes) |
| Waveshare 2.8" LCD | kandinsky-waveshare.2.8.img.xz | 1.88 GB (2,025,215,184 bytes) |
| Waveshare 3.5" LCD (B) | kandinsky-waveshare.3.5.img.xz | 1.88 GB (2,026,144,020 bytes) |
| Adafruit 3.5" LCD | kandinsky-adafruit.3.5.img.xz | 1.79 GB (1,932,466,720 bytes) |
| Waveshare 5.0" LCD | kandinsky-waveshare.5.0.img.xz | 1.78 GB (1,919,998,020 bytes) |
| Official 7.0" Touchscreen | kandinsky-official.7.0.img.xz | 1.79 GB (1,923,918,232 bytes) |
| Waveshare 7.9" HDMI LCD | kandinsky-waveshare.7.9.img.xz | 1.57 GB (1,694,601,924 bytes) |
The login is pi the password Kandinsky. It's highly recommended to change the password after the first login using raspi-config utility.
The steps below describe how the disk image files were created. They allow to reduce the file size from 8GB to 2.4GB.
- Prepare MicroSD card (8GB) with player for the particular display. Let's call this card the 'source'. Remove the card from the Raspberry Pi.
- Prepare another MicroSD card with size 16GB or more. It should be larger size as the image from the first step will be copied to this card. Let's call this card the 'compressor'. Insert the 'compressor' card into the Raspberry Pi.
- Install the program pishrink on the 'compressor' card:
wget https://raw.githubusercontent.com/Drewsif/PiShrink/master/pishrink.sh
chmod +x pishrink.sh
sudo mv pishrink.sh /usr/local/bin
- Connect USB Card Reader to the Raspberry Pi.
- Insert the 'source' card into the reader.
- Run the command which will copy the disk image (~8GB) from the 'source' card to the 'compressor' card. The filename (backup.img) can be any filename of your choice.
sudo dd bs=4M if=/dev/sdc of=backup.img status=progress
- Shrink/compress the disk image running the following command. This step will reduce the image file size 8GB->6.7GB
sudo pishrink.sh backup.img
- Copy the compressed disk image file to your host computer. For example use WinSCP for Windows computer.
- Compress the disk image file on your host machine using any ZIP program. This will further reduce the file size 6.7GB->2.4GB.