penguinsOnWhale

Run multiple Docker containers each in a separate terminal with a single command.

Requirements/Dependencies

• bash 4 or 5
• Python >3.6
• Docker >19.03.0 or podman >2.0.2
• GNOME Terminal >3.27.0

Installation

Download and run:

./penguinsOnWhale --install

or

sudo ./penguinsOnWhale --install

Follow the instructions

Supported terminals

Supported	Ubuntu	Debian	OpenSUSE	Fedora	Linux Mint	CentOS	Arch	Tails	Elementary OS
aTerm	❌	❌	❌	❌	❌	❌	❌	❌	❌
Eterm	❌	❌	❌	❌	❌	❌	❌	❌	❌
GNOME Terminal	✔️	✔️	❔	✔️	❔	❔	❔	❔	❔
Hyper	❌	❌	❌	❌	❌	❌	❌	❌	❌
Guake	❌	❌	❌	❌	❌	❌	❌	❌	❌
Konsole	❌	❌	❌	❌	❌	❌	❌	❌	❌
Nautilus Terminal	❌	❌	❌	❌	❌	❌	❌	❌	❌
rxvt	❌	❌	❌	❌	❌	❌	❌	❌	❌
Terminator	❌	❌	❌	❌	❌	❌	❌	❌	❌
Tilda	❌	❌	❌	❌	❌	❌	❌	❌	❌
XFCE4 Terminal	❌	❌	❌	❌	❌	❌	❌	❌	❌
XTerm	❌	❌	❌	❌	❌	❌	❌	❌	❌
VTE Terminal	❌	❌	❌	❌	❌	❌	❌	❌	❌

Usage

Help output:

Usage: penguinsOnWhale <COMMAND> [<penguin> [<penguin> [...]]]
  or:  penguinsOnWhale [<option>]

Commands:
  run                    invokes a terminal and starts a docker container for each specified penguin
  all                    invokes a terminal and starts a docker container for all penguins in the config file
  here                   starts a single penguin in the current terminal
  create-config          creates a new example config file in the current directory
  create-config-full     creates a new extensive example config file, demonstrating all available features
  reinstall              runs an installation script located at "/opt/penguinsOnWhale/installator.sh"


options:
  -h, --help         as a first keyword, displays this message. Run 'penguinsOnWhale <COMMAND> --help' for more info on a command
  -v, --version      displays general info about the program

Default config file (created with penguinsOnWhale create-config):

[Settings]
docker_images_prefix = 
docker_mount_source = 
docker_mount_destination = 
terminal_profile = penguinsOnWhale
cmd = ls
cmd_arg1 = -la

[penguin "ubuntu18.04"]
terminal_name = Ubuntu 18.04
docker_image = ubuntu:18.04
docker_container = myReusableUbuntu1804container
reuse_container = True

[penguin "fedora31"]
terminal_name = Fedora 31
docker_image = fedora:31

[penguin "amazonlinux2"]
terminal_name = Amazon Linux 2
docker_image = amazonlinux:2

use penguinsOnWhale create-config-full to check out more features