A Raspberry Pi and other ARM devices distribution builder. CustomPiOS opens an already existing image, modifies it and repackages the image ready to ship.
This repository contains the source script to generate a distribution out of an existing Raspbian distro image, or Armbian devices.
Where to get it?
Clone this repo for now, we are still new. Then follow instructions.
How to use it?
- Clone this image
git clone https://github.com/guysoft/CustomPiOS.git
src/make_custom_pi_os -g <distro folder>in the repo, distro folder should not exist and contain no spaces. This will both create a folder to build a new distro from, and also download the latest raspbian lite image. The initial distro has a module that has the name of your distro, and you can find it under
<distro folder>/src/modules/<distro name>(there should be only one module in the modules folder).
- cd to
- Edit your
<distro folder>/src/config, you can also edit the starting module, which is named as your distro at
modules/<dstro name>. More on that in the Developing section.
<distro folder>/src/build_distto build an image. If this failes use the method discribed in the vagrant build the section (which makes sure sfdisk and other things work right).
- Modules - write one module and use if for multiple distros
- Write only the code you need for your distro - no need to maintain complicated stuff like building kernels unless its actually want to do it
- Standard modules give extra functionality out of the box
- Supports over 40 embedded devices using Armbian and Raspbian.
- Downloaded Raspbian image.
- root privileges for chroot
- sudo (the script itself calls it, running as root without sudo won't work)
- Python 3.2+
Known to work building configurations
- Linux (Ubuntu / Debian etc)
- OS X - See this tread for information
This is where the stuff you want to execute inside the distro is written.
start_chroot_script write the main code, you can use
end_chroot_script to write cleanup functions, that are run at the end of the module namespace.
Useful commands from common.sh
CustomPiOS comes with a script
common.sh that has useful functions you can use inside your chroot_script.
To use it you can add to your script
unpack [from_filesystem] [destination] [owner] - Lets you unpack files from the
filesystem folder to a given destination.
[owner] lets you set which user is going to be the owner. eg.
unpack /filesystem/home/pi /home/pi pi
gitclone <MODULE_NAME>_<REPO_NAME>_REPO destination - Lets you clone a git repo, and have the settings preset in the
config file. Example usage in OCTOPI module.
gitclone OCTOPI_OCTOPRINT_REPO OctoPrint
[ -n "$OCTOPI_OCTOPRINT_REPO_SHIP" ] || OCTOPI_OCTOPRINT_REPO_SHIP=https://github.com/foosel/OctoPrint.git
Export files from image
CustomPiOS has a feature to export files created in the chroot to archives you can ship as a tar.gz arcive.
To export run inside of a chroot_script:
custompios_export [name of archive] [file path in chroot]
You can also use:
copy_and_export [name of archive] [source] [destination]
copy_and_export_folder [name of archive] [folder] [destination]
The results would be saved in the workspace folder.
Lets you add files to your distro, and save them to the repo. The files can be unpacked using the
unpack command that is in
This is where you can create module-specific settings. They can then be overwritten in a distro or variant. The naming convention is the module name in
Build a Distro From within Raspbian / Debian / Ubuntu / CustomPiOS Distros
Building Distro Variants
Building Using Vagrant
- If needed, override existing config settings by creating a new file
src/config.local. You can override all settings found in
src/config. If you need to override the path to the Raspbian image to use for building yoru dstro, override the path to be used in
BASE_ZIP_IMG, which is part of the base module. By default the most recent file matching
src/imagewill be used.
- The final image will be created at the
List of Distributions using CustomPiOS
- OctoPi - The ready-to-go Raspberry Pi image with OctoPrint
- FullPageOS - A raspberrypi distro to display a full page browser on boot
- ElectricSheepPi - A Raspberry Pi distribution to run Electric Sheep digital art
- AlarmPi - A Raspberry Pi distribution that turns a raspberrypi to an IOT telegram-controlled alarm clock
- RealtimePi - An out-of-the-box raspebrrypi/raspbian distro with a realtime kernel
- RMS Pi - Raspberry Pi Distro for Winlink RMS
- V1PI - Use your raspberry pi to control your V1Engineering machine
- HotSpotOS - Makes a Raspberrypi start a hotspot, if no wifi was found to conenct to
Code contribution would be appreciated!