eggs(1) -- the reproductive system of penguins: eggs v26.8.29

SYNOPSIS

eggs is a console utility, in active development, who let you to remaster your system and redistribuite it as live ISO image.

INSTALL

penguins-eggs as an AppImage, it can be installed on all supported distributions. Download it from https://github.com/pieroproietti/penguins-eggs/releases, then run the following commands:

$ chmod +x penguins-eggs-legacy_26.8.29-1_arm64-x86_64.AppImage
$ sudo mv /usr/local/bin
$ sudo eggs setup

AlpineLinux

$ doas apk add penguins-eggs@testing

AlmaLinux/RockyLinux

$ sudo dnf install ./penguins-eggs-legacy_26.8.29-1_arm64-1rocky9.5..x86_64.rpm

Arch

$ sudo pacman -S penguins-eggs
$ sudo pacman -U penguins-eggs-legacy_26.8.29-1_arm64-1-x86_64.pkg.tar.zst

Debian/Devuan/Ubuntu

$ sudo apt install penguins-eggs
$ sudo dpkg -i penguins-eggs-legacy_26.8.29-1_arm64.deb

Fedora

$ sudo dnf install ./penguins-eggs-legacy_26.8.29-1_arm64-1fedora.x86_64.rpm

Manjaro

$ sudo pamac install penguins-eggs

OpenMamba

$ sudo dnf install ./penguins-eggs-legacy_26.8.29-1_arm64-1mamba.x86_64.rpm

USAGE

$ eggs (-v|--version|version)

penguins-eggs/26.8.29  
$ eggs --help [COMMAND]

USAGE
$ eggs COMMAND

Most of the commands of eggs need sudo, but there are exceptions for export, info and mom.

examples:

sudo eggs produce
sudo eggs produce --pendrive --clone
sudo eggs kill

There are too two interactive helpers, probably you already know:

eggs mom
sudo eggs dad

We have a comprehensive guide at https://penguins-eggs.net, help yorself signing on telegram https://t.me/penguins_eggs on facebook group, or writing me.

DESCRIPTION

The scope of this project is to implement the process of remastering your version of Linux, generate it as ISO image, to burn on a CD/DVD or copy to a usb key, to boot your system live. Of course, You can easily install your live image using GUI installer (calamares) or CLI installer (krill) always included.

COMMANDS

eggs-legacy adapt
eggs-legacy autocomplete [SHELL]
eggs-legacy calamares
eggs-legacy config
eggs-legacy cuckoo
eggs-legacy dad
eggs-legacy export appimage
eggs-legacy export iso
eggs-legacy export pkg
eggs-legacy export tarballs
eggs-legacy help [COMMAND]
eggs-legacy kill
eggs-legacy krill
eggs-legacy love
eggs-legacy mom
eggs-legacy produce
eggs-legacy setup install
eggs-legacy setup purge
eggs-legacy status
eggs-legacy tools clean
eggs-legacy tools repo
eggs-legacy tools skel
eggs-legacy tools stat
eggs-legacy tools yolk
eggs-legacy update
eggs-legacy version

`eggs-legacy adapt`

adapt monitor resolution for VM only

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

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

DESCRIPTION
  adapt monitor resolution for VM only

EXAMPLES
  eggs adapt

`eggs-legacy autocomplete [SHELL]`

Display autocomplete installation instructions.

USAGE
  $ eggs-legacy 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-legacy autocomplete

  $ eggs-legacy autocomplete bash

  $ eggs-legacy autocomplete zsh

  $ eggs-legacy autocomplete powershell

  $ eggs-legacy autocomplete --refresh-cache

`eggs-legacy calamares`

a GUI system installer - install and configure calamares

