penguins-eggs

Penguins' eggs are generated and new birds are ready to fly...

Index

• Index
• Introduction
• Technology
• Features
• Packages
• Usage
• Commands
• Penguins' eggs official guide
• That's all Folks!

Introduction

penguins-eggs is a console tool, under continuous development, that allows you to remaster your system and redistribute it as live images on USB sticks or via PXE. The concept behind Penguins’ Eggs stems from the idea of “reproduction” and “population selection” applied to operating systems. During the era of popular remastering programs like Remastersys and Systemback, both of which experienced maintenance issues and were eventually abandoned, the need for a new, modern tool became evident. The inspiration for Penguins’ Eggs led to the development of a new tool written in a modern, cross-distribution language, utilizing its own packaging system. Initially built with node.js and later transitioning to Typescript as the primary development language, the tool’s design resembles an egg production process, consisting of operations such as “produce” for creating the eggs, “hatch” for installation, and other commands like “kill” for removing produced ISOs, “update” for software updates, and “install” for configuring the graphical installer. It also has prerequisites to install the .deb packages necessary for the process, namely, calamares.

> Considered a work-in-progress, the ultimate goal for Penguins’ Eggs is to implement a PXE server for local network distribution, drawing inspiration from the behavior of the cuckoo bird, which relies on others to hatch its eggs. Written primarily in TypeScript, Penguins’ Eggs is designed to be compatible with various Linux distributions, despite differences in package managers, file paths, and more. The tool currently supports Debian, Devuan, Ubuntu, Arch, Manjaro, and their derivatives, across multiple architectures including amd64, i386, and arm64. With the release of version 9.6.x, Penguins’ Eggs is now available as a Debian package, catering to a wide range of systems including PCs, older machines, and single-board ARM systems like the Raspberry Pi, across amd64, i386, and arm64 architectures. For more information and updates, visit the Penguins’ Eggs official website.

> [!TIP] > "Penguins-eggs" is an actively developed console tool designed to help you customize and distribute your system as live images on USB sticks or through PXE. By using this tool, you can remaster your system according to your preferences.

> [!TIP] > By default, "penguins-eggs" completely removes the system's data and users. However, it also offers the option to remaster the system while including the data and accounts of existing users. This can be done using the "--clone" flag. Additionally, you can preserve the users and files by storing them in an encrypted LUKS file within the resulting ISO file, which can be achieved with the "--cryptedclone" flag.

> [!TIP] > The resulting live system can be easily installed using either the Calamares installer or the internal TUI Krill installer. Furthermore, if you prefer an unattended installation, you can utilize the "--unattended" flag.

> [!TIP] > One interesting feature of "penguins-eggs" is its integration with the "penguins-wardrobe." This allows you to create or utilize scripts to switch between different configurations. For example, you can start with a bare version of the system, featuring only a command-line interface (CLI), and then easily transition to a full graphical user interface (GUI) or server configurations.

> [!NOTE] > For more information and customization options, you can explore "penguins-wardrobe," a related project. You can fork it and adapt it to meet your specific needs.

See penguins-wardrobe, fork it, and adapt it to your needs.

Technology

"eggs" is primarily written in TypeScript and is designed to be compatible with various Linux distributions. While there may be differences in package managers, paths, and other aspects, the underlying programs used to build the live system are generally the same. Currently, "eggs" supports several Linux distributions, including Debian, Devuan, Ubuntu, Arch, Manjaro and derivatives; and their derivatives. It also caters to different architectures, namely amd64, i386, and arm64. Starting from version 9.6.x, "Penguins' eggs" is released as a Debian package, available for amd64, i386, and arm64 architectures. This allows it to support a wide range of PCs, including older machines, as well as single-board ARM systems like the Raspberry Pi. You can learn more about this release in the article titled Triple Somersault! Triple somersault!. For more information on the supported distributions and architectures, you can visit the blog blog. Additionally, you can find examples of remastered ISO images created with "eggs" on the project's SourceForge page sourceforge page of the project.

penGUI take cure of eggs!

The development of a GUI for "penguins-eggs" with the penGUI project sounds promising. It's exciting to see that work on the GUI has started and is progressing rapidly. GUIs can greatly enhance the user experience and make it more accessible to a wider range of users. I hope the penGUI penGUI project continues to thrive and brings a user-friendly interface to "penguins-eggs". If you have any specific questions or need further information about the penGUI project, feel free to ask!

Features

Penguins-eggs is a versatile tool that offers an array of features and benefits for Linux users. Whether you want to create an installable ISO from your current Linux system or explore various customization options, Penguins-eggs has got you covered. To get started with Penguins-eggs, you'll need to install it on your Linux distribution. The tool supports a wide range of Linux distributions and their major derivatives, including Arch, Debian, Devuan, Manjaro, Ubuntu, and more. Additionally, you can easily add support for additional derivatives, expanding the tool's capabilities even further.

1. fast and efficient Penguins-eggs is designed to be fast and efficient. Unlike traditional methods that involve copying the entire file system, Penguins-eggs utilizes livefs, which allows for instant acquisition of the live system. By default, the tool.

2. Supports Compression Algorithm Employs the zstd compression algorithm, significantly reducing the time required for the process, often up to 10 times faster. When creating an installable ISO.

3. Supports Clone Penguins-eggs provides various options to suit your needs. With the --clone flag, you can preserve the data and accounts of unencrypted users, ensuring a seamless experience for users accessing the live system. Moreover, you can opt for a crypted clone, where user data and accounts are saved in an encrypted LUKS volume within the ISO image, enhancing security and privacy.

4. Cuckoo and PXE boot In addition to ISO creation, Penguins-eggs offers a unique feature called Cuckoo. By starting Cuckoo from the live system, you can set up a PXE boot server, making it accessible to all computers on the network. This functionality opens up possibilities for network booting and streamlined deployment. Penguins Eggs Linux ushers in a new era of innovation and convenience with its groundbreaking default feature, Cuckoo live network boot, which transforms any computer running Penguins Eggs into a PXE (Preboot eXecution Environment) boot server. This revolutionary paradigm of network booting and seamless deployment underscores Penguins Eggs Linux’s commitment to redefining the parameters of accessibility and efficiency within the realm of Linux distributions.

5. Supports Both TUI/GUI Installer To simplify the installation process, Penguins-eggs provides its own system installer called krill. This installer is particularly useful when a GUI (Graphical User Interface) is not available, allowing for installation in various situations. However, if you are using a desktop system, Penguins-eggs recommends and configures the calamares GUI installer, ensuring a seamless and user-friendly experience. Penguins Eggs Linux spearheads a transformative revolution in the realm of system installation with the incorporation of its TUI (Text-based User Interface) / GUI (Graphical User Interface) installer, setting a new standard of versatility and accessibility within the landscape of Linux distributions.

6. repository lists One of the key advantages of Penguins-eggs is its commitment to utilizing only the original distro's packages. This means that no modifications are made to your repository lists, ensuring a safe and reliable environment. Penguins-eggs prioritizes maintaining the integrity and authenticity of your Linux distribution.

7. Wardrobe To enhance customization options, Penguins-eggs introduces the concept of Wardrobe. With Wardrobe and its various components, such as costumes, you can easily organize and manage your customizations, samples, and more. This feature enables a streamlined and efficient workflow, allowing you to tailor your Linux system to your preferences.

8. supporting multiple distributions Eggs supporting multiple distributions and their derivatives Supports: Arch, Debian, Devuan, Manjaro, Ubuntu, and major derivatives: Linuxmint, KDE neon, EndeavourOS, Garuda, etc. You can easily add more derivatives.

9. supports hardware architectures supports a wide range of hardware architectures. Supports: i386, amd64 and arm64 architecture, from old PCs, and common PCs to single board computers like Raspberry Pi 4/5

10. Supports privacy and security Safe: only use the original distro's packages, without any modification in your repository lists. Penguins Eggs Linux embarks on a steadfast commitment to user security and system integrity through its default practice of exclusively utilizing original distributions’ packages without any modifications in the repository lists. This resolute dedication to maintaining the pristine authenticity of packages reinforces Penguins Eggs’ fundamental ethos of safety and reliability, fostering an environment characterized by unwavering trust in the integrity of the software ecosystem.

more features

More feautures.

Wardrobe, Themes, and Addons

In April 2022, the "wardrobe" feature was introduced to "eggs." This addition serves as a comprehensive tool to assist and streamline the process of creating a customized version of Linux, starting from a command-line interface (CLI) system. I have embraced wardrobe for all my editions to enhance convenience, enabling me to better organize, consolidate, and manage my work effectively. To add a unique touch to my customizations, I have assigned bird names to each edition. Except for the "naked" edition, there are various options available, including "Colibri," "eagle," "duck," "owl," and "chicks" under the bookworm and plastilinux distributions. bookworm and plastilinux,.Furthermore, under Waydroid on the eggs' SourceForge page, you can find "wagtail" and "warbier." I have high hopes that people will take an interest in wardrobe and consider forking the main repository to incorporate their own customizations. By collaborating, we can achieve significant progress that would be challenging for a single developer to accomplish. If you would like to delve deeper into the wardrobe, I recommend reading the Penguins' eggs blog Penguins' eggs blog. post titled Wardrobe: Colibri, Duck, Eagle, and Owl, which provides further insights into its features and benefits. Furthermore, addons, predominantly themes, have been organized under the vendor's folder in the penguin's wardrobe. I encourage utilizing your wardrobe for all your customization needs to maintain consistency and organization throughout your work.

> [!NOTE] > For detailed instructions on using a wardrobe, please consult the wardrobe users' guide wardrobe users' guide.

Clone/Cryptedclone

When creating a live distribution of your system, you have different options to consider: the default mode, clone, and cryptedclone. • The default mode, achieved by using the command "eggs produce," completely removes user data from the live distribution. This ensures that no private data remains in the live system.

• The "eggs produce --clone" command allows you to save both user data and system data directly in the generated ISO. This means that if someone obtains a copy of the ISO, they will be able to see and access the user data directly from the live system. It's important to note that this data is not encrypted, so it may not be suitable for sensitive information.

• On the other hand, the "eggs produce --cryptedclone" command saves the data within the generated ISO using a LUKS (Linux Unified Key Setup) volume. With this option, the user data will not be visible in the live system. However, it can be automatically reinstalled during the system installation process using the "krill" installer. Even if someone has the generated ISO, they won't be able to access the user data without the LUKS passphrase. This ensures that your data remains protected.

To summarize the available options:

• "eggs produce" (default): All private data is removed from the live system.

• "eggs produce --clone": All user data is included unencrypted directly in the live system.

• "eggs produce --cryptedclone": All user data is included encrypted within a LUKS volume inside the ISO. > [!TIP] > During the installation process, you can use the "krill" installer to restore your crypted data automatically. By running the command "sudo eggs install" with the "krill" installer, your encrypted data will be securely transferred and made available in the installed system.

calamares and krill

Calamares and Krill are powerful tools in the Eggs project calamares, offering versatile installation options for Linux systems. The Eggs project was specifically designed to utilize Calamares as the default system installer, providing users with the flexibility to customize their installations using themes. However, Eggs goes beyond Calamares by introducing its own installer called Krill, which focuses on command-line interface (CLI) installations, particularly for server environments.

Krill, like Calamares, adopts a CLI interface that closely resembles Calamares, ensuring a consistent user experience. Leveraging the same configuration files created by Eggs for Calamares, Krill maintains compatibility and allows for seamless transitions between desktop and server installations. By simply adding the flag during installation, Krill enables unattended installations, streamlining the process for system administrators. Fine-tuning installation parameters becomes effortless as the configuration values can be modified in the /etc/penguins-eggs.d/krill.yaml file, facilitating automated deployments.

> [!TIP] > Thanks to the Eggs project's integration of Calamares and the introduction of Krill, users can enjoy a comprehensive installation toolkit. Whether one prefers the graphical interface of Calamares or the command-line efficiency of Krill, Eggs caters to diverse installation needs, making Linux setup a breeze.

cuckoo

ust like the cuckoo bird lays its eggs in the nests of other birds, the Eggs project introduces a similar concept in the form of a self-configuring PXE service. This service allows you to boot and install your ISO on networked computers that are not originally configured for your specific ISO. With the command "cuckoo," you can deploy a newly created ISO on an already installed system, or you can live to boot the ISO itself. This means that you can either install your ISO on existing systems or directly run the ISO without the need for a permanent installation.

> [!TIP] > By leveraging the cuckoo command, the Eggs project provides a convenient method for deploying and testing your ISO on a variety of networked computers, expanding the possibilities for system installations and evaluations.

mom and dad

I have introduced two helpful built-in assistants: Mom and Dad. Mom, based on the easybashgui easybashgui script, serves as a comprehensive guide, providing explanations of various commands and documentation. This ensures that users have access to clear instructions and information as they navigate through Eggs' functionalities. On the other hand, Dad serves as a convenient shortcut for properly configuring Eggs. By simply typing sudo eggs dad and following the straightforward instructions, users can quickly configure Eggs to meet their specific requirements. For even faster configuration, utilizing the command sudo eggs dad -d allows for a complete reset of the configuration, loading default settings, and deleting any created ISOs. Once Eggs is properly configured, generating your live environment becomes a breeze. Just type sudo produce to effortlessly generate your live ISO. With this streamlined workflow, Eggs empowers users to efficiently create customized live environments tailored to their needs. Whether you rely on Mom's guidance or Dad's configuration shortcuts, Eggs offers a user-friendly experience for ISO creation and customization.

yolk

Yolk is a local repository that is bundled within the LiveCD of Eggs. This repository contains a carefully curated selection of essential packages required for installation. Yolk serves as a valuable resource, as it allows you to install your system confidently, even without an active internet connection. By including Yolk in the LiveCD, Eggs ensures that all the necessary packages are readily available during the installation process. This eliminates the dependency on an internet connection, making it possible to install your system in offline environments or situations where internet access is limited or unavailable. Yolk acts as a safety net, providing the minimum set of indispensable packages required for a successful installation. This guarantees a smooth and reliable installation experience, regardless of the availability of an internet connection. With Yolk by your side, you can confidently proceed with system installations, knowing that the essential packages are at your disposal.

Packages

Eggs offers support for a variety of packages. Specifically, for Debian, Devuan, and Ubuntu, Eggs utilizes .deb packages that are compatible with both amd_64 and i386 architectures. This ensures seamless integration with these distributions, allowing users to easily install and utilize Eggs' features. On the other hand, Arch and ManjaroLinux have their own packaging system known as PKGBUILDs. Eggs is designed to work harmoniously with these distributions, leveraging the specific packaging structure provided by PKGBUILDs. This ensures that Eggs can seamlessly integrate into Arch and ManjaroLinux environments, providing users with a consistent and optimized experience. By adapting to the packaging systems used by different distributions, Eggs ensures compatibility and ease of use across a wide range of Linux environments. Whether you're using Debian, Devuan, Ubuntu, Arch, or ManjaroLinux, Eggs is equipped to support your preferred distribution, enabling you to make the most of its features and functionalities.

Debian families

Eggs caters to the Debian family of distributions, offering a seamless installation experience through deb packages. These deb packages are available for multiple architectures, including amd64, i386, and arm64.The availability of Eggs as a deb package simplifies the installation process for users of Debian-based distributions. Whether you are running a 64-bit (amd64) or 32-bit (i386) architecture, or even an arm64 architecture, Eggs has you covered. This ensures that users across a wide range of Debian-based systems can easily download, install, and utilize Eggs' features. By providing deb packages for various architectures, Eggs promotes accessibility and inclusivity, allowing users on different hardware platforms to benefit from its functionality. Whether you're using a traditional desktop computer or an ARM-based device, Eggs ensures compatibility and a consistent experience across the Debian family of distributions.

The packages can be installed on Debian, Devuan, or Ubuntu-based distributions without the need to worry about the specific version. Whether you're using Buster, Bullseye, Bookworm, Trixie, Chimaera, Daedalus, Bionic, Focal, or Jammy, Eggs is reported to work across these versions. However, it's important to ensure compatibility with the respective processor architecture. The packages provided by Eggs include standard scripts for preinst, postinst, prerm, and postrm. These scripts play a crucial role in the installation and management of the packages. The preinst script is executed before the package is installed, allowing for any necessary preparations or configurations. The postinst script is executed after the package installation, enabling additional setup or customization. Similarly, the prerm script is executed before the package is removed, while the postrm script is executed after the package removal. In addition to the scripts, Eggs packages also include man pages. These man pages serve as documentation for the installed packages, providing detailed information on their usage, configuration options, and other relevant details. The inclusion of man pages ensures that users have access to comprehensive documentation, enabling them to effectively utilize and manage the Eggs packages. Overall, Eggs' packages offer a comprehensive and user-friendly experience, with standard scripts and detailed documentation, making installation and management hassle-free on Debian, Devuan, and Ubuntu-based distributions.

Install eggs

there are multiple methods available, but one of the most practical approaches is to utilize the penguins-eggs-ppa repository. The penguins-eggs-ppa repository provides a convenient and reliable way to access and install Eggs on your system. By adding this repository to your package manager's sources list, you gain access to the latest versions of Eggs and can easily install or update it with a few simple commands.Adding the penguins-eggs-ppa repository ensures that you have a trusted and official source for Eggs, which simplifies the installation process and ensures that you receive updates and security patches on time.By leveraging the penguins-eggs-ppa repository, you can enjoy the benefits of a streamlined installation process, convenient updates, and a reliable source for Eggs. It's a practical solution that allows you to effortlessly install and manage Eggs as a .deb package, enhancing your overall experience with this powerful software.

Download the package and install it with dpkg

To install Eggs, the simplest method is to download the package from the project's SourceForge page package eggs and install it on your system. You can find the Eggs package on the SourceForge page here. After downloading the appropriate package based on your system's architecture, you can proceed with the installation. If you are using an amd64 system, run the following command in the terminal: sudo dpkg -i eggs_9.6.24_amd64.deb For i386 systems, the command would be: sudo dpkg -i eggs_9.6.24_i386.deb Executing these commands will initiate the installation process and install Eggs on your system. Once Eggs is successfully installed, you have the option to enhance its functionality by adding the penguins-eggs-ppa repository. This repository provides additional tools and features for Eggs. To add the penguins-eggs-ppa repository, run the following command in the terminal: sudo eggs tools ppa --install This command will add the penguins-eggs-ppa repository to your system, allowing you to access updated versions of Eggs and additional tools provided by the repository. By following these steps, you can easily install Eggs, add the penguins-eggs-ppa repository, penguins-eggs-ppa, and unlock further capabilities and enhancements for your Eggs installation.

Using penguins-eggs-ppa (stable version)

To simplify the process of using the penguins-eggs-ppa repository and installing Eggs, you can utilize a utility called get-eggs. Follow these steps to use get-eggs:

1. Clone the get-eggs repository by running the following command:

git clone https://github.com/pieroproietti/get-eggs

2. Navigate into the get-eggs directory:

cd get-eggs

3. Execute the utility with root privileges:

sudo ./get-eggs

On Debian, Devuan, and Ubuntu, running get-eggs will add the penguins-eggs-ppa repository and install Eggs seamlessly. > [!TIP] > For derivatives of Debian, Devuan, and Ubuntu, such as Linuxmint, LMDE, etc., get-eggs will typically work as well. However, if needed, you can manually add the penguins-eggs-ppa repository by copying and pasting the following two lines into a terminal:

curl -fsSL https://pieroproietti.github.io/penguins-eggs-ppa/KEY.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/penguins-eggs.gpg
echo "deb [arch=$(dpkg --print-architecture)] https://pieroproietti.github.io/penguins-eggs-ppa ./" | sudo tee /etc/apt/sources.list.d/penguins-eggs.list > /dev/null

After adding the repository, update your package repositories and install Eggs by running the following command:

sudo apt update && sudo apt install eggs

Executing these commands will update your package sources and install Eggs on your system.

> [!TIP] > By using the get-eggs utility or manually adding the penguins-eggs-ppa repository, you can easily install Eggs on various Debian, Devuan, and Ubuntu-based distributions, including their derivatives, ensuring a smooth and hassle-free installation process.

Upgrade eggs

To upgrade Eggs, the process will vary depending on whether you are using the penguins-eggs-ppa repository or not. Here's how you can upgrade Eggs with both approaches: If you have already added the penguins-eggs-ppa repository, you can upgrade Eggs alongside other packages on your system by running the following command:

sudo apt upgrade

> [!TIP] > This command will check for updates for all installed packages, including Eggs, and upgrade them to their latest versions if available.

> [!NOTE] > On the other hand, if you have not added the penguins-eggs-ppa repository, you can manually upgrade Eggs by downloading the new version from the SourceForge page here. Once you have downloaded the appropriate package for your system architecture, follow these steps:

1. Install the package using the gdebi command (assuming you have gdebi installed):

sudo gdebi eggs_9.6.24_amd64.deb

or for i386 systems:

sudo dpkg -i eggs_9.6.24_i386.deb

2. In case of any missing dependencies, you can resolve them by running the following command:

sudo apt install -f

This will automatically install any required dependencies for Eggs. > [!TIP] > By following these instructions, you can upgrade Eggs either through the penguins-eggs-ppa repository or by manually downloading and installing the latest version from the SourceForge page. Ensure that you choose the appropriate method based on your current setup to keep Eggs up to date with the latest enhancements and bug fixes.

Arch families

Eggs have been available in the Arch User Repository (AUR) for quite some time, thanks to the support of the Arch Linux community. Although I was initially unaware of its presence, I am now directly maintaining the AUR version of penguins-eggs. Additionally, I am actively participating in the Manjaro Community Repository, specifically for the penguins-eggs package.

Being present in the AUR signifies that Eggs is available for Arch Linux users to easily install and manage through their package managers. The AUR is a community-driven repository that allows users to contribute and maintain packages that are not officially supported by Arch Linux. By maintaining the AUR version of penguins-eggs, I can ensure that Arch Linux users have access to the latest updates and improvements for Eggs.

> [!TIP] > Furthermore, my participation in the Manjaro Community Repository demonstrates my commitment to providing support for Eggs on the Manjaro distribution. Manjaro is a popular Arch-based Linux distribution known for its user-friendly approach and community-driven development. By actively contributing to the Manjaro Community Repository, I can ensure that Eggs remains compatible and well-integrated with the Manjaro ecosystem.

> [!TIP] > In summary, Eggs is available in the AUR and is directly maintained by me. Additionally, I am actively involved in the Manjaro Community Repository to provide support for Eggs on the Manjaro distribution. This ensures that users of Arch Linux and its derivatives, such as Manjaro, can easily access and benefit from using Eggs in their systems.

Arch

To install penguins-eggs on Arch Linux, there are multiple methods available. One option is to install it directly from the Arch User Repository (AUR) by adding the Chaotic-AUR repository. Here's how you can do it:

1. Add the Chaotic-AUR repository to your system. You can find the repository at https://aur.chaotic.cx/.

2. After adding the Chaotic-AUR repository, open a terminal and run the following command to install penguins-eggs using pacman:

sudo pacman -Sy penguins-eggs

This command will synchronize the package databases and install penguins-eggs on your system.

Alternatively, you can use a utility called get-eggs that I have written. Here's how to use it:

1. Clone the get-eggs repository by running the following command:

git clone https://github.com/pieroproietti/get-eggs

2. Change to the get-eggs directory:

cd get-eggs

