# Bashfuscator/Bashfuscator

A fully configurable and extendable Bash obfuscation framework. This tool is intended to help both red team and blue team.

Repository: https://github.com/Bashfuscator/Bashfuscator
Canonical: https://ross.abutalabs.com/products/bashfuscator
Homepage: https://bashfuscator.readthedocs.io/en/latest/index.html
Language: Python
License: MIT
License Family: permissive
Topics: bash, linux, linux-shell, obfuscation, red-team, blue-team, evasion, incident-response, infosec
Last push: 2023-09-05T10:40:25+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2952, "days_push": 1093, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1994, forks 201 (observed 2026-08-28T04:06:03.324112+00:00)

## What it is
Bashfuscator is a modular, configurable Bash obfuscation framework written in Python 3 that transforms Bash commands and scripts into convoluted, randomized code that evaluates to the original input at runtime. It is designed for red teams to bypass static detections and for blue teams to generate test corpora for building obfuscation detections.

## Use cases
- obfuscate a bash one-liner to evade static detection
- generate thousands of unique obfuscated bash scripts for testing detections
- build blue team detection rules for bash obfuscation techniques
- extend the framework with custom bash obfuscation mutators
- study bash obfuscation techniques for incident response analysis

## When to choose
- you need configurable, randomized bash obfuscation on GNU Linux with Bash 4.0+
- you are a red teamer testing static detection of bash payloads
- you are a blue teamer generating obfuscation samples to train or validate detections

## When to avoid
- you target BSD or non-GNU UNIX systems, where generated payloads may not work
- you need obfuscation for shells other than bash
- you need a maintained tool with frequent updates, as the latest release is from 2023

## Facets
- artifact type: framework
- maturity: maintenance
- function: security, cli, developer-tools
- domain: security, penetration-testing, developer-tools
- platform: python, cli
- tags: bash-obfuscation, red-team, blue-team, evasion, payload-generation, detection-testing, command-line, linux

## Member repositories
- Bashfuscator/Bashfuscator (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:03.324112+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:02:31.866399+00:00, confidence not recorded.
  - readme: https://github.com/Bashfuscator/Bashfuscator (fetched 2026-08-28T04:06:03.324112+00:00, sha 88abf6d00ba7)
- Data as of 2026-08-30T08:39:29.467469+00:00.