Files
BUGPy-mOS/README.md
2026-06-09 19:51:24 -04:00

3.8 KiB

BUGPy-mOS-1 Release A-4-i "Graphical Upgrades" w/FDEA

BUGS Python Mock Operation System Overhaul 1 Release Version A Subversion 4 Patch i "Graphical Upgrades" with Full Disk Encryption Ant

🪲 Overview

BUGPy-mOS is a FOSS Mock Operating System. It is written fully in Python and, when packaged with mkosi, can boot on a computer independently.

It contains its own package manager (BPM), shell (BUSH), full-disk encryption (FDEA) and system utilities.

This is a FOSS project. You can download it for free, modify it, do whatever you want. Just make sure to include a reference to us.

If you are interested in contributing to the project, contact p7mj@wholeworldcoding.com.

🖥️ Usage

Download the distributions from the release page. There are three distributions:

  • min (Minimal): The base package.

  • std (Standard): The standard package. All packages are tested. Recommended for the majority of users.

  • ext (Extended): The extended package. Contains experimental/extended scripts from SpyDrone.

Once you have extracted the files, run python3 fdea-1.py. You will be prompted with a password. The default is hello.

BUGPy's system utilities are based on *NIX commands. If you are comfortable with Linux terminals, you will be able to use BUGPy. Help sections for each command are availible by running <command> -h or <command> --help.

🔒 Encryption w/FDEA

FDEA stands for the Full Disk Encryption Ant. It is a utility that acts as the encryption/decryption agent and the launcher for BUGPy.

It uses an adapted version of PCS (link) to handle the encryption and decryption of the main system folder. The entire folder is encrypted as one into cat1_enc.p7c_enc using your password.

⚠️ If you lose your password, there is no way to recover the contents of the BUGPy installation.

🔤 Terminology

cat (catepillar): a BUGPy drive.

ant: any script that assists BUGPy but is not found in the scripts folder

pointerfile: a txt file that contains aliases and the scripts they point to

bpm (BUGS Package Manager): the default package manager for BUGPy.

bush (BUGS-Shell): the default command interpreter and shell for BUGPy.

fdea (Full Disk Encryption Ant): the default encryption/decryption and launcher for BUGPy.

🏗️ Structure

A BUGPy-mOS A-4-i std install looks like this:

cat1
├── bugpy-mos-1.py
├── bush.py
├── config
│   ├── log.txt
│   ├── p7mj_retardedness.txt
│   ├── pointerfile.txt
│   ├── startup.txt
│   └── username.txt
├── dev
│   ├── changelog.txt
│   ├── help_format.txt
│   └── what_next.txt
├── history
│   └── history.txt
├── home
├── scripts
│   ├── ... (system utilities)
└── temp

⚙️ Configuration

As intended, almost every aspect of BUGPY-mOS is customizable.

For starters, you can change your username simply by editing config/username.txt! This will change your username as displayed in bush. You can also change any of the command/script aliases easily by editing the pointerfile.

You can also make your own shell (although our shell is awesome) and rename it to bush.py.

You can make your own apps, scripts, and packages for BUGPy-mOS! Read the Wiki for more information.

🔧 Developers

Core Developers

  • P7MJ: Creator of BUGPy-mOS. Made all versions from BUGPy-mOS-0 to BUGPy-mOS-1 A-3-ii.

  • SpyDrone: Creator of over half of the system utilities, drone_game, and most of the packages in ext.

  • OctoLinkYT: Creator of octuple. Founder of the wholeworldcoding group.