3. Run the get-eggs script with sudo privileges:

sudo ./get-eggs

This script will add the AUR repository and install penguins-eggs on your system.

Additionally, you have the option to use the popular AUR helper tool called yay. Simply run the following command:

yay penguins-eggs

yay will handle the installation process for you, including any necessary dependencies.

If you prefer to build from source, you can download the sources from the AUR repository. Here are the steps:

1. Clone the penguins-eggs repository from the AUR:

git clone https://aur.archlinux.org/packages/penguins-eggs

2. Change to the penguins-eggs directory:

cd penguins-eggs

3. Build and install the package using makepkg:

makepkg -srcCi

> [!TIP] > This command will compile the source code, create a package, and install it on your system. These methods provide various ways to install penguins-eggs on Arch Linux, allowing you to choose the one that suits your preferences and workflow.

Manjaro

Starting from version 9.4.3, penguins-eggs is now included in the Manjaro community repository, making it even easier to install on Manjaro Linux. To install penguins-eggs on Manjaro, you can use the pamac package manager with the following command:

pamac install penguins-eggs

This command will fetch the package from the Manjaro community repository and install it on your system.

Alternatively, if you prefer to manually manage the installation process, you can clone the penguins-eggs package from the Manjaro community repository and build it from source. Here are the steps:

1. Clone the penguins-eggs package from the Manjaro community repository:

git clone https://gitlab.manjaro.org/packages/community/penguins-eggs/

2. Change to the penguins-eggs directory:

cd penguins-eggs

3. Build and install the package using makepkg:

makepkg -srcCi

> [!TIP] > This command will compile the source code, create a package, and install it on your system.

By including penguins-eggs in the Manjaro community repository, Manjaro Linux users can easily access and install the package using their preferred package manager. The Manjaro community repository is specifically dedicated to packages that are supported by the Manjaro community, ensuring that penguins-eggs is well-integrated and compatible with the Manjaro distribution.

> [!TIP] > Whether you choose to install penguins-eggs using pamac or by manually building it from source, you can enjoy the benefits of this package on your Manjaro Linux system.

Usage

Once the package has been installed, you can have the new eggs command. Typing eggs will get the list of commands, and typing eggs produce --help will get the eggs produce command help screen. You can also use the command autocomplete with the TABS key, you will get the possible choices for each command. In addition, there is a man page, so by typing man eggs you will get that help as well. You can also use the eggs mom command that interactively allows you to consult the help for all commands and online documentation.

Examples

Here are some examples of how to use penguins-eggs to create live systems with different configurations:

1. To create a live system without user data, run the following command with sudo:

sudo eggs produce

This command will generate a live system without any user data included.

2. To create a live system with user data that is not encrypted, use the --clone flag:

sudo eggs produce --clone

This command will produce a live system that includes user data without encryption.

3. If you want to create a live system with encrypted user data, use the --cryptedclone flag:

sudo eggs produce --cryptedclone

This command will generate a live system with encrypted user data.

By default, penguins-eggs uses fast compression for efficiency during the creation process. However, if you want a more compressed ISO file, you can use the --max flag during the final compression step. For example:

sudo eggs produce --max

> [!TIP] > This command will apply maximum compression to the ISO file, resulting in a smaller file size. In addition to the command descriptions provided in this README, you can refer to the Penguins' eggs official guide for more detailed information on how to use penguins-eggs and its various features. The official guide offers comprehensive documentation to help you make the most out of this tool.

Commands

• eggs adapt
• eggs analyze
• eggs autocomplete [SHELL]
• eggs calamares
• eggs config
• eggs cuckoo
• eggs dad
• eggs export deb
• eggs export iso
• eggs help [COMMAND]
• eggs install
• eggs kill
• eggs mom
• eggs produce
• eggs status
• eggs syncfrom
• eggs syncto
• eggs tools clean
• eggs tools ppa
• eggs tools skel
• eggs tools stat
• eggs tools yolk
• eggs update
• eggs version
• eggs wardrobe get [REPO]
• eggs wardrobe list [WARDROBE]
• eggs wardrobe show [COSTUME]
• eggs wardrobe wear [COSTUME]

eggs adapt

The eggs adapt command is used to adjust the monitor resolution specifically for virtual machines (VMs). It provides a convenient way to optimize the display settings within a VM environment. Here is the usage information for the eggs adapt command:

