Skip to content

moode-player/imgbuild

Repository files navigation

moOde audio player - image builder

The image builder generates an optimized Raspberry Pi OS (RaspiOS)image with moOde audio player installed. The build is based on RaspiOS Lite Bullseye release and uses pi-gen to create the image. This build process is designed to generate moode images for development and testing purposes leading up to a final release image. The release image is available for download at the moode audio player website.

Note: The build process will not alter the host system and thus can run on any existing host that meets the requirements listed below. If the host system behaves a little strange after a build, just reboot and it should be fine.

Disclaimer

The software and other materials in this repository are distributed under the GNU GENERAL PUBLIC LICENSE Version 3 which includes the following disclaimer:

  1. Disclaimer of Warranty.

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE >EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

  1. Limitation of Liability.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

This means that the user of this software is responsible for any damage resulting from its use. It does not matter if the damage is caused by incorrect usage or a bug in the software.

The build

Requirements

  • Debian, Ubuntu or RaspiOS based system (other architectures may be added)
  • At least 10GB of free disk space
  • Linux friendly file system (ext4, zfs, btrfs, xfs)
  • If a NAS is used for build output it should be mounted via NFS
  • All packages come from the following locations:
    • Offical RaspiOS package repo
    • moOde package build repo pkgbuild
  • The host used for the build should be connected via Ethernet for best download performance from the remote repos

Output

The output is located in the subdirectory deploy and contains the following files:

  • A zip file containing an image (.img) file
  • An information (.info) file which lists all installed packages and their version numbers

Notes:

  • The zip file is around 1GB in size and the image file is around 3.3GB
  • The latest packages are used from the RaspiOS Lite repo in combination with specific packages from the moOde package build repo
  • Make sure driver packages for moOde have been built for the particular kernel used in the image build

Configuration

The configuration files for the build are located in the subdirectory moode-cfg. The pi-gen-utils suite of utilities is used for making configuration easier.

Important files:

  • config - Contains the general configuration
  • stage2_05-moode-install_01-packages - Packages that are installed onto RaspiOS but aren't built from the moOde package repo for example NGINX and PHP
  • stage2_04-moode-install-prereq_00-run-chroot.sh - Prepares for package install for example setting up the moOde repo
  • stage2_05-moode-install_01-packages - Packages that are installed on top the Lite distribution (Note: package dependencies are automaticly installed)
  • stage3_02-moode-install-post_00-run-chroot.sh - Install rpi-update kernel, kernel drivers and configures apt-mark hold pacakges

Configure version specific list of packages

The file moode-cfg/stage3_01-moode-install_01-packages contains a list of packages and provides a way to specify the exact version of each package to be installed.

Note: The moode-player package is specified in this list so it's version should be verified before performing an image build.

Configure kernel version to be used

Currently an rpi-update kernel in used (non deb). The specific kernel to be used can be configured in moode-cfg/stage3_02-moode-install-post_00-run-chroot.sh

Configure moode image version

This can be set via the IMG_NAME parameter in the file moode-cfg/config.

Performing the build

Run the command below from the root directory of the imgbuild repo

./build.sh

Build time varies depending on system and network performance. Typical build time on Pi-4B 1GB with a Class 10 SD Card and Ethernet connection is around 1 hour.

About

Scripts to generate a custom OS image for moOde

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages