2 Commits
A-4-i ... main

Author SHA1 Message Date
1370f33d05 Update README.md 2026-06-09 19:51:24 -04:00
ce67d7a3c4 Update README.md 2026-06-09 19:47:37 -04:00

View File

@@ -14,7 +14,7 @@ It contains its own **package manager** (BPM), **shell** (BUSH), **full-disk enc
## 🖥️ Usage
Download the distribution you are interested in using from the release page. There are three distributions:
Download the distributions from the [release page](https://git.wholeworldcoding.com/wholeworldcoding/BUGPy-mOS/releases). There are three distributions:
- **min** (Minimal): The base package.
@@ -24,4 +24,72 @@ Download the distribution you are interested in using from the release page. The
Once you have extracted the files, run `python3 fdea-1.py`. You will be prompted with a password. The default is `hello`.
BUGPy's commands are based on *NIX commands. If you are comfortable in a Linux terminal, you will be able to use BUGPy.
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](https://git.wholeworldcoding.com/p7mj/PCS)) 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](https://git.wholeworldcoding.com/wholeworldcoding/BUGPy-mOS/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.