86 lines
3.2 KiB
Markdown
86 lines
3.2 KiB
Markdown
|
# Bubbles
|
||
|
|
|
||
|
|
Bubbles is an ISO builder for debian based operating systems, written in python.
|
||
|
|
|
||
|
|
This application uses [GNU make](https://www.gnu.org/software/make/manual/make.html)
|
||
|
|
to bring all the modules together as a semi-automated build system.
|
||
|
|
|
||
|
|
It does use the debian live build tools to build and create the ISO.
|
||
|
|
|
||
|
|
Requirements needed to use Bubbles:
|
||
|
|
- debian live-build tools
|
||
|
|
- python3
|
||
|
|
- gnu make
|
||
|
|
|
||
|
|
**Usage** - The Peppermint ISO collection consists of:
|
||
|
|
- 32/64 bit
|
||
|
|
- ARM
|
||
|
|
- Systemd/NonSystemd
|
||
|
|
|
||
|
|
|
||
|
|
## Understand the folder structure
|
||
|
|
|
||
|
|
Every piece of the ISO broken down in to a modular structure i.e. the folder
|
||
|
|
structure you see in the **iso_configs**. Some folders are shared common files
|
||
|
|
that all ISOs will use other folders are broken down by specific architecture.
|
||
|
|
This makes it easier to scale and mainatain as things change over time.
|
||
|
|
|
||
|
|
Here is a grouping break-down of the folders
|
||
|
|
|
||
|
|
### Shared Folders
|
||
|
|
|
||
|
|
- aliases - for use of custom bash aliases
|
||
|
|
- application - the location for custom application .desktop files
|
||
|
|
- auto start - launches the welcome screen
|
||
|
|
- database - a place to puts any custom sqlite database files
|
||
|
|
- desktop_base - used to put custom, custome base themes
|
||
|
|
- face - set the login thumbnail
|
||
|
|
- font - any fonts that need to be installed
|
||
|
|
- hooks - confogurations that are used during the build process.
|
||
|
|
- id_files - used for build identification
|
||
|
|
- icons - put icons here to share them wil all builds.
|
||
|
|
- issue - version files for the syste, change to your build name /version
|
||
|
|
- lightdm - used for the light dm login manager
|
||
|
|
- menu - default menu settings
|
||
|
|
- neofetch - neofetch configurations
|
||
|
|
- PepProPixMaps - the peptools icons
|
||
|
|
- PepProTools - the Peppemrint tools executables
|
||
|
|
- plymouth - update the plymouth boot screens
|
||
|
|
- polkit - manage the policy kits settings
|
||
|
|
- profile - setup the default profile configuration
|
||
|
|
- theme - this will apply the themes to all your builds
|
||
|
|
- user_config - Default live user configuration
|
||
|
|
- wallpaper - stanard wallpaper location
|
||
|
|
- xfce - xfce configurations
|
||
|
|
- gnome-flashback - gnome flashback configurations
|
||
|
|
- openbox - open box configurations
|
||
|
|
- pmosyools - all the peppemrint os tools
|
||
|
|
- pylibraires - python libraires used for custom pep tools
|
||
|
|
|
||
|
|
|
||
|
|
### Architecture Specific
|
||
|
|
|
||
|
|
- info - Mirror and info settings
|
||
|
|
- multimedia - keys and repo settings
|
||
|
|
- sources - defaults repo sources list
|
||
|
|
- splash - Grub bood splash configurations
|
||
|
|
- os-release - OS version and tesgging settings
|
||
|
|
- calamares_settings - Calamares installer configurations
|
||
|
|
- grub - Manage the grub settings pers build.
|
||
|
|
Each folder in this area has subfolders broken down by:
|
||
|
|
- Debian 32/64/arm
|
||
|
|
- Devuan 32/64/arm
|
||
|
|
|
||
|
|
As you have a need to maintain separate configuration files for each build
|
||
|
|
this is where you place your files.
|
||
|
|
|
||
|
|
*For example:*
|
||
|
|
If you have Calamares Settings configuration files ONLY for the Devuan 32 bit
|
||
|
|
ISO, then you put those files in the /calamares_settings/dev_32/ directory.
|
||
|
|
|
||
|
|
Make any modifications to the fole in the configurations above.
|
||
|
|
When you have done that make sure you are in the bubbles directory.
|
||
|
|
Then in temerinal run for example ```make deb64``` to build the 64 bit iso.
|
||
|
|
if you want to run other builds you would use the make command with one of the
|
||
|
|
following deb32, dev64, dev32, debarm or devarm.
|