Peppermint Bubbles

From Mintarc Forge

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

The environments are as follows

  • xfce - for a XFCE Desktop
  • gnomefb - for a GNOME Flashback Desktop
  • openbox - for a OPENBOX Desktop
  • kde - for a KDE Desktop
  • loaded - for a XFCE Loaded System
  • server - for a SERVER system
  • mini - for a MINIMUM system

The architectures are as follows

  • deb64 - Build a Debian 64 ISO
  • deb32 - Build a Debian 32 ISO
  • dev64 - Build a Devuan 64 ISO
  • dev32 - Build a Devuan 64 ISO
  • debarm - Build a Debian ARM ISO
  • devarm - Build a Devuan 64 ISO

ISO Final Locations

  • All files are located:/var/www/html/nightly/
Retrieved from "https://matomo.mintarc.com/mediawiki/index.php?title=Peppermint_Bubbles&oldid=258"