USAGE
  $ eggs adapt [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  adapt monitor resolution for VM only

To use the command, you simply need to run eggs adapt in the terminal. There are also two optional flags you can include:

• -h or --help: This flag displays the help information for the eggs adapt command, providing a brief description of its usage and available flags.
• -v or --verbose: Including this flag enables verbose mode, which provides more detailed output during the resolution adaptation process.

> [!NOTE] > Here is an example of how to use the eggs adapt command:

$ eggs adapt

> [!TIP] > By running this command, the monitor resolution will be adjusted specifically for the virtual machine environment. The eggs adapt command is particularly useful when working with VMs, as it allows you to optimize the display settings to match your specific requirements. Whether you need to adjust the resolution for better readability or to ensure compatibility with certain applications, the eggs adapt command provides a straightforward way to achieve the desired monitor configuration within your VM.

_See code: src/commands/adapt.ts

eggs analyze

The eggs analyze command is used to perform an analysis specifically for the syncto feature. It provides a way to examine and gather information related to the syncto functionality in the penguins-eggs tool. Here is the usage information for the eggs analyze command:

USAGE
  $ eggs analyze [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose  verbose

DESCRIPTION
  analyze for syncto

To use the command, you can simply run eggs analyze in the terminal. There are also two optional flags you can include:

• -h or --help: This flag displays the help information for the eggs analyze command, providing a brief description of its usage and available flags.
• -v or --verbose: Including this flag enables verbose mode, which provides more detailed output during the analysis process.

Here is an example of how to use the eggs analyze command:

sudo eggs analyze

By running this command with sudo, you initiate the analysis process specifically for the syncto feature. The eggs analyze command is a powerful tool for examining and gathering information related to syncto in penguins-eggs. It allows you to gain insights into the synchronization mechanism and analyze its behavior within your system. The analysis can help identify potential issues, optimize performance, and ensure the smooth operation of the syncto feature.

> [!TIP] > To explore the code implementation of the eggs analyze command, you can refer to the src/commands/analyze.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs analyze functionality, providing a deeper understanding of how the command is implemented and executed.

eggs autocomplete [SHELL]

The eggs autocomplete command is used to display installation instructions for setting up autocomplete functionality with the penguins-eggs tool in your preferred shell. Autocomplete allows you to conveniently auto-fill commands and options as you type, enhancing your productivity and reducing errors.

> [!TIP] > Here is the usage information for the eggs autocomplete command:

USAGE
  $ eggs autocomplete [SHELL] [-r]

ARGUMENTS
  SHELL  shell type

FLAGS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

DESCRIPTION
  display autocomplete installation instructions

To use the command, you can run eggs autocomplete in the terminal. There is also an optional SHELL argument that you can provide to specify your shell type. The available shell options include bash and zsh. If no shell is specified, general autocomplete installation instructions will be displayed. > [!TIP] > Additionally, there is an optional -r or --refresh-cache flag. When included, this flag refreshes the cache and ignores displaying the installation instructions.

Here are some examples of how to use the eggs autocomplete command:

$ eggs autocomplete

This command displays general installation instructions for autocomplete functionality.

$ eggs autocomplete bash

This command provides installation instructions specifically for the bash shell.

$ eggs autocomplete zsh

This command provides installation instructions specifically for the zsh shell.

$ eggs autocomplete --refresh-cache

This command refreshes the cache for autocomplete, without displaying any installation instructions. > [!TIP] > To explore the code implementation of the eggs autocomplete command, you can refer to the @oclif/plugin-autocomplete repository. This repository contains the source code responsible for the autocomplete functionality, providing a deeper understanding of its implementation and how it integrates with the penguins-eggs tool.

eggs calamares

The eggs calamares command is used to configure, install, or remove the Calamares tool. Calamares is a powerful installation framework that simplifies the process of setting up operating systems on various platforms. With the eggs calamares command, you can easily manage Calamares and its associated tasks.

Here is the usage information for the eggs calamares command:

USAGE
  $ eggs calamares [-h] [-i] [-n] [-r] [--remove] [--theme ] [-v]

FLAGS
  -h, --help           Show CLI help.
  -i, --install        install calamares and its dependencies
  -n, --nointeractive  no user interaction
  -p, --policies       configure calamares policies
  -r, --release        release: remove calamares and all its dependencies after the installation
  -v, --verbose
  --remove             remove calamares and its dependencies
  --theme=      theme/branding for eggs and calamares

DESCRIPTION
  configure calamares or install or configure it

> [!NOTE] > To use the command, you can run eggs calamares in the terminal. The command supports several flags and options:

• -h or --help: This flag displays the help information for the eggs calamares command, providing a brief description of its usage and available flags.
• -i or --install: Including this flag installs Calamares and its dependencies on your system.
• -n or --nointeractive: This flag enables non-interactive mode, where no user interaction is required during the Calamares configuration process.
• -p or --policies: Including this flag allows you to configure Calamares policies.
• -r or --release: This flag triggers the removal of Calamares and all its dependencies after the installation.
• -v or --verbose: Enabling this flag provides more detailed output.

There are two additional flags related to removing Calamares:

• --remove: Including this flag removes Calamares and its dependencies from your system.
• --theme=: This option allows you to specify a theme or branding for both the eggs tool and Calamares.

Here are some examples of how to use the eggs calamares command:

sudo eggs calamares

This command configures Calamares without installing or removing it.

sudo eggs calamares --install

This command installs Calamares and its dependencies on your system.

sudo eggs calamares --install --theme=/path/to/theme

This command installs Calamares and applies a specific theme or branding to both the eggs tool and Calamares.

sudo eggs calamares --remove

This command removes Calamares and its dependencies from your system.

> [!TIP] > To explore the code implementation of the eggs calamares command, you can refer to the src/commands/calamares.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs calamares functionality, providing a deeper understanding of how the command is implemented and executed.

eggs config

The eggs config command is used to configure and install the necessary Debian packages required to run the eggs tool. The eggs tool is a versatile utility that helps manage various tasks related to system configuration and administration. By running the eggs config command, you can easily set up the prerequisites and dependencies needed for the smooth execution of the eggs tool.

Here is the usage information for the eggs config command:

USAGE
  $ eggs config [-c] [-h] [-n] [-v]

FLAGS
  -c, --clean          remove old configuration before to create new one
  -h, --help           Show CLI help.
  -n, --nointeractive  no user interaction
  -N, --noicons        no icons

DESCRIPTION
  Configure and install prerequisites deb packages to run it

> [!NOTE] > To use the command, you can run eggs config in the terminal. The command supports several flags and options:

• -c or --clean: Including this flag will remove the old configuration before creating a new one. This allows for a fresh setup of the eggs tool.
• -h or --help: This flag displays the help information for the eggs config command, providing a brief description of its usage and available flags.
• -n or --nointeractive: This flag enables non-interactive mode, where no user interaction is required during the configuration process.
• -N or --noicons: Including this flag disables the display of icons during the configuration process.

The eggs config command is primarily responsible for configuring and installing the required Debian packages needed to run the eggs tool. It ensures that the necessary dependencies are in place, allowing for seamless execution of subsequent eggs commands.

Here are some examples of how to use the eggs config command:

sudo eggs config

This command configures and installs the prerequisite Debian packages without removing any old configuration.

sudo eggs config --clean

This command removes the old configuration before creating a new one, ensuring a fresh setup of the eggs tool.

sudo eggs config --clean --nointeractive

This command removes the old configuration and performs a fresh setup without requiring any user interaction. > [!TIP] > To explore the code implementation of the eggs config command, you can refer to the src/commands/config.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs config functionality, providing a deeper understanding of how the command is implemented and executed.

eggs cuckoo

The eggs cuckoo command is used to initiate a PXE start with proxy-dhcp using the eggs tool. PXE (Preboot Execution Environment) is a technology that allows computers to boot and install an operating system over a network connection. The eggs tool leverages this functionality to facilitate the PXE start process with the help of a proxy-dhcp server.

Here is the usage information for the eggs cuckoo command:

USAGE
  $ eggs cuckoo [-h]

FLAGS
  -h, --help  Show CLI help.

DESCRIPTION
  PXE start with proxy-dhcp

> [!NOTE] > To use the command, you can run eggs cuckoo in the terminal. The command supports a single flag:

• -h or --help: This flag displays the help information for the eggs cuckoo command, providing a brief description of its usage.

The primary purpose of the eggs cuckoo command is to initiate a PXE start process with the assistance of a proxy-dhcp server. This allows the system to boot and install an operating system using network resources. By running this command, you can initiate the PXE start process seamlessly with the necessary configurations in place.

Here is an example of how to use the eggs cuckoo command:

sudo eggs cuckoo

This command initiates the PXE start process with proxy-dhcp by leveraging the eggs tool. It ensures that the necessary configurations are in place to facilitate the booting and installation of an operating system over the network. > [!TIP] > To explore the code implementation of the eggs cuckoo command, you can refer to the src/commands/cuckoo.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs cuckoo functionality, providing a deeper understanding of how the command is implemented and executed.

eggs dad

The eggs dad command is used to seek assistance from a "daddy" figure, acting as a TUI (Text User Interface) configuration helper within the eggs tool. This command allows users to get guidance and support for configuring their system settings and options. By running the eggs dad command, users can interact with the TUI configuration helper to receive help and make necessary changes.

Here is the usage information for the eggs dad command:

USAGE
  $ eggs dad [-c] [-d] [-h] [-v]

FLAGS
  -c, --clean    remove old configuration before to create
  -d, --default  remove old configuration and force default
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  ask help from daddy - TUI configuration helper

> [!NOTE] > To use the command, you can run eggs dad in the terminal. The command supports several flags and options:

• -c or --clean: Including this flag will remove the old configuration before creating a new one. This allows for a fresh setup of the configuration settings.
• -d or --default: Including this flag will remove the old configuration and enforce the default settings. This can be useful when reverting back to the default configuration.
• -h or --help: This flag displays the help information for the eggs dad command, providing a brief description of its usage and available flags.
• -v or --verbose: Including this flag enables verbose mode, providing more detailed information during the configuration process.

The eggs dad command acts as a TUI configuration helper, allowing users to seek assistance from the "daddy" figure. It provides guidance and support for configuring system settings, ensuring a smooth and user-friendly experience.

Here are some examples of how to use the eggs dad command:

sudo eggs dad

This command initiates the TUI configuration helper, allowing users to seek help and guidance for configuring system settings.

sudo eggs dad --clean

This command removes the old configuration before creating a new one, ensuring a fresh setup of the configuration settings.

sudo eggs dad --default

This command removes the old configuration and enforces the default settings, reverting back to the default configuration. > [!TIP] > To explore the code implementation of the eggs dad command, you can refer to the src/commands/dad.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs dad functionality, providing a deeper understanding of how the command is implemented and executed.

eggs export deb

The eggs export deb command is used to export Debian packages (deb), documentation files (docs), or ISO images to a specified destination host using the eggs tool. This command enables users to transfer these files from one system to another conveniently. By running the eggs export deb command, users can export the desired files to the destination host.

Here is the usage information for the eggs export deb command:

USAGE
  $ eggs export deb [-a] [-c] [-h] [-v]

FLAGS
  -a, --all      export all archs
  -c, --clean    remove old .deb before to copy
  -h, --help     Show CLI help.
  -v, --verbose  verbose

DESCRIPTION
  export deb/docs/iso to the destination host

> [!NOTE] > To use the command, you can run eggs export deb in the terminal. The command supports several flags and options:

• -a or --all: Including this flag will export all available architectures. This allows for exporting files for multiple architectures simultaneously.
• -c or --clean: Including this flag will remove the old .deb files before copying the new ones. This ensures a clean transfer of files to the destination host.
• -h or --help: This flag displays the help information for the eggs export deb command, providing a brief description of its usage and available flags.
• -v or --verbose: Including this flag enables verbose mode, providing more detailed information during the export process.

The eggs export deb command facilitates the export of Debian packages, documentation files, or ISO images to the destination host. This allows users to transfer these files conveniently and efficiently. Here are some examples of how to use the eggs export deb command:

eggs export deb

This command exports the specified Debian packages, documentation files, or ISO images to the destination host.

eggs export deb --clean

This command removes the old .deb files before copying the new ones, ensuring a clean transfer of files to the destination host.

eggs export deb --all

This command exports the files for all available architectures, facilitating the transfer of files for multiple architectures simultaneously. > [!TIP] > To explore the code implementation of the eggs export deb command, you can refer to the src/commands/export/deb.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs export deb functionality, providing a deeper understanding of how the command is implemented and executed.

eggs export iso

The eggs export iso command is used to export ISO images to a specified destination host using the eggs tool. This command allows users to transfer ISO images from one system to another conveniently. By running the eggs export iso command, users can export the desired ISO image to the destination host.

Here is the usage information for the eggs export iso command:

USAGE
  $ eggs export iso [-c] [-h] [-v]

FLAGS
  -c, --clean    delete old ISOs before to copy
  -C, --checksum  export checksums md5 and sha256
  -h, --help     Show CLI help.
  -v, --verbose  verbose

DESCRIPTION
  export iso in the destination host

> [!NOTE] > To use the command, you can run eggs export iso in the terminal. The command supports several flags and options:

• -c or --clean: Including this flag will delete the old ISO images before copying the new ones. This ensures a clean transfer of ISO images to the destination host.
• -C or --checksum: Including this flag will export the checksums (md5 and sha256) for the ISO images. This provides additional verification for the integrity of the transferred ISO images.
• -h or --help: This flag displays the help information for the eggs export iso command, providing a brief description of its usage and available flags.
• -v or --verbose: Including this flag enables verbose mode, providing more detailed information during the export process.

The eggs export iso command facilitates the export of ISO images to the destination host. This allows users to conveniently transfer ISO images from one system to another.

Here are some examples of how to use the eggs export iso command:

eggs export iso

This command exports the specified ISO image to the destination host.

eggs export iso --clean

This command deletes the old ISO images before copying the new ones, ensuring a clean transfer of ISO images to the destination host.

> [!TIP] > To explore the code implementation of the eggs export iso command, you can refer to the src/commands/export/iso.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs export iso functionality, providing a deeper understanding of how the command is implemented and executed.

eggs help [COMMAND]

The eggs help [COMMAND] command is used to display help information for the eggs tool. This command provides users with detailed instructions and explanations on how to use specific commands or the eggs tool in general. By running the eggs help [COMMAND] command, users can access comprehensive documentation and guidance.

Here is the usage information for the eggs help [COMMAND] command:

USAGE
  $ eggs help [COMMAND] [-n]

ARGUMENTS
  COMMAND  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for eggs.

> [!NOTE] > To use the command, you can run eggs help [COMMAND] in the terminal. The command supports the following arguments and flags:

• COMMAND: This is an optional argument that specifies the particular command for which you want to view help information. By providing a command name, you can access detailed instructions and explanations for that specific command.
• -n or --nested-commands: Including this flag will include all nested commands in the output. This means that not only the specified command's help information will be displayed but also the help information for any sub-commands or nested commands associated with it.

The primary purpose of the eggs help [COMMAND] command is to provide users with detailed guidance and documentation for the eggs tool. It allows users to access comprehensive information about commands, their usage, and available options. > [!TIP] > To explore the code implementation of the eggs help [COMMAND] command, you can refer to the @oclif/plugin-help file in the plugin-help GitHub repository. This file contains the source code responsible for the eggs help [COMMAND] functionality, providing a deeper understanding of how the command is implemented and executed.

eggs install or eggs krill

The eggs install or eggs krill command is used to install the CLI system installer called "krill" using the eggs tool. This command allows users to conveniently install the krill CLI system installer, which is represented metaphorically as an egg transforming into a penguin. The installation process provides various options and configurations to cater to different installation requirements.

Here is the usage information for the eggs install or eggs krill command:

USAGE
  $ eggs install [-k] [-c ] [-d ] [-H] [-h] [-i] [-n] [-N] [-p] [-r] [-s] [-S] [-u] [-v]

FLAGS
  -H, --halt            Halt the system after installation
  -N, --none            Swap none: 256M
  -S, --suspend         Swap suspend: RAM x 2
  -c, --custom=  custom unattended configuration
  -d, --domain=  Domain name, default: .local
  -h, --help            Show CLI help.
  -i, --ip              hostname as IP, e.g., ip-192-168-1-33
  -k, --crypted         Crypted CLI installation
  -n, --nointeractive   no user interaction
  -p, --pve             Proxmox VE install
  -r, --random          Add random to hostname, e.g., colibri-ay412dt
  -s, --small           Swap small: RAM
  -u, --unattended      Unattended installation
  -v, --verbose         Verbose

DESCRIPTION
  krill: the CLI system installer - the egg became a penguin!

> [!NOTE] > To use the command, you can run eggs install or eggs krill in the terminal. The command supports numerous flags and options to customize the installation process:

• -H or --halt: Including this flag will halt the system after installation.
• -N or --none: Including this flag will configure no swap memory allocation (256M).
• -S or --suspend: Including this flag will configure swap memory allocation as double the RAM size.
• -c or --custom=: This option allows users to provide a custom unattended configuration for the installation.
• -d or --domain=: This option specifies the domain name for the installation. The default is set to .local.
• -h or --help: This flag displays the help information for the eggs install or eggs krill command, providing a brief description of its usage and available flags.
• -i or --ip: Including this flag will use the hostname as an IP address, such as ip-192-168-1-33.
• -k or --crypted: Including this flag enables crypted CLI installation.
• -n or --nointeractive: Including this flag ensures a non-interactive installation process, without requiring any user interaction.
• -p or --pve: Including this flag specifies a Proxmox VE installation.
• -r or --random: Including this flag adds a random string to the hostname, such as colibri-ay412dt.
• -s or --small: Including this flag configures swap memory allocation based on the RAM size.
• -u or --unattended: Including this flag enables unattended installation.
• -v or --verbose: Including this flag enables verbose mode, providing more detailed information during the installation process.

The primary purpose of the eggs install or eggs krill command is to install the krill CLI system installer. This allows users to configure and customize the installation process based on their specific requirements.

Here are some examples of how to use the eggs install or eggs krill command:

sudo eggs install

This command installs the krill CLI system installer.

sudo eggs install --unattended

This command performs an unattended installation of the krill CLI system installer.

sudo eggs install --custom it

This command installs the krill CLI system installer using a custom unattended configuration named "it". > [!TIP] > To explore the code implementation of the eggs install or eggs krill command, you can refer to the src/commands/install.ts file in the penguins-eggs GitHub repository. This file contains the source code responsible for the eggs install or eggs krill functionality, providing a deeper understanding of how the command is implemented and executed.

eggs kill

The eggs kill command is used to terminate and remove eggs, metaphorically representing freeing the nest. This command allows users to delete eggs and perform additional actions related to the nest.

Here is the usage information for the eggs kill command:

USAGE
  $ eggs kill [-h] [-n] [-v]

FLAGS
  -h, --help           Show CLI help.
  -i, --isos           Erase all ISOs on remote mount
  -n, --nointeractive  No user interaction
  -v, --verbose        Verbose

DESCRIPTION
  Kill the eggs/free the nest

> [!NOTE] > To use the command, you can run eggs kill in the terminal. The command supports several f