Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pieroproietti/penguins-eggs

On the road of Remastersys, Refracta, Systemback and father Knoppix!
https://github.com/pieroproietti/penguins-eggs

alpine amd64 archlinux arm64 btrfs debian devuan fedora i386 installer live manjaro pureos pxe remaster ubuntu

Last synced: 4 days ago
JSON representation

On the road of Remastersys, Refracta, Systemback and father Knoppix!

Awesome Lists containing this project

README 

        
penguins-eggs

=============



## Penguin's eggs are generated and new birds are ready to fly...

[![sources](https://img.shields.io/badge/github-sources-cyan)](https://github.com/pieroproietti/penguins-eggs)

[![www](https://img.shields.io/badge/www-blog-cyan)](https://penguins-eggs.net)

[![telegram](https://img.shields.io/badge/telegram-group-cyan)](https://t.me/penguins_eggs)

[![isos](https://img.shields.io/badge/images-ISO-blue)](https://sourceforge.net/projects/penguins-eggs/files/ISOS)

[![pkg](https://img.shields.io/badge/packages-bin-blue)](https://sourceforge.net/projects/penguins-eggs/files/Packages)

[![ver](https://img.shields.io/npm/v/penguins-eggs.svg)](https://npmjs.org/package/penguins-eggs)



# Index



* [Index](#index)

* [Installation](#installation)

* [Introduction](#introduction)

* [Technology](#technology)

* [Features](#features)

* [Packages](#packages)

* [Usage](#usage)

* [Commands](#commands)

* [penGUI](#pengui)

* [Star History](#star-history)

* [Copyright and licenses](#copyright-and-licenses)



## Links

  * [Blog](https://penguins-eggs.net/blog)

  * [Cook eggs in 5 minutes!](https://penguins-eggs.net/docs/Tutorial/eggs5)

  * [Users guide](https://penguins-eggs.net/docs/Tutorial/eggs-users-guide)

  * [Wardrobe users' guide](https://penguins-eggs.net/docs/Tutorial/wardrobe-users-guide)

  * [Penguins' eggs book](https://penguins-eggs.gitbook.io/book)

  * [FAQ](https://penguins-eggs.net/docs/faq)

  * [Changelog](https://github.com/pieroproietti/penguins-eggs/blob/master/CHANGELOG.md#changelog)



# Installation



## penguins-eggs-10.0.x installation

`penguins-eggs-10.0.x` depend on `nodejs >18`, not directly available in all the distros. We can rely on [nodesource](https://github.com/nodesource/distributions?tab=readme-ov-file#debian-and-ubuntu-based-distributions) adding them.



### using get-eggs

It's the most pratical way and is valid for Alpine, Arch, Debian, Devuan and Ubuntu. get-eggs configure automatically `nodesource` when need and install the right package. Copy and paste:

```

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

cd get-eggs

sudo ./get-eggs.sh

```

### Manual installation



#### Arch, Manjaro, Debian 12 bookworm, Ubuntu 24.04

Just download and install penguins-eggs-10.0.x.



#### Debian 10 buster, Debian 11 bullseye, Ubuntu 20.04, Ubuntu 22.04

Before to install `penguins-eggs-10.x` add the repos from `nodesource`, follow this [indications](https://github.com/pieroproietti/penguins-eggs/issues/368) to get `nodejs>18` available.



#### Debian 9 stretch, Ubuntu 18.04 bionic

Use the package `penguins-eggs-10.x.x-bionic-x` - compilated against node16 - and follow this [indications](https://github.com/pieroproietti/penguins-eggs/issues/368#issuecomment-2169961955) to get `nodejs>16` available.



### AlpineLinux, Fedora and openSuSE

There is no installation package for this distros, but is simple to install penguins-eggs from sources as described [here](https://github.com/pieroproietti/penguins-eggs/tree/master/PREREQUISITES#prerequisites). 



Volunteer to package penguins-eggs on these three distributions? Contact me.



# Introduction



`penguins-eggs` is the package name of `eggs` 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 javascript and then switched to Typescript as the main development language, the design of the tool resembles an egg production process, consisting of operations such as produce to create the eggs and hatch to install them (I changed a bit later: from hatch to install, then to krill as a tribute to calamares tribes).



Other commands follow: like `kill` for removing produced ISOs, `calamares` for configuring the graphical installer, `mom` as interactive help, `dad` to configure eggs, `status`, `tools`, etc.



Considered a work-in-progress, the ultimate goal of Penguins' Eggs is to allow the creation of live ISOs from an installed system and their use for system installations.  It can be used both to create images on USB devices - even [Ventoy](https://www.ventoy.net/en/index.html) - and as a PXE server to distribute the image itself over a local network. Inspired by the behavior of the cuckoo bird, which depends 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. 



From the release of version 9.6.x, Penguins’ Eggs is available as a [Debian package](https://sourceforge.net/projects/penguins-eggs/files/DEBS/), then was extended to Arch Linux creating the relative [PKGBUILD](https://aur.archlinux.org/packages/penguins-eggs), nowday eggs can remaster Alpine Linux, Fedora, openSuSE but this distros not have a package yet.



So, 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](https://penguins-eggs.net).



 > [!TIP]

>   `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, `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, using `krill`, you can easily get an unattended installation, utilizing `--unattended` and various [krill](#eggs-krill) flags.



> [!TIP]

>  One interesting feature of `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](https://github.com/pieroproietti/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 [Arch](https://archlinux.org/), [Debian](https://www.

debian.org/), [Devuan](https://www.devuan.org/), [Manjaro](https://manjaro.org/), [Ubuntu](https://ubuntu.com/) and [derivatives](./conf/derivatives.yaml).



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!](https://penguins-eggs.net/blog/triple-somersault).



For more information on the supported distributions and architectures, you can visit the blog [blog](https://penguins-eggs.net/blog/distros-that-can-be-remastered-with-eggs). 



Additionally, you can find examples of remastered ISO images created with `eggs` on the project's SourceForge page [sourceforge page of the project](https://sourceforge.net/projects/penguins-eggs/files/ISOS/).



# 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: Alpine, Arch, Debian, Fedora, Devuan, Manjaro, Ubuntu,

 and major derivatives like: Linuxmint, KDE neon, EndeavourOS, Garuda, etc. You can easily add more derivatives.



10. 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



11. 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.



## Wardrobe, Themes, and Addons

 In April 2022, the `wardrobe` command 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](https://sourceforge.net/projects/penguins-eggs/files/ISOS/debian/bookworm/)  and [plastilinux](https://sourceforge.net/projects/penguins-eggs/files/ISOS/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](https://penguins-eggs.net/blog/wardrobe-colibri-duck-eagle-and-owl/). 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](https://penguins-eggs.net/docs/Tutorial/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](https://calamares.io), 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 adopts a TUI 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 

 Just 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](https://github.com/BashGui/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 eggs 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 `penguins-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, Focal, Jammy or Noble, `eggs` is reported to work across these versions. However, it's important to ensure compatibility with the respective processor architecture.



Ubuntu bionic cannot install nodejs >16, so I packaged a specific version for bionic, still largely used.



The packages `penguins-eggs` provided 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, `penguins-eggs` package also include man pages, bash-completion and other.



 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, lately I prefer `get-eggs` way, working for all the supported distros: Arch, Debian, Devuan, Manjaro, Ubuntu and derivatives.:



 ```

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

 cd get-eggs

 sudo ./get-eggs.sh

 ```



`get-eggs` on Debian families add automatically the `penguins-eggs-ppa` repository and, when need, add `nodesource` repository. On Arch, `chaotic-aur` repo will be added.



This let to install, update, remove `penguins-eggs` like a native package.



#### Debian families

`penguins-eggs-10.0.x` depend on `nodejs >18`, not directly available in all the distros. We can rely on [nodesource](https://github.com/nodesource/distributions?tab=readme-ov-file#debian-and-ubuntu-based-distributions) adding them.



##### Download and install penguins-eggs from sourceforge

 To install Eggs, the simplest method is to download the package `penguins-eggs` from the project's SourceForge page  [package eggs](https://sourceforge.net/projects/penguins-eggs/files/DEBS/) and install it on your system.



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 penguins_eggs_10.0.x-1_amd64.deb```



For i386 systems, the command would be:

```sudo dpkg -i penguins_eggs_10.0.x-1_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](https://pieroproietti.github.io/penguins-eggs-ppa), and unlock further capabilities and enhancements for your Eggs installation.



##### Using penguins-eggs-ppa

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 penguins_eggs

```



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



#### 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](https://sourceforge.net/projects/penguins-eggs/files/DEBS/). 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 penguins_eggs_10.0.x-1_amd64.deb

```

or for i386 systems:

```

sudo dpkg -i penguins_eggs_10.0.x-1_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](https://aur.archlinux.org/packages/penguins-eggs). Additionally, I am actively participating in the Manjaro Community Repository, specifically for the [penguins-eggs](https://gitlab.manjaro.org/packages/community/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/](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`. This script will add the AUR repository and install penguins-eggs on your system.



It's possible too 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.



## Compression

By default, penguins-eggs uses fasted compression `zstd level 3` for efficiency during the creation process. However, if you want a more compressed ISO file, you can chooce `--pendrive` flag `zstd level 15` optimized for pendrives, `--standard` flag, use  `xz`, or `--max` flag using `xz -Xbcj` to get the maximun level of compression. For example:



```

sudo eggs produce 

sudo eggs produce --pendrive

sudo eggs produce --standard

sudo eggs produce --max

```

> [!TIP]

>  This command will apply differents compression to the ISO file, resulting in a smaller file size or in a longer process. Consult [Penguins' eggs official guide](https://penguins-eggs.net/docs/Tutorial/eggs-users-guide) for more detailed informations.

# Commands



* [`eggs adapt`](#eggs-adapt)

* [`eggs analyze`](#eggs-analyze)

* [`eggs autocomplete [SHELL]`](#eggs-autocomplete-shell)

* [`eggs calamares`](#eggs-calamares)

* [`eggs config`](#eggs-config)

* [`eggs cuckoo`](#eggs-cuckoo)

* [`eggs dad`](#eggs-dad)

* [`eggs export iso`](#eggs-export-iso)

* [`eggs export pkg`](#eggs-export-pkg)

* [`eggs help [COMMAND]`](#eggs-help-command)

* [`eggs install`](#eggs-install)

* [`eggs kill`](#eggs-kill)

* [`eggs krill`](#eggs-krill)

* [`eggs love`](#eggs-love)

* [`eggs mom`](#eggs-mom)

* [`eggs produce`](#eggs-produce)

* [`eggs status`](#eggs-status)

* [`eggs syncfrom`](#eggs-syncfrom)

* [`eggs syncto`](#eggs-syncto)

* [`eggs tools clean`](#eggs-tools-clean)

* [`eggs tools ppa`](#eggs-tools-ppa)

* [`eggs tools skel`](#eggs-tools-skel)

* [`eggs tools stat`](#eggs-tools-stat)

* [`eggs tools yolk`](#eggs-tools-yolk)

* [`eggs update`](#eggs-update)

* [`eggs version`](#eggs-version)

* [`eggs wardrobe get [REPO]`](#eggs-wardrobe-get-repo)

* [`eggs wardrobe list [REPO]`](#eggs-wardrobe-list-repo)

* [`eggs wardrobe show [REPO]`](#eggs-wardrobe-show-repo)

* [`eggs wardrobe wear [REPO]`](#eggs-wardrobe-wear-repo)



## `eggs adapt`



adapt monitor resolution for VM only



```

USAGE

  $ eggs adapt [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose



DESCRIPTION

  adapt monitor resolution for VM only



EXAMPLES

  $ eggs adapt

```



_See code: [src/commands/adapt.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/adapt.ts)_



## `eggs analyze`



analyze for syncto



```

USAGE

  $ eggs analyze [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose  verbose



DESCRIPTION

  analyze for syncto



EXAMPLES

  sudo eggs analyze

```



_See code: [src/commands/analyze.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/analyze.ts)_



## `eggs autocomplete [SHELL]`



Display autocomplete installation instructions.



```

USAGE

  $ eggs autocomplete [SHELL] [-r]



ARGUMENTS

  SHELL  (zsh|bash|powershell) Shell type



FLAGS

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



DESCRIPTION

  Display autocomplete installation instructions.



EXAMPLES

  $ eggs autocomplete



  $ eggs autocomplete bash



  $ eggs autocomplete zsh



  $ eggs autocomplete powershell



  $ eggs autocomplete --refresh-cache

```



_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.7/src/commands/autocomplete/index.ts)_



## `eggs calamares`



configure calamares or install or configure it



```

USAGE

  $ eggs calamares [-h] [-i] [-n] [-p] [-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



EXAMPLES

  sudo eggs calamares



  sudo eggs calamares --install



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



  sudo eggs calamares --remove

```



_See code: [src/commands/calamares.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/calamares.ts)_



## `eggs config`



Configure eggs to run it



```

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

  -v, --verbose        verbose



DESCRIPTION

  Configure eggs to run it



EXAMPLES

  sudo eggs config



  sudo eggs config --clean



  sudo eggs config --clean --nointeractive

```



_See code: [src/commands/config.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/config.ts)_



## `eggs cuckoo`



PXE start with proxy-dhcp



```

USAGE

  $ eggs cuckoo [-h]



FLAGS

  -h, --help  Show CLI help.



DESCRIPTION

  PXE start with proxy-dhcp



EXAMPLES

  sudo eggs cuckoo

```



_See code: [src/commands/cuckoo.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/cuckoo.ts)_



## `eggs dad`



ask help from daddy - TUI configuration helper



```

USAGE

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



FLAGS

  -c, --clean         remove old configuration before to create

  -d, --default       reset to default values

  -f, --file=  use a file configuration custom

  -h, --help          Show CLI help.

  -v, --verbose



DESCRIPTION

  ask help from daddy - TUI configuration helper



EXAMPLES

  sudo dad



  sudo dad --clean



  sudo dad --default

```



_See code: [src/commands/dad.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/dad.ts)_



## `eggs export iso`



export iso in the destination host



```

USAGE

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



FLAGS

  -C, --checksum  export checksums md5 and sha256

  -c, --clean     delete old ISOs before to copy

  -h, --help      Show CLI help.

  -v, --verbose   verbose



DESCRIPTION

  export iso in the destination host



EXAMPLES

  $ eggs export iso



  $ eggs export iso --clean

```



_See code: [src/commands/export/iso.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/export/iso.ts)_



## `eggs export pkg`



export pkg/iso to the destination host



```

USAGE

  $ eggs export pkg [-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 pkg/iso to the destination host



EXAMPLES

  $ eggs export pkg



  $ eggs export pkg --clean



  $ eggs export pkg --all

```



_See code: [src/commands/export/pkg.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/export/pkg.ts)_



## `eggs help [COMMAND]`



Display help for eggs.



```

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.

```



_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.16/src/commands/help.ts)_



## `eggs install`



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



```

USAGE

  $ eggs install [-b] [-c] [-k] [-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

  -b, --btrfs           Format btrfs

  -c, --chroot          chroot before to end

  -d, --domain=  Domain name, defult: .local

  -h, --help            Show CLI help.

  -i, --ip              hostname as ip, eg: 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, eg: 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!



ALIASES

  $ eggs krill



EXAMPLES

  sudo eggs install



  sudo eggs install --unattended --halt



  sudo eggs install --chroot

```



_See code: [src/commands/install.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/install.ts)_



## `eggs kill`



kill the eggs/free the nest



```

USAGE

  $ eggs kill [-h] [-i] [-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



EXAMPLES

  sudo eggs kill

```



_See code: [src/commands/kill.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/kill.ts)_



## `eggs krill`



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



```

USAGE

  $ eggs krill [-b] [-c] [-k] [-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

  -b, --btrfs           Format btrfs

  -c, --chroot          chroot before to end

  -d, --domain=  Domain name, defult: .local

  -h, --help            Show CLI help.

  -i, --ip              hostname as ip, eg: 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, eg: 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!



ALIASES

  $ eggs krill



EXAMPLES

  sudo eggs install



  sudo eggs install --unattended --halt



  sudo eggs install --chroot

```



## `eggs love`



the simplest way to get an egg!



```

USAGE

  $ eggs love [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose



DESCRIPTION

  the simplest way to get an egg!



EXAMPLES

  $ eggs auto

```



_See code: [src/commands/love.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/love.ts)_



## `eggs mom`



ask help from mommy - TUI helper



```

USAGE

  $ eggs mom [-h]



FLAGS

  -h, --help  Show CLI help.



DESCRIPTION

  ask help from mommy - TUI helper



EXAMPLES

  $ eggs mom

```



_See code: [src/commands/mom.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/mom.ts)_



## `eggs produce`



produce a live image from your system whithout your data



```

USAGE

  $ eggs produce [--addons ...] [--basename ] [-c] [-C] [--excludes ...] [-h] [--links

    ...] [-m] [-N] [-n] [-p] [-P ] [--release] [-s] [-f] [--theme ] [-u] [-v] [-y]



FLAGS

  -C, --cryptedclone         crypted clone

  -N, --noicon               no icon eggs on desktop

  -P, --prefix=       prefix

  -c, --clone                clone

  -f, --standard             standard compression: xz -b 1M

  -h, --help                 Show CLI help.

  -m, --max                  max compression: xz -Xbcj ...

  -n, --nointeractive        no user interaction

  -p, --pendrive             optimized for pendrive: zstd -b 1M -Xcompression-level 15

  -s, --script               script mode. Generate scripts to manage iso build

  -u, --unsecure             /root contents are included on live

  -v, --verbose              verbose

  -y, --yolk                 force yolk renew

      --addons=...    addons to be used: adapt, pve, rsupport

      --basename=     basename

      --excludes=...  use: static, homes, home

      --links=...     desktop links

      --release              release: remove penguins-eggs, calamares and dependencies after installation

      --theme=        theme for livecd, calamares branding and partitions



DESCRIPTION

  produce a live image from your system whithout your data



EXAMPLES

  sudo eggs produce                    # fast compression



  sudo eggs produce --max              # max compression



  sudo eggs produce --pendrive         # compression optomized pendrive



  sudo eggs produce --clone            # clone



  sudo eggs produce --cryptedclone     # crypted clone



  sudo eggs produce --basename=colibri



  sudo eggs produce --theme lastos



  sudo eggs produce --excludes static  # you can customize it



  sudo eggs produce --excludes homes   # exclude /home/*



  sudo eggs produce --excludes home    # exclude ~/*

```



_See code: [src/commands/produce.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/produce.ts)_



## `eggs status`



informations about eggs status



```

USAGE

  $ eggs status [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose



DESCRIPTION

  informations about eggs status



EXAMPLES

  $ eggs status

```



_See code: [src/commands/status.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/status.ts)_



## `eggs syncfrom`



restore users and user data from a LUKS volumes



```

USAGE

  $ eggs syncfrom [--delete ] [-f ] [-h] [-r ] [-v]



FLAGS

  -f, --file=     file containing luks-volume encrypted

  -h, --help             Show CLI help.

  -r, --rootdir=  rootdir of the installed system, when used from live

  -v, --verbose          verbose

      --delete=   rsync --delete delete extraneous files from dest dirs



DESCRIPTION

  restore users and user data from a LUKS volumes



EXAMPLES

  sudo eggs syncfrom



  sudo eggs syncfrom --file /path/to/luks-volume

```



_See code: [src/commands/syncfrom.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/syncfrom.ts)_



## `eggs syncto`



Save users and users' data ENCRYPTED



```

USAGE

  $ eggs syncto [-e] [-f ] [-h] [-v]



FLAGS

  -e, --excludes      use: exclude.list.d/home.list

  -f, --file=  file luks-volume encrypted

  -h, --help          Show CLI help.

  -v, --verbose       verbose



DESCRIPTION

  Save users and users' data ENCRYPTED



EXAMPLES

  sudo eggs syncto



  sudo eggs syncto --file /path/to/luks-volume



  sudo eggs syncto --excludes

```



_See code: [src/commands/syncto.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/syncto.ts)_



## `eggs tools clean`



clean system log, apt, etc



```

USAGE

  $ eggs tools clean [-h] [-n] [-v]



FLAGS

  -h, --help           Show CLI help.

  -n, --nointeractive  no user interaction

  -v, --verbose        verbose



DESCRIPTION

  clean system log, apt, etc



EXAMPLES

  sudo eggs tools clean

```



_See code: [src/commands/tools/clean.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/tools/clean.ts)_



## `eggs tools ppa`



add/remove repo



```

USAGE

  $ eggs tools ppa [-a] [-h] [-n] [-r] [-v]



FLAGS

  -a, --add            add penguins-eggs PPA repository

  -h, --help           Show CLI help.

  -n, --nointeractive  no user interaction

  -r, --remove         remove penguins-eggs PPA repository

  -v, --verbose        verbose



DESCRIPTION

  add/remove repo



EXAMPLES

  sudo eggs tools ppa --add



  sudo eggs tools ppa --remove

```



_See code: [src/commands/tools/ppa.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/tools/ppa.ts)_



## `eggs tools skel`



update skel from home configuration



```

USAGE

  $ eggs tools skel [-h] [-u ] [-v]



FLAGS

  -h, --help          Show CLI help.

  -u, --user=  user to be used

  -v, --verbose



DESCRIPTION

  update skel from home configuration



EXAMPLES

  sudo eggs tools skel



  sudo eggs tools skel --user user-to-be-copied

```



_See code: [src/commands/tools/skel.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/tools/skel.ts)_



## `eggs tools stat`



get statistics from sourceforge



```

USAGE

  $ eggs tools stat [-h] [-m] [-y]



FLAGS

  -h, --help   Show CLI help.

  -m, --month  current month

  -y, --year   current year



DESCRIPTION

  get statistics from sourceforge



EXAMPLES

  $ eggs tools stat



  $ eggs tools stat --month



  $ eggs tools stat --year

```



_See code: [src/commands/tools/stat.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/tools/stat.ts)_



## `eggs tools yolk`



configure eggs to install without internet



```

USAGE

  $ eggs tools yolk [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose



DESCRIPTION

  configure eggs to install without internet



EXAMPLES

  sudo eggs tools yolk

```



_See code: [src/commands/tools/yolk.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/tools/yolk.ts)_



## `eggs update`



update the Penguins' eggs tool



```

USAGE

  $ eggs update [-h] [-v]



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose  verbose



DESCRIPTION

  update the Penguins' eggs tool



EXAMPLES

  $ eggs update

```



_See code: [src/commands/update.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/update.ts)_



## `eggs version`



```

USAGE

  $ eggs version [--json] [--verbose]



FLAGS

  --verbose  Show additional information about the CLI.



GLOBAL FLAGS

  --json  Format output as json.



FLAG DESCRIPTIONS

  --verbose  Show additional information about the CLI.



    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

```



_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v2.2.15/src/commands/version.ts)_



## `eggs wardrobe get [REPO]`



get warorobe



```

USAGE

  $ eggs wardrobe get [REPO] [-h] [-v]



ARGUMENTS

  REPO  repository to get



FLAGS

  -h, --help     Show CLI help.

  -v, --verbose



DESCRIPTION

  get warorobe



EXAMPLES

  $ eggs wardrobe get



  $ eggs wardrobe get your-wardrobe

```



_See code: [src/commands/wardrobe/get.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/wardrobe/get.ts)_



## `eggs wardrobe list [REPO]`



list costumes and accessoires in wardrobe



```

USAGE

  $ eggs wardrobe list [REPO] [-d ] [-h] [-v]



ARGUMENTS

  REPO  wardrobe to get



FLAGS

  -d, --distro=  distro

  -h, --help            Show CLI help.

  -v, --verbose



DESCRIPTION

  list costumes and accessoires in wardrobe



EXAMPLES

  $ eggs wardrobe list



  $ eggs wardrobe list your-wardrobe



  $ eggs wardrobe list --distro arch

```



_See code: [src/commands/wardrobe/list.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/wardrobe/list.ts)_



## `eggs wardrobe show [REPO]`



show costumes/accessories in wardrobe



```

USAGE

  $ eggs wardrobe show [REPO] [-h] [-j] [-v] [-w ]



ARGUMENTS

  REPO  costume to show



FLAGS

  -h, --help              Show CLI help.

  -j, --json              output JSON

  -v, --verbose

  -w, --wardrobe=  wardrobe



DESCRIPTION

  show costumes/accessories in wardrobe



EXAMPLES

  $ eggs wardrobe show colibri



  $ eggs wardrobe show accessories/firmwares



  $ eggs wardrobe show accessories/

```



_See code: [src/commands/wardrobe/show.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/wardrobe/show.ts)_



## `eggs wardrobe wear [REPO]`



wear costume/accessories from wardrobe



```

USAGE

  $ eggs wardrobe wear [REPO] [-h] [-a] [-f] [-v] [-w ]



ARGUMENTS

  REPO  costume to wear



FLAGS

  -a, --no_accessories    not install accessories

  -f, --no_firmwares      not install firmwares

  -h, --help              Show CLI help.

  -v, --verbose

  -w, --wardrobe=  wardrobe



DESCRIPTION

  wear costume/accessories from wardrobe



EXAMPLES

  sudo eggs wardrobe wear duck



  sudo eggs wardrobe wear accessories/firmwares



  sudo eggs wardrobe wear wagtail/waydroid

```



_See code: [src/commands/wardrobe/wear.ts](https://github.com/pieroproietti/penguins-eggs/blob/v10.0.48/src/commands/wardrobe/wear.ts)_



# penGUI

![icon](https://github.com/pieroproietti/pengui/blob/main/assets/pengui.png?raw=true)

## penGUI take cure of eggs!



 The development of a GUI for `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](https://github.com/pieroproietti/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!



## That's all, Folks!



 One of the standout features of Penguins' Eggs is its hassle-free setup. It comes with all the necessary configurations, making it a convenient choice for users. Just like in real life, the magic of Penguins' Eggs lies within - no additional setup required! 



## More Information



In addition to the official guide, there are other resources available for Penguins' Eggs users, particularly developers. These resources can be found in the [penguins-eggs repository](https://github.com/pieroproietti/penguins-eggs) under the [documents](https://github.com/pieroproietti/penguins-eggs/tree/master/documents) section.



Some noteworthy documents include:

- [Hens: Different Species](https://github.com/pieroproietti/penguins-eggs/blob/master//hens-different-species.md): A brief guide on using Penguins' Eggs in Debian, Arch, and Manjaro.

- [Arch-naked](https://penguins-eggs.net/docs/Tutorial/archlinux-naked.html): A blog post detailing how to create an Arch naked live, install it, and customize the resulting system into a graphics development station.

 

If you have any questions or need further assistance, feel free to contact me via email at [email protected]. You can also stay updated by following my [blog](https://penguins-eggs.net) or connecting with me on , [Telegram](https://t.me/penguins_eggs), [Mastodom](https://social.treehouse.systems/@artisan), [Facebook](https://www.facebook.com/groups/128861437762355/), [GitHub](https://github.com/pieroproietti/penguins-krill), [Jitsi](https://meet.jit.si/PenguinsEggsMeeting), [Reddit](https://www.reddit.com/user/Artisan61) or [Twitter](https://twitter.com/pieroproietti), 

[Mastodom](https://social.treehouse.systems/@artisan).



## A word of thanks

* This README would not be so well cared for if not for the work of [Hosein Seilain](https://github.com/hosseinseilani) who spent his time revising and supplementing the text;

* The eggs icon was designed by [Charlie Martinez](https://github.com/quirinux-so);

* and a word of thanks to all of you who are using it and providing feedback and motivation to continue it. 



Thank you!



# Star History

This project collects stars, look to the sky... contribute! 



[![Star History Chart](https://api.star-history.com/svg?repos=pieroproietti/penguins-eggs&type=Date)](https://star-history.com/#pieroproietti/penguins-eggs&Date)



# Copyright and licenses

Copyright (c) 2017, 2024 [Piero Proietti](https://penguins-eggs.net/about-me.html), dual licensed under the MIT or GPL Version 2 licenses.