https://github.com/blackmonk13/termux-parrot

A script to install and run Parrot OS within Termux
https://github.com/blackmonk13/termux-parrot

amber-lang bash bash-script parrot-os parrotsec termux termux-proot

Last synced: 8 days ago
JSON representation

A script to install and run Parrot OS within Termux

• Host: GitHub
• URL: https://github.com/blackmonk13/termux-parrot
• Owner: blackmonk13
• License: mit
• Created: 2024-10-24T09:25:05.000Z (12 days ago)
• Default Branch: main
• Last Pushed: 2024-10-25T04:09:38.000Z (12 days ago)
• Last Synced: 2024-10-25T07:18:44.218Z (12 days ago)
• Topics: amber-lang, bash, bash-script, parrot-os, parrotsec, termux, termux-proot
• Homepage:
• Size: 18.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

Termux Parrot




[![Status](https://img.shields.io/badge/status-active-success.svg)]()

[![GitHub Issues](https://img.shields.io/github/issues/blackmonk13/termux-parrot.svg)](https://github.com/blackmonk13/termux-parrot/issues)

[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/blackmonk13/termux-parrot.svg)](https://github.com/blackmonk13/termux-parrot/pulls)

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)



---



    A script to install and run Parrot OS within Termux, providing a lightweight command-line interface with plans for future desktop environment support.



## 📝 Table of Contents

- [About](#about)

- [Getting Started](#getting_started)

- [Prerequisites](#prerequisites)

- [Installing](#installing)

- [Usage](#usage)

- [Built Using](#built_using)

- [TODO](#todo)

- [Contributing](#contributing)

- [Authors](#authors)

- [Acknowledgments](#acknowledgement)

## 🧐 About 

Termux Parrot is an installer script written in Amber that allows you to run Parrot OS within Termux on Android devices. The project aims to provide a seamless way to access Parrot OS tools and environments on mobile devices, with current support for CLI interface and planned extensions for desktop environment access via VNC.

The installer handles the complete setup process, including downloading the appropriate Parrot OS rootfs, verifying its integrity, configuring the environment, and setting up user accounts. It's designed to be user-friendly while maintaining security and stability.

## 🏁 Getting Started 

### Prerequisites

Before installing Termux Parrot, ensure you have:

- Latest version of Termux installed from F-Droid

- At least 2GB of free storage space

- Working internet connection

### Installing

1. Update Termux packages:

```bash

pkg update && pkg upgrade -y

```

2. Run the installer:

```bash

bash <(wget -qO- "https://github.com/blackmonk13/termux-parrot/releases/latest/download/installer.sh")

```

## 🎈 Usage 

After installation, you can:

- Start Parrot OS CLI:

```bash

parrot

```

- Start Parrot OS CLI as root:

```bash

parrot -r

```

## ⛏️ Built Using 

- [Amber](https://amber-lang.com/) - Programming Language

- [Termux](https://termux.dev/) - Android Terminal Emulator

- [Parrot OS](https://www.parrotsec.org/) - Security OS

## 📌 TODO 

- [ ] Add desktop environment installation support

- [ ] Implement VNC server configuration

- [ ] Add storage access management

- [ ] Add network tools configuration

- [ ] Create backup and restore functionality

## 🤝 Contributing 

Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/blackmonk13/termux-parrot/issues).

## ✍️ Authors 

- [@blackmonk13](https://github.com/blackmonk13) - Idea & Initial work

See also the list of [contributors](https://github.com/blackmonk13/termux-parrot/contributors) who participated in this project.

## 🎉 Acknowledgements 

- Kali NetHunter project for inspiration

- Parrot OS team for their amazing security distribution

- Termux developers for making Android CLI environments possible

- The Amber programming language community