💩 pooputil

Ever heard of malware?

One of the first things it usually does is scan your drive for common file extensions.

.docx .xlsx .pptx
.pdf  .jpg  .png
.zip  .zip  .txt

Your files are predictable.

pooputil changes that.

pooputil is a small open-source file encryption utility that compresses your files into encrypted .poop containers.

Instead of just hiding files somewhere, pooputil compresses them, encrypts them using AES-256-GCM, derives keys using Scrypt, and can optionally overwrite the original file after encryption.

Whether youre storing backups, documents or just wanna archive stuff safely, pooputil gives you a Python API, CLI and a simple desktop GUI.

v0.0.2

Fixed the broken imports from v0.0.1. Everything should work properly now.

Licensed under GPLv3. Fork it, improve it or build your own project on top of it.

---

Features

• AES-256-GCM authenticated encryption
• Scrypt password derivation
• Compress before encrypting
• Custom .poop container format
• Python API
• CLI
• Desktop GUI
• Optional overwrite-based deletion
• Backend separated from GUI

---

Why .poop?

A lot of malware targets common file extensions.

.docx
.xlsx
.pdf
.jpg
.png
.zip

Those are easy to recognize.

pooputil stores encrypted data inside .poop containers instead.

Will this stop malware?

Probably not.

If malware wants to encrypt every file on your disk itll happily encrypt .poop too.

The idea here isnt to beat malware, its to make your actual file contents unreadable without the password while also giving you a funny file extension.

---

Fun Fact

The .poop file extension was inspired by No Text To Speech.

If you know, you know.

Architecture

pooputil is split into modules kinda like Arduino.

GUI
 │
 ▼
pooputil.core
 ▲
 │
CLI
 │
 ▼
Python API

The GUI is just a frontend.

Most of the work happens inside pooputil.core, so you can import it directly into your own scripts without dragging GUI stuff along.

---

Crypto

Component	Algorithm
Encryption	AES-256-GCM
KDF	Scrypt
Salt	16 bytes
Nonce	12 bytes
Authentication	GCM Tag

I use the cryptography library instead of trying to implement crypto myself.

---

Secure deletion

After encryption pooputil can overwrite the original file before deleting it

Keep in mind secure deletion depends on your filesystem and storage device SSDs especially don't always behave the same because of wear leveling

---

Installation

pip install pooputil

---

Usage

GUI

pooputil-gui

or

python -m pooputil

---

CLI

Encrypt

pooputil-cli --encrypt "/path/to/data" --password "SuperSecretKey99"

Decrypt

pooputil-cli --decrypt "/path/to/data.poop" --password "SuperSecretKey99"

---

Python API

from pooputil import core

password = b"SuperSecretPassword"
target = "./important.docx"

if core.is_safe_path(target):
    core.encrypt_target(target, password)
else:
    print("Unsafe path.")

Decrypt

from pooputil import core

restored = core.decrypt_target(
    "./important.docx.poop",
    b"SuperSecretPassword"
)

print(restored)

---

Disclaimer

This project is meant for legitimate encryption and backup purposes.

Also...

Dont forget your password.

I cant magically decrypt your .poop if you lose it.

You cant unflush a poop if you flushed it.

---

License

GPLv3.