bubbles/README.md

83 lines
2.0 KiB
Markdown
Raw Normal View History

2023-07-11 06:48:53 +00:00
# Bubbles
2023-07-11 06:46:38 +00:00
2023-07-11 06:48:53 +00:00
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, ARM and Systemd/NonSystemd ISOs.
## 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 here is grouping break-down of the folders
### Shared Folders
- aliases
- application
- database
- desktop_base
- font
- gksudo
- grub
- hooks
- icons
- issue
- lightdm
- menu
- packages
- PepProPixMaps
- PepProTools
- plymouth
- polkit
- profile
- theme
- user_config
- wallpaper
- xfce
### Architecture Specific
- info
- multimedia
- sources
- splash
- os-release
- calamares_settings
- os-release
- sources
- splash
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 seperate 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.
At this point what you need to do is add all your configuration settings in the
folders listed 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.