Peppermint Bubbles

Peppermint Bubbles

Bubbles is an ISO builder, using Python, that supports multiple operating systems. It is capable of creating ISO images for both Debian and Devuan-based distributions. Targeting 64-bit, 32-bit, or ARM platforms.

Requirements needed to use Bubbles

• debian live-build tools
• python

Folder and File Structure

iso_configs

This folder is used to contain all the configuration files, used to compile the ISOs

• aliases - the bash aliases
• application - the .desktop files
• autostart - the files that are used for auto starting
• browser_profiles - browser profiles, used for the Kumo SSB,
• build_types - files used to compile the correct ISO
• calamares_settings - all the Calamares installer configurations files for the installer
• desktop_base - Debian specific, theming files for plymouth and grub
• face - user profile, avatar
• font - default font used for the system
• gnome-flashback - desktop configurations for this desktop
• grub - grub boot configurations
• hooks - files used to run scripts inside the chroot, files.
• icons - icons, that are installed in the iso
• id_files - chroot, file identification
• info - system info and mirrors
• installer - Debian installer configuration files.
• issue - issue configuration files
• kde - this desktop's configuration files
• lightdm - login manager configurations
• loaded - the loaded configuration files
• logs - bubbles logs output
• menu - the system menu configurations
• multimedia - multimedia repos
• openbox - this desktops configurtions
• osrelease - system release configuration for peppermint
• PepProPixMaps - Peptools icon files
• PepProTools - the peppermint tools executable files
• plymouth - plymouth configuration files.
• pmostools - peppermint tool box.
• polkit - polkit configurations
• profile - the skel profile, configurations
• pylibraries - peppermint specific python libraries
• server - server build configurations files
• sources - system sources configurations
• splash - boot splash files.
• theme - themes installed in the ISO
• user_config - Peppermint live user config
• wallpaper - wallpaper used for the ISO
• xfce - desktop configurations

python_modules

This folder is the python project folder used to run bubbles.

• conf_modules - contains the the following
  • conf.py - used to configure the series of commands that are used run bubbles
  • lbset_commands.py - used to set up the live build required structure
• final_modules
  • file_mapping.py - Maps the file type to focus on for the building process
  • finish_cleanup.py - Clean up the working folder and move ISO and other files to their final location
• inflate_modules - build the needed structure for bubbles
  • inflate_bubble.py - These functions will build the base of the fusato build folders
• infra_modules - created the basic folders and files to begin the build
  • desktop_configs.py - This module contained the functions that will copy the desktop configuration files to their expected locations.
  • infra_general.py - Set the infrastructure for bubbles to begin the ISO build
  • installer_infra.py - Set the installer infrastructure for bubbles while building the ISO
• lists_modules - modules with lists that are sued through out bubbles
  • lists_binary.py - These are all the binary structure settings
  • lists_buildtypes.py - These dictionaries are used to store the build types used by bubbles.
  • lists_desktop_environment.py - These lists are used to install desktop environment packages
  • lists_firmware.py - These lists are used to install firmware packages
  • lists_grub.py - These lists are used to install grub packages
  • lists_login_manager.py - These lists are used to install login manager packages
  • lists_shared.py - These lists are used to install shared packages packages
  • lists_system.py - These lists are used to install general system packages
  • lists_uncategorized.py - These lists are used to install packages not in any common category
• logger_modules
  • logger_config.py - This is logger module is used to set the log function for bubbles
• paths_modules
  • paths.py - These are paths that are used throughout the bubbles eco systems
• build_iso.py - Main build file used to compile the ISOs for the system to be deployed

How to use bubbles

To use bubbles run commands as follows

python -m python_modules.build_iso -e [environment] -b [architecture]

For example: python3 -m python_modules.build_iso -e mini -b deb64

• -e is the argument for the environment
• -b is the argument for the architecture