https://github.com/hxari/penguin
Command Line Utility Tool to install various Linux distros into Android Terminal Emulator (Termux), there are more than 5 distros you can install with this tool.
https://github.com/hxari/penguin
alpine arch debian fedora hacking kali linux manjaro nethunter parrot termux termux-tool ubuntu void
Last synced: 14 days ago
JSON representation
Command Line Utility Tool to install various Linux distros into Android Terminal Emulator (Termux), there are more than 5 distros you can install with this tool.
- Host: GitHub
- URL: https://github.com/hxari/penguin
- Owner: hxAri
- License: gpl-3.0
- Created: 2023-07-11T18:21:29.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-11T15:44:57.000Z (10 months ago)
- Last Synced: 2025-03-27T10:13:42.604Z (about 1 month ago)
- Topics: alpine, arch, debian, fedora, hacking, kali, linux, manjaro, nethunter, parrot, termux, termux-tool, ubuntu, void
- Language: Shell
- Homepage: https://hxari.github.io/projects/Penguin
- Size: 222 KB
- Stars: 32
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Penguin
## Table of Contents
- [Penguin](#penguin)
- [Table of Contents](#table-of-contents)
- [Abouts](#abouts)
- [Notes](#notes)
- [Features](#features)
- [Binary Execution](#binary-execution)
- [Command Line Interface](#command-line-interface)
- [Linux Distros](#linux-distros)
- [Desktop Environment](#desktop-environment)
- [Window manager](#window-manager)
- [Dependency](#dependency)
- [Environment](#environment)
- [Warning](#warning)
- [Installation](#installation)
- [Usagement](#usagement)
- [Sources](#sources)
- [Support](#support)
- [Licence](#licence)
## Abouts
**[Penguin](https://github.com/hxAri/Penguin)** is a Command Line Tool to simplify the installation of Linux Distros to the Android Operating System using Termux as a Shell environment. **[Penguin](https://github.com/hxAri/Penguin)** also supports more than 6 Linux Distros [see](#linux-distros), as well as several Desktop Environments [see](#desktop-environment) and also Window Manager [view](#window-manager).
For problems with graphics rendering you need to know that Termux does not support it however, don't worry about that you can still achieve it with the help of VNC Viewer you can download it via Play Store for free.
## Notes
Maybe when you install a distro it will be fine until you successfully install it, but some distros may require some additional configuration to run well. But no need to worry about that, because you will still be able to use it.
## Features
The **[Penguin](https://github.com/hxAri/Penguin)** features
### Binary Execution
Makes it easier for you to run your Linux Distro.
### Command Line Interface
The Command Line is very interesting and also easy to understand (this is just my opinion :D)
### Linux Distros
List of currently available or supported Linux Distros on **[Penguin](https://github.com/hxAri/Penguin)**
* **Alpine**
* Command Line Interface (CLI)
* Desktop Environment
* XFCE
* Versions
* 3.10.3
* **Arch Linux**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 2021.07.01
* **Debian**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 10.00
* **Fedora**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 33
* **Kali Linux**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 21.2
* **Kali Nethunter**
* Command Line Interface (CLI)
* Editions
* Kali Nethunter Full Edition
* Kali Nethunter Nano Edition
* Kali Nethunter Minimum Edition
* **Manjaro**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* MATE
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 21
* **Parrot Security OS**
Working
* **Ubuntu**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* 22.04
* 20.03
* 18.04
* **Void**
* Command Line Interface (CLI)
* Desktop Environment
* LXDE
* LXQT
* XFCE
* Window Manager
* Awesome
* I3
* Openbox
* Versions
* Rolling Release
### Desktop Environment
List of currently available or supported Desktop Environment on **[Penguin](https://github.com/hxAri/Penguin)**
* LXDE
* LXQT
* MATE
* XFCE
### Window manager
List of currently available or supported Linux Window Manager **[Penguin](https://github.com/hxAri/Penguin)**
* Awesome
* I3
* Openbox
## Dependency
Does **[Penguin](https://github.com/hxAri/Penguin)** require additional dependencies? Yeah, but not much. All the required dependencies are all in a file called **dependencies**, you can read them with your favorite `cat` in the Terminal Emulator.
## Environment
If **[Penguin](https://github.com/hxAri/Penguin)** uses the Shell as a programming language, does it require virtualization such as a Virtual Environment in the Python language? It can be yes or no, the environment here is intended to be a different situation because **[Penguin](https://github.com/hxAri/Penguin)** is typed on a Laptop/PC so the **development** environment means that you will never install it, just create a system file folder like `{distro}-fs`
Meanwhile, the **production** environment is where you actually run it on your Termux and, you will actually install it. If you want to change the **[Penguin](https://github.com/hxAri/Penguin)** environment you just need to change the contents of the **environment** file to the environment you want (**production** is set to default)
#### Warning
If you set it to development and run it in Termux it will probably cause permission errors
## Installation
How to install **[Penguin](https://github.com/hxAri/Penguin)**? You don't need to bother with that problem, just clone or download the source code from this repository.
```sh
git clone https://github.com/hxAri/Penguin
```
Let's change give the penguin executable permission
```sh
chmod +x Penguin/penguin
```
Now you can run the **[Penguin](https://github.com/hxAri/Penguin)** like this
```sh
bash Penguin/penguin
```
Or like this
```sh
. Penguin/penguin
```
Or this
```sh
Penguin/penguin
```
Next, please choose the distro you want to install yourself, and follow the instructions given, Have Nice Live!
## Usagement
When the Linux distro you installed has been successfully installed you can easily run it with just one line of code, see below for an example of running it in the Termux command line:
```sh
# (distro) (mode|window>)
```
Debian distro cli mode:
```sh
debian cli
```
Debian distro desktop environment mode:
```sh
debian desktop xfce
```
Debian distro window manager mode:
```sh
debian window awesome
```
And below is the usage for distros that have more than one version, such as Ubuntu:
```sh
# (distro) (version) (mode|window>)
```
Ubuntu distro cli mode:
```sh
ubuntu 22.04 cli
```
Ubuntu distro desktop environment mode:
```sh
ubuntu 22.04 desktop xfce
```
Ubuntu distro window manager mode:
```sh
ubuntu 22.04 window awesome
```
## Sources
To source the Root File System for the **[Penguin](https://github.com/hxAri/Penguin)** Linux Distro, it uses sources from various GitHub repositories, including:
* **[Andronix](https://github.com/AndronixApp/AndronixOrigin)**
## Support
Give spirit to the developer, no matter how many donations given will still be accepted
[paypal.me/hxAri](https://paypal.me/hxAri)
## Licence
All **[Penguin](https://github.com/hxAri/Penguin)** source code is licensed under the GNU General Public License v3. Please [see](https://www.gnu.org/licenses) the original document for more details.