🛡️ Just Obfuscate

Drop a ZIP → ship sealed, unreadable, unbreakable code.

Universal code obfuscator for JavaScript, TypeScript, Python, Java, C/C++, HTML, CSS, JSON and more. 100 % client-side in the browser · plus a pip install justob CLI · plus a public HTTP API.

Features • Quick Start • CLI • API • Decoder • Deploy

---

✨ Features

	Capability	What it means
⚡	100 % in-browser	Your code never leaves the device — zero servers, zero leaks.
🌐	Universal Mode	Obfuscate raw code snippets in 20+ languages without a ZIP.
📦	ZIP Mode	Drop a project zip → sealed zip out, original tree preserved.
🧠	Smart filtering	Auto-skips node_modules, .git, binaries, lockfiles. Never mangles vendor code.
🎚️	3 profiles	light · standard · maximum — pick your paranoia level.
🚀	Parallel workers	Every CPU core via Web Workers — huge projects in seconds.
🔓	Universal Decoder	Strips up to 24 layers (base64 / hex / rot13 / eval(atob)) and re-beautifies output.
🐍	CLI — justob	pip install justob → obfuscate & decode from the terminal.
🌍	Public HTTP API	POST /api/public/obfuscate — wire into CI, GitHub Actions, anywhere.
📱	PWA + Share Target	Install on mobile · share zips from your OS straight into the app.
🕒	History	Last 20 jobs cached locally for re-download.
🔍	SEO-first	Per-route metadata, sitemap, JSON-LD, llms.txt. Built to rank.

---

🚀 Quick Start

git clone https://github.com/<your-username>/just-obfuscate.git
cd just-obfuscate
bun install        # or: npm install
bun dev            # → http://localhost:8080

Build for production:

bun run build
bun run start

---

🐍 CLI — pip install justob

Same engine. In your terminal. Cross-platform (Linux · macOS · Windows · Termux · Android).

pip install justob

Subcommands

justob obfuscate ./my-project.zip --profile maximum -o sealed.zip
justob decode ./encoded.txt --pretty
justob examples         # show every command with usage examples
justob docs             # full inline documentation

Common flags

Flag	Purpose
--profile	light · standard · maximum
--super-safe	Safest ZIP mode; preserves risky files instead of rewriting them
--strip-console	Remove console.log / print() calls
--encrypt-strings	Encode every string literal
--include-skipped	Keep other non-obfuscated files; node_modules is always excluded
--stdin	Pipe code directly: cat file.js | justob decode --stdin
--format	Decoder beautifier (auto · js-like · py-like · …)
--pretty	Pretty-print decoded output

Run justob examples for copy-paste recipes.

---

🌍 HTTP API

Two free, no-key, public endpoints. Wire into any pipeline.

POST /api/public/obfuscate

multipart/form-data in · application/zip out. Max 50 MB.

curl -X POST https://just-obfuscate.app/api/public/obfuscate \
  -F file=@./my-project.zip \
  -F profile=maximum \
  -F stripConsole=true \
  -o sealed.zip

POST /api/public/decode

JSON in, JSON out. Iteratively strips up to 24 obfuscation layers.

curl -X POST https://just-obfuscate.app/api/public/decode \
  -H "content-type: application/json" \
  -d '{"code":"ZXZhbCgnYWxlcnQoMSknKQ==","format":"auto"}'

Returns { decoded, beautified, layers, detectedLanguage, bytesIn, bytesOut }.

---

🔓 Decoder

A universal, multi-language deobfuscator that auto-detects encoding chains and language.

• Strips base64 / hex / rot13 / reverse / eval(atob(...)) shims iteratively (up to 24 layers).
• Re-beautifies for 13 syntax families (JS-like, Python-like, shell, C-like, markup, CSS, SQL, config, lisp, ML, prose…).
• Available in browser, CLI, and API.

---

⚙️ How it works

   ┌─────────┐    ┌──────────────┐    ┌────────────────┐    ┌──────────┐
   │  .zip   │ ─► │  unpack +    │ ─► │  obfuscate per │ ─► │ sealed   │
   │  drop   │    │  classify    │    │  language (WW) │    │  .zip    │
   └─────────┘    └──────────────┘    └────────────────┘    └──────────┘

1. Unpack the ZIP entirely in memory (no disk writes).
2. Classify each file by extension — vendor / lockfiles / binaries always skipped.
3. Obfuscate in parallel Web Workers using language-specific engines.
4. Repack with original directory tree → one-click download.

---

🧱 Tech stack

• TanStack Start v1 (React 19 + Vite 7) — SSR-ready, edge-deployable
• Tailwind CSS v4 with semantic design tokens
• shadcn/ui primitives + custom glass-morphism layer
• Web Workers for parallel obfuscation
• JSZip for in-browser archive handling
• Service Worker for PWA + Web Share Target
• Python 3.8+ CLI published to PyPI as justob

---

▲ Deploy

Vercel-ready out of the box (vercel.json included).

1. Push to GitHub.
2. Import the repo in Vercel.
3. Click Deploy. No env vars required.

Also runs on Cloudflare Workers, Netlify, or any Node 20+ host.

---

📁 Project structure

just-obfuscate/
├── src/
│   ├── routes/              # File-based routing (TanStack)
│   │   ├── index.tsx        # Universal mode (homepage)
│   │   ├── zip.tsx          # ZIP project mode
│   │   ├── universal.tsx    # Snippet mode
│   │   ├── decoder.tsx      # Universal deobfuscator
│   │   ├── cli.tsx          # CLI docs
│   │   ├── api.tsx          # HTTP API docs
│   │   └── api/public/      # Public HTTP endpoints
│   ├── components/          # UI components (glass, header, copy-block…)
│   ├── lib/                 # Obfuscation + deobfuscation engines
│   └── styles.css           # Tailwind v4 + theme tokens
├── public/
│   ├── pkg/justob/          # Python CLI source (PyPI package)
│   ├── share-sw.js          # Share-target service worker
│   └── llms.txt             # Machine-readable site summary
└── docs/screenshots/        # README & social previews

---

🔒 Privacy

Nothing leaves your browser in the web app. No analytics on uploaded files. No telemetry on your code. The HTTP API processes ZIPs in-memory and immediately discards them — no storage, no logs of file contents.

---

📤 Publishing

CLI to PyPI

cd public/pkg/justob
python publish.py            # prompts for your PyPI token once and saves it

Site to your own GitHub repo (and Vercel)

A ready-to-run pusher is included — see scripts/push_to_github.py:

python scripts/push_to_github.py

It strips internal/build files, sets your identity (no bot author), and force-pushes a clean tree to your repo.

---

🤝 Contributing

PRs welcome — fork, branch, hack, open a PR. Keep commits atomic.

---

📜 License

MIT © Just Obfuscate

Built with 🛡️ by the Just Obfuscate team

_{If this saved you time, drop a ⭐ on the repo.}