USAGE
  $ eggs-legacy calamares [-h] [-i] [-n] [-p] [-r] [--remove] [--theme <value>] [-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=<value>  theme/branding for eggs and calamares

DESCRIPTION
  a GUI system installer - install and configure calamares

EXAMPLES
  sudo eggs calamares

  sudo eggs calamares --install

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

  sudo eggs calamares --remove

`eggs-legacy config`

Configure eggs to run it

USAGE
  $ eggs-legacy 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

`eggs-legacy cuckoo`

PXE start with proxy-dhcp

USAGE
  $ eggs-legacy cuckoo [-h] [-v]

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

DESCRIPTION
  PXE start with proxy-dhcp

EXAMPLES
  sudo eggs cuckoo

`eggs-legacy dad`

ask help from daddy - TUI configuration helper

USAGE
  $ eggs-legacy dad [-c] [-d] [-f <value>] [-h] [-n] [-v]

FLAGS
  -c, --clean          remove old configuration before to create
  -d, --default        reset to default values
  -f, --file=<value>   use a file configuration custom
  -h, --help           Show CLI help.
  -n, --nointeractive  no user interaction
  -v, --verbose

DESCRIPTION
  ask help from daddy - TUI configuration helper

EXAMPLES
  sudo eggs dad

  sudo eggs dad --clean

  sudo eggs dad --default

`eggs-legacy export appimage`

export penguins-eggs AppImage to the destination host

USAGE
  $ eggs-legacy export appimage [-c] [-h] [-v]

FLAGS
  -c, --clean    remove old .AppImage before to copy
  -h, --help     Show CLI help.
  -v, --verbose  verbose

DESCRIPTION
  export penguins-eggs AppImage to the destination host

EXAMPLES
  eggs export pkg

  eggs export pkg --clean

  eggs export pkg --all

`eggs-legacy export iso`

export remastered ISO in the destination host

USAGE
  $ eggs-legacy 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 remastered ISO in the destination host

EXAMPLES
  eggs export iso

  eggs export iso --clean

`eggs-legacy export pkg`

export penguins-eggs-legacy package to the destination host

USAGE
  $ eggs-legacy 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 penguins-eggs-legacy package to the destination host

EXAMPLES
  eggs export pkg

  eggs export pkg --clean

  eggs export pkg --all

`eggs-legacy export tarballs`

export pkg/iso/tarballs to the destination host

USAGE
  $ eggs-legacy export tarballs [-c] [-h] [-v]

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

DESCRIPTION
  export pkg/iso/tarballs to the destination host

EXAMPLES
  eggs export tarballs

  eggs export tarballs --clean

`eggs-legacy help [COMMAND]`

Display help for eggs-legacy.

USAGE
  $ eggs-legacy 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-legacy.

`eggs-legacy kill`

kill the eggs/free the nest

USAGE
  $ eggs-legacy 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

`eggs-legacy krill`

a TUI system installer - install the system

USAGE
  $ eggs-legacy krill [-b] [-c] [-k] [-d <value>] [-H] [-h] [-i] [-n] [-N] [-p] [-r] [-R <value>] [-s] [-S]
    [-t] [-u] [-v]

FLAGS
  -H, --halt             Halt the system after installation
  -N, --none             Swap none: 256M
  -R, --replace=<value>  Replace partition. eg: --replace /dev/sda3
  -S, --suspend          Swap suspend: RAM x 2
  -b, --btrfs            Format btrfs
  -c, --chroot           chroot before to end
  -d, --domain=<value>   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
  -t, --testing          Just testing krill
  -u, --unattended       Unattended installation
  -v, --verbose          Verbose

DESCRIPTION
  a TUI system installer - install the system

EXAMPLES
  sudo eggs install

  sudo eggs install --unattended --halt

  sudo eggs install --chroot

`eggs-legacy love`

the simplest way to get an egg!

USAGE
  $ eggs-legacy love [-c] [--fdt <value>] [-f] [-h] [-H] [-k] [-n] [-v]

FLAGS
  -H, --hidden         stealth mode
  -c, --clone          clone (uncrypted)
  -f, --fullcrypt      clone crypted full
  -h, --help           Show CLI help.
  -k, --homecrypt      clone crypted home
  -n, --nointeractive  no user interaction
  -v, --verbose
      --fdt=<value>    path to Flattened Device Tree (DTB) file or directory

DESCRIPTION
  the simplest way to get an egg!

EXAMPLES
  eggs love

`eggs-legacy mom`

ask help from mommy - TUI helper

USAGE
  $ eggs-legacy mom [-h]

FLAGS
  -h, --help  Show CLI help.

DESCRIPTION
  ask help from mommy - TUI helper

EXAMPLES
  eggs mom

`eggs-legacy produce`

produce a live image from your system

USAGE
  $ eggs-legacy produce [--addons <value>...] [--basename <value>] [-c] [--excludes <value>...] [--fdt
    <value>] [-f] [-h] [-H] [-k] [-i] [-K <value>] [--links <value>...] [-m] [-N] [-n] [-p] [-P <value>] [--release]
    [-s] [-S] [--theme <value>] [-v] [-y]

FLAGS
  -H, --hidden               stealth mode
  -K, --kernel=<value>       kernel version
  -N, --noicon               no icon eggs on desktop
  -P, --prefix=<value>       prefix
  -S, --standard             standard compression: xz -b 1M
  -c, --clone                clone (uncrypted)
  -f, --fullcrypt            clone crypted full
  -h, --help                 Show CLI help.
  -i, --includeRootHome      folder /root is included on live
  -k, --homecrypt            clone crypted home
  -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
  -v, --verbose              verbose
  -y, --yolk                 force yolk renew
      --addons=<value>...    addons to be used: adapt, pve, rsupport
      --basename=<value>     basename
      --excludes=<value>...  use: static, homes, home
      --fdt=<value>          path to Flattened Device Tree (DTB) file or directory
      --links=<value>...     desktop links
      --release              release: remove penguins-eggs, calamares and dependencies after installation
      --theme=<value>        theme for livecd, calamares branding and partitions

DESCRIPTION
  produce a live image from your system

EXAMPLES
  sudo eggs produce                    # zstd fast compression

  sudo eggs produce --pendrive         # zstd compression optimized pendrive

  sudo eggs produce --clone            # clear clone (unencrypted)

  sudo eggs produce --homecrypt      # clone crypted home (all inside /home is cypted)

  sudo eggs produce --fullcrypt      # clone crypted full (entire system is crypted)

  sudo eggs produce --basename=colibri

`eggs-legacy setup install`

Automatically check and install system prerequisites

USAGE
  $ eggs-legacy setup install

DESCRIPTION
  Automatically check and install system prerequisites

EXAMPLES
  eggs setup                           # this help

  sudo eggs setup install              # install native dependencies, autocomplete, man, etc

  sudo eggs setup purge                # purge all configurations, autocomplete, man, etc installed from penguins-eggs AppImage

`eggs-legacy setup purge`

Automatically check and install system prerequisites

USAGE
  $ eggs-legacy setup purge

DESCRIPTION
  Automatically check and install system prerequisites

EXAMPLES
  eggs setup                           # this help

  sudo eggs setup install              # install native dependencies, autocomplete, man, etc

  sudo eggs setup purge                # purge all configurations, autocomplete, man, etc installed from penguins-eggs AppImage

`eggs-legacy status`

informations about eggs status

USAGE
  $ eggs-legacy status [-h] [-v]

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

DESCRIPTION
  informations about eggs status

EXAMPLES
  eggs status

`eggs-legacy tools clean`

clean system log, apt, etc

USAGE
  $ eggs-legacy 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

`eggs-legacy tools repo`

add/remove penguins-repos

USAGE
  $ eggs-legacy tools repo [-a] [-h] [-n] [-r] [-v]

FLAGS
  -a, --add            add penguins-repos
  -h, --help           Show CLI help.
  -n, --nointeractive  no user interaction
  -r, --remove         remove penguins-repos
  -v, --verbose        verbose

DESCRIPTION
  add/remove penguins-repos

EXAMPLES
  sudo eggs tools repo --add

  sudo eggs tools repo --remove

`eggs-legacy tools skel`

update skel from home configuration

USAGE
  $ eggs-legacy tools skel [-h] [-u <value>] [-v]

FLAGS
  -h, --help          Show CLI help.
  -u, --user=<value>  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

`eggs-legacy tools stat`

get statistics from sourceforge

USAGE
  $ eggs-legacy 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

`eggs-legacy tools yolk`

configure eggs to install without internet

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

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

DESCRIPTION
  configure eggs to install without internet

EXAMPLES
  sudo eggs tools yolk

`eggs-legacy update`

update the Penguins' eggs tool

USAGE
  $ eggs-legacy update [-h] [-v]

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

DESCRIPTION
  update the Penguins' eggs tool

EXAMPLES
  eggs update

`eggs-legacy version`

USAGE
  $ eggs-legacy 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.

FILES

  /etc/penguins-eggs.d
    all eggs configurations are here

  /etc/penguins-eggs.d/exclude.list
    exclude.list

  /usr/lib/penguins-eggs
    where eggs is installed

TROUBLES

BUGS

Report problems o new ideas in: https://github.com/pieroproietti/penguins-eggs/issues

RESOURCES AND DOCUMENTATION

Consult website to find documentation

website: https://penguins-eggs.net
gitHub repository: https://github.com/pieroproietti/penguins-eggs
telegram: https://t.me/penguins_eggs

AUTHOR

Piero Proietti piero.proietti@gmail.com