Hide your files behind a 4-digit PIN path in a maze of decoy directories.
- Description
- Features
- Installation
- Usage
- Folder Structure
- Tech Stack
- Dependencies & Packages
- Contributing
- License
- Security
- Code of Conduct
PIN-Based Filesystem Maze is a fun, experimental CLI tool that buries a file deep inside a recursive directory tree. The only way to retrieve it is to know the 4-digit PIN — each digit is a directory level (PIN 4660 → base/4/6/6/0/secret.txt). Every other branch is flooded with decoy files to confuse anyone snooping around.
No encryption. No external dependencies. Just obscurity through sheer filesystem chaos.
- PIN-based path generation — 4-digit PIN maps to a unique 4-level directory path.
- Decoy files — populate every non-PIN branch with realistic-looking junk.
- Recursive 0-9 tree — each level spawns 10 subdirectories (
10^4 = 10,000leaf folders). - Colorful terminal output — ANSI-colored banners, steps, and tree view.
- Visual tree display — highlights the PIN path in green.
- Logging — every operation logged with timestamps to
.pin_maze_logs/. - Zero dependencies — pure Python 3 standard library.
- Cross-platform — works on Linux, macOS, and Windows.
- Python 3.10+ (uses
match/casestyle type hints andtuple[...]syntax)
# Clone the repo
git clone https://github.com/H0NEYP0T-466/pin-maze.git
cd pin-maze
# No pip install needed — just run it
python pin_maze.py --help# Basic usage — hide a file behind PIN 4660
python pin_maze.py --base ./vault --file ./secret.txt --pin 4660
# Add more decoys per level (default: 3)
python pin_maze.py --base ./vault --file ./secret.txt --pin 4660 --decoys 5
# Disable colors (for non-TTY / piping)
python pin_maze.py --base ./vault --file ./secret.txt --pin 0000 --no-color
# Quiet mode — suppress banner and tree
python pin_maze.py --base ./vault --file ./secret.txt --pin 4660 --quiet| Flag | Short | Required | Default | Description |
|---|---|---|---|---|
--base |
-b |
✅ | — | Base directory where the maze is created |
--file |
-f |
✅ | — | Path to the file you want to hide |
--pin |
-p |
✅ | — | 4-digit PIN (e.g., 4660) |
--decoys |
-d |
❌ | 3 |
Number of decoy files per leaf folder |
--no-color |
— | ❌ | False |
Disable ANSI color output |
--quiet |
-q |
❌ | False |
Suppress non-essential output |
# Navigate the PIN path
cd ./vault/4/6/6/0/
# Your file is here
cat secret.txtpin-maze/
├── pin_maze.py # Main CLI script (single-file tool)
├── run_commands.txt # Example command reference
├── secret.txt # Demo secret file
├── README.md # Project documentation
├── LICENSE # MIT License
├── CONTRIBUTING.md # Contribution guidelines
├── SECURITY.md # Security policy
├── CODE_OF_CONDUCT.md # Community code of conduct
└── .github/
├── ISSUE_TEMPLATE/
│ ├── bug_report.yml
│ ├── feature_request.yml
│ └── config.yml
└── pull_request_template.md
This project uses only the Python 3 standard library. No external packages are required.
Runtime Dependencies
No external dependencies detected — uses Python standard library only.
Modules used:
argparse— CLI argument parsinglogging— structured log output with file handlersos— filesystem operationsrandom— decoy sampling and content selectionshutil— file move operationssys— stdout checks and exit codesdatetime— log timestamp formattingpathlib— modern path manipulation
Dev / Build / Test Dependencies
No dev dependencies configured. Add a
requirements-dev.txtorpyproject.tomlif you introduce testing/linting tools (e.g.,pytest,ruff,mypy).
We welcome contributions! Please read our Contributing Guide for details on forking, code style, and submitting pull requests.
This project is licensed under the MIT License — see the LICENSE file for details.
Please review our Security Policy for information on reporting vulnerabilities and our disclosure process.
This project adheres to the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code.
Made with ❤ by H0NEYP0T-466