obfuscator-ai 0.1.5

AI-powered code obfuscation utility

obfuscator-ai

Interactive code obfuscation tool with AI-powered pattern recognition. Protect sensitive information in your code by replacing identifiable elements with secure placeholders.

Features

• Interactive GUI - Click any word to instantly obfuscate it
• Pattern Recognition - Automatically detect and obfuscate similar patterns
• Smart Detection - Auto-identifies emails, IPs, GUIDs, paths, and namespaces
• Reversible - Full deobfuscation with preserved mappings
• Multiple Modes - Exact word matching or pattern-based obfuscation
• Persistent Mappings - Reuse obfuscation mappings across sessions

Installation

pip install obfuscator-ai

Usage

Basic Usage

1. Copy your code to clipboard
2. Run the obfuscator:

from obfuscator_ai import SecureObfuscator
import pyperclip

obf = SecureObfuscator()
obf.run_interactive(pyperclip.paste())

Or run directly:

python -m obfuscator_ai

GUI Controls

• Click any word - Obfuscate all instances
• Mode Toggle - Switch between exact and pattern matching
• Pattern Buttons:
  • GUIDs - Obfuscate all GUID patterns
  • Methods - Obfuscate C# method names
  • Lambda Props - Obfuscate lambda properties
  • All Strings - Obfuscate all string literals
• UNDO - Revert last action (Ctrl+Z)
• Show Mappings - View all obfuscation mappings
• Deobfuscate All - Restore original text and close
• Close & Copy - Copy obfuscated text to clipboard

Placeholder Types

The tool uses different prefixes for different content types:

• SENSITIVE### - Sensitive words from config
• URL### - Web URLs
• STRING### - String literals
• ANONYMIZED### - User-selected words
• PATTERN### - Pattern-matched content
• GUID### - GUID identifiers
• EMAIL### - Email addresses
• IP### - IP addresses
• PATH### - File paths
• NAMESPACE### - Code namespaces
• METHOD### - Method names
• LAMBDA_PROP### - Lambda properties

Configuration

Create config.json in your working directory:

{
  "sensitive_words": ["password", "apikey", "secret"],
  "rules": [
    {
      "pattern": "\\b[A-Z]{3}\\d{4}\\b",
      "prefix": "ID",
      "whole_match": true
    }
  ]
}

Examples

Before Obfuscation

public class UserService {
    private string apiKey = "sk-1234567890";
    
    public User GetUser(string email) {
        var user = db.Users.FirstOrDefault(u => u.Email == email);
        logger.LogInformation($"Retrieved user: {email}");
        return user;
    }
}

After Obfuscation

public class CLASS1 {
    private string STRING1 = "STRING2";
    
    public CLASS2 METHOD1(string ANONYMIZED1) {
        var ANONYMIZED2 = ANONYMIZED3.CLASS3.METHOD2(LAMBDA_PROP1 => LAMBDA_PROP1.ANONYMIZED1 == ANONYMIZED1);
        METHOD3.METHOD4($"LOG_CONTENT1");
        return ANONYMIZED2;
    }
}

Mappings

Mappings are saved to mapping.json and persist between sessions. This allows you to:

• Maintain consistent obfuscation across multiple files
• Share obfuscated code while keeping mappings secure
• Deobfuscate at any time with the original mappings

Security Notes

• Mappings file contains sensitive data - keep it secure
• Don't commit mapping files to version control
• Use different mappings for different security contexts
• The tool is for protecting sensitive information, not encryption

License

MIT