Cybersecurity-Projects/PROJECTS/beginner/base64-tool
CarterPerez-dev f83f92545c - Standardize READMEs and add justfiles across all 14 projects
- Add headers, badges, learn module pointers, just command runner tips, and AGPLv3 licenses etc. etc.
- Add missing Justfiles in some projects
- Update pre commit hook and add TODO
2026-02-11 07:01:25 -05:00
..
learn feat: complete base64tool 2026-02-09 07:26:42 -05:00
src/base64_tool feat: complete base64tool 2026-02-09 07:26:42 -05:00
tests feat: complete base64tool 2026-02-09 07:26:42 -05:00
.gitignore feat: complete base64tool 2026-02-09 07:26:42 -05:00
.style.yapf feat: complete base64tool 2026-02-09 07:26:42 -05:00
Justfile feat: complete base64tool 2026-02-09 07:26:42 -05:00
LICENSE - Standardize READMEs and add justfiles across all 14 projects 2026-02-11 07:01:25 -05:00
README.md - Standardize READMEs and add justfiles across all 14 projects 2026-02-11 07:01:25 -05:00
pyproject.toml feat: complete base64tool 2026-02-09 07:26:42 -05:00
uv.lock feat: complete base64tool 2026-02-09 07:26:42 -05:00

README.md

██████╗  ██████╗ ██╗  ██╗████████╗ ██████╗  ██████╗ ██╗
██╔══██╗██╔════╝ ██║  ██║╚══██╔══╝██╔═══██╗██╔═══██╗██║
██████╔╝██║  ███╗███████║   ██║   ██║   ██║██║   ██║██║
██╔══██╗██║   ██║╚════██║   ██║   ██║   ██║██║   ██║██║
██████╔╝╚██████╔╝     ██║   ██║   ╚██████╔╝╚██████╔╝███████╗
╚═════╝  ╚═════╝      ╚═╝   ╚═╝    ╚═════╝  ╚═════╝ ╚══════╝

Cybersecurity Projects Python License: AGPLv3 PyPI

Multi-format encoding/decoding CLI with recursive layer detection for security analysis.

This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.

What It Does

  • Encode and decode Base64, Base64URL, Base32, Hex, and URL formats
  • Auto-detect encoding format with confidence scoring
  • Peel command recursively strips multi-layered encoding (WAF bypass analysis)
  • Chain multiple encoding steps to test obfuscation patterns
  • Pipeline-friendly output for integration into security workflows

Quick Start

uv tool install b64tool
b64tool encode "Hello World"

[!TIP] This project uses just as a command runner. Type just to see all available commands.

Install: curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin

Commands

Command Description
b64tool encode Encode text into Base64, Base64URL, Base32, Hex, or URL format
b64tool decode Decode encoded text back to plaintext
b64tool detect Auto-detect the encoding format with confidence scoring
b64tool peel Recursively strip multi-layered encoding to reveal original data
b64tool chain Chain multiple encoding steps together for obfuscation testing

Learn

This project includes step-by-step learning materials covering security theory, architecture, and implementation.

Module Topic
00 - Overview Prerequisites and quick start
01 - Concepts Security theory and real-world breaches
02 - Architecture System design and data flow
03 - Implementation Code walkthrough
04 - Challenges Extension ideas and exercises

License

AGPL 3.0