🩸 CodeBlooded for VS Code

Are you brave enough? Your IDE will never feel safe again.

Transform your coding environment into a psychological horror experience where your code complexity literally haunts you. The deeper your code's complexity, the more intense the nightmare becomes.

Phantom keystrokes type themselves. Your variables whisper secrets. The screen warps and distorts. And when you least expect it... boom.

💡 Best experienced in VS Code Dark Mode for maximum immersion!

🎮 Two Modes of Experience

🌙 Safe Mode (Default)

Perfect for those who want feedback without the frights:

Color-coded complexity highlighting (Blue → Purple → Orange → Red)
Audio tones that reflect your code quality
Visual graphs showing code structure
Health Score in status bar
No horror effects - just clean, useful feedback

☠️ Horror Mode (Opt-In)

For the brave souls who dare to enable codeblooded.horror.enabled:

Everything in Safe Mode, PLUS...
Jumpscares with synchronized audio (6 unique variants!)
Screen distortions (VHS, glitch, chromatic aberration, screen shake)
Phantom typing that writes itself ("help me", "run", "it sees you")
Whispering variables with creepy overlays
Entity presence - eyes watching from the gutter
Progressive escalation - it gets worse the longer you code
Easter eggs - discover hidden horrors

⚠️ IMPORTANT SAFETY WARNING ⚠️

CodeBlooded contains optional psychological horror features including:

Flashing lights and rapid visual changes
Jump scares with disturbing imagery
Unsettling audio effects
Unpredictable horror events

NOT RECOMMENDED for users with:

Photosensitive epilepsy or seizure disorders
Anxiety disorders or PTSD
Heart conditions sensitive to sudden stress
Preference for calm coding environments

SAFETY FEATURES:

Panic Button: Press Ctrl+Alt+S (or Cmd+Alt+S on Mac) to instantly disable all horror effects
Safe Mode: Horror features are DISABLED by default - you must explicitly opt-in
Accessibility: Automatically respects "Reduce Motion" and other accessibility settings
First-Run Warning: You'll see a detailed warning before any horror features activate

See SAFETY_FEATURES.md for complete safety documentation.

Features

🎵 Real-Time Audio Feedback

Hear your code's complexity through horror-themed audio:

Low Complexity (1-5): Deep calm hum - all good
Medium Complexity (6-10): Eerie dissonant notes - acceptable
High Complexity (11-15): Sharp tension tones - consider refactoring
Critical Complexity (16+): Harsh distorted chaos - refactor now!

Audio plays automatically after you stop typing (1 second debounce).

🎨 Color-Coded Highlighting

Visual feedback overlays directly in your editor:

Midnight Blue (#191970): Low complexity - all good
Toxic Purple (#9400D3): Medium complexity - acceptable
Blood Orange (#CC5500): High complexity - consider refactoring
Crimson Red (#DC143C): Critical complexity - refactor immediately

📈 Health Score

Status bar displays an overall code quality score (0-100):

90-100: Excellent - clean, maintainable code
70-89: Good - minor improvements possible
50-69: Fair - refactoring recommended
Below 50: Poor - significant refactoring needed

🎃 Horror Effects (When Enabled)

When you enable Horror Mode, experience:

Screen distortions: VHS artifacts, glitch effects, chromatic aberration
Phantom typing: Brief messages appear and vanish
Whispering variables: Names overlay with creepy alternatives
Entity presence: Eyes appear in the editor gutter
Jumpscares: Full-screen horror with audio (you've been warned)

Installation

From VS Code Marketplace

Open VS Code
Press Ctrl+P (Windows/Linux) or Cmd+P (Mac)
Type: ext install AakritiHGupta.codeblooded-vscode
Press Enter

From VSIX File

Download the .vsix file from releases
Open VS Code
Go to Extensions view (Ctrl+Shift+X)
Click ... menu → Install from VSIX...
Select the downloaded file

Quick Start

Open a supported file
- Extension activates automatically for .ts, .tsx, .js, .jsx, .py files
Start coding
- Audio and visual feedback activates as you type
- Decorations appear after 1 second of inactivity
View the AST graph
- Run command: CodeBlooded: Show AST Graph
- Or click the graph icon in the status bar
Toggle audio
- Run command: CodeBlooded: Toggle Audio Feedback
- Or click the audio icon in the status bar

Commands

Access commands via Command Palette (Ctrl+Shift+P or Cmd+Shift+P):

Command	Description	Keyboard Shortcut
`CodeBlooded: Panic Button`	EMERGENCY: Instantly disable all horror effects	`Ctrl+Alt+S`
`CodeBlooded: Toggle Safe Mode`	Enable/disable horror features	-
`CodeBlooded: Toggle Audio Feedback`	Enable/disable audio playback	-
`CodeBlooded: Show AST Graph`	Open interactive graph visualization	-

Configuration

Configure CodeBlooded via VS Code settings (Ctrl+, or Cmd+,):

Safety Settings

{
  "codeblooded.horror.enabled": false,
  "codeblooded.horror.intensity": 50,
  "codeblooded.safety.screenSharingMode": false,
  "codeblooded.safety.respectReduceMotion": true
}

codeblooded.horror.enabled (boolean, default: false)
- ⚠️ Enable psychological horror features (jumpscares, random events)
- DISABLED by default for safety
codeblooded.horror.intensity (number, default: 50)
- Horror intensity level (0-100)
- Higher values = more frequent and intense effects
codeblooded.safety.screenSharingMode (boolean, default: false)
- Enable when screen sharing to auto-disable horror effects
codeblooded.safety.respectReduceMotion (boolean, default: true)
- Respect system "Reduce Motion" accessibility setting

Audio Settings

{
  "codeblooded.audio.enabled": true,
  "codeblooded.audio.volume": 0.5
}

codeblooded.audio.enabled (boolean, default: true)
- Enable or disable audio feedback globally
codeblooded.audio.volume (number, default: 0.5)
- Master volume level (0.0 - 1.0)

Visual Settings

{
  "codeblooded.visual.animations": true,
  "codeblooded.visual.workspaceTint": true
}

codeblooded.visual.animations (boolean, default: true)
- Enable or disable horror-themed animations (cobwebs, blood drips, fog)
codeblooded.visual.workspaceTint (boolean, default: true)
- Tint the entire workbench with horror palette as complexity increases

Analysis Settings

{
  "codeblooded.analysis.threshold": 10
}

codeblooded.analysis.threshold (number, default: 10)
- Complexity threshold for warnings
- Functions above this value trigger warnings

Status Bar

CodeBlooded adds two status bar items:

Health Score Indicator

Location: Left side of status bar
Format: 🎨 Health: 85
Click: Shows detailed metrics in output panel

Audio State Indicator

Location: Right side of status bar
Format: 🔊 (enabled) or 🔇 (disabled)
Click: Toggles audio on/off

How It Works

Analysis Pipeline

Code Change → Debounce (1s) → AST Parse → Complexity Analysis →
Sensory Mapping → Audio Synthesis + Visual Decorations

Complexity Calculation

CodeBlooded calculates cyclomatic complexity by counting decision points:

function example(a, b) {
  if (a > 0) {           // +1
    if (b > 0) {         // +1
      return a + b;
    } else {             // +1
      return a;
    }
  } else if (a < 0) {    // +1
    return -a;
  }
  return 0;
}
// Cyclomatic Complexity = 1 + 4 = 5 (Low)

Decision Points:

if, else if, else
while, for, do-while
case in switch statements
&&, || logical operators
? ternary operators
catch blocks

Audio Synthesis

Uses Web Audio API with Tone.js for advanced synthesis:

Oscillator Creation: Generate base frequency based on complexity
Waveform Selection: Sine → Triangle → Sawtooth → Square
Effect Chain: Apply reverb, tremolo, or distortion
Playback: Fade in/out to prevent audio clicks

Visual Rendering

D3.js force-directed graph with custom styling:

Node Generation: Create nodes for files, functions, classes
Edge Generation: Connect nodes based on dependencies
Force Simulation: Apply physics for organic layout
Theme Application: Add horror effects (cobwebs, skulls, fog)
Interaction: Enable zoom, pan, hover, and click

Supported Languages

Full Complexity Analysis:

TypeScript (.ts, .tsx)
JavaScript (.js, .jsx)
Python (.py)

Basic Support (syntax highlighting, decorations):

Java, C#, Go, Rust, C/C++, PHP, Ruby, Swift, Kotlin, Scala
HTML, CSS, SCSS, LESS

More languages with full AST analysis coming soon!

Performance

Parse Time: < 500ms for files under 1000 lines
Analysis Time: < 200ms for typical files
Audio Latency: < 100ms
UI Responsiveness: No blocking, all analysis runs asynchronously

Performance Tips

Disable animations for large files: Set codeblooded.visual.animations to false
Adjust debounce: Extension waits 1 second after typing before analyzing
Disable audio in noisy environments: Use toggle command or status bar icon

Troubleshooting

Audio Not Playing

Issue: No sound when typing code

Solutions:

Check audio is enabled: Click status bar icon or run toggle command
Check system volume: Ensure speakers/headphones are working
Check browser audio permissions: Some environments require user gesture
Restart VS Code: Reload window with Developer: Reload Window

Decorations Not Appearing

Issue: No color highlighting in editor

Solutions:

Ensure file is TypeScript, JavaScript, or Python
Check for syntax errors: Extension skips files with parse errors
Wait 1 second after typing: Debounce delay before analysis
Check extension is activated: Look for status bar items

Graph Not Rendering

Issue: Webview panel is blank or shows errors

Solutions:

Check browser console: Open Developer: Toggle Developer Tools
Reload webview: Close and reopen with Show AST Graph command
Check file has dependencies: Graph requires imports/calls to show edges
Update VS Code: Ensure you're on version 1.80.0 or higher

High CPU Usage

Issue: VS Code becomes slow or unresponsive

Solutions:

Disable animations: Set codeblooded.visual.animations to false
Increase threshold: Set codeblooded.analysis.threshold higher to reduce warnings
Close graph webview: Visualization can be resource-intensive
Analyze smaller files: Split large files into smaller modules

Privacy

CodeBlooded runs entirely locally. No code or data is sent to external servers.

No telemetry: We don't collect usage data
No network requests: All analysis happens on your machine
No code storage: Code is analyzed in memory only

Known Issues

Safari-based environments may require user gesture before audio plays
Very large files (>5000 lines) may experience slower analysis
Graph rendering with >200 nodes can be slow

See GitHub Issues for full list.

Roadmap

[x] Python language support ✓
[ ] Java, C++ full AST analysis
[ ] Custom theme editor
[ ] Export analysis reports
[ ] Integration with GitHub Actions

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Feedback

Bug Reports: GitHub Issues
Feature Requests: GitHub Issues

License

MIT - see LICENSE for details

@codeblooded/core - Core complexity analysis engine

Made with 🩸 by the CodeBlooded team

Embrace the horror of complex code

codeblooded - Kiroween

Aakriti H. Gupta

🩸 CodeBlooded for VS Code

🎮 Two Modes of Experience

🌙 Safe Mode (Default)

☠️ Horror Mode (Opt-In)

⚠️ IMPORTANT SAFETY WARNING ⚠️

Features

🎵 Real-Time Audio Feedback

🎨 Color-Coded Highlighting

📈 Health Score

🎃 Horror Effects (When Enabled)

Installation

From VS Code Marketplace

From VSIX File

Quick Start

Commands

Configuration

Safety Settings

Audio Settings

Visual Settings

Analysis Settings

Status Bar

Health Score Indicator

Audio State Indicator

How It Works

Analysis Pipeline

Complexity Calculation

Audio Synthesis

Visual Rendering

Supported Languages

Performance

Performance Tips

Troubleshooting

Audio Not Playing

Decorations Not Appearing

Graph Not Rendering

High CPU Usage

Privacy

Known Issues

Roadmap

Contributing

Feedback

License

Related