nyan

Author: jumang4423

README.md

@@ -3,167 +3,131 @@
 
   # Patchrome
 
-  A powerful Chrome extension for real-time audio manipulation on web pages. Process any audio playing in your browser with a modular effects chain using visual node-based routing.
+  **🎛️ Real-time audio effects for any website**
+  
+  Transform your browser into a powerful audio processor. Add reverb to YouTube videos, pitch-shift podcasts, or create unique soundscapes from any web audio.
+
+  [![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/jumang4423/patchrome-ext/releases)
+  [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 </div>
 
-## Overview
-
-Patchrome is a Chrome extension that intercepts and processes audio from web pages in real-time. It provides a visual node-based interface where you can build custom audio effect chains by connecting various audio processing nodes together.
-
-### Key Features
+## 🚀 Quick Start
 
-- **Visual Node Editor**: Drag-and-drop interface for building audio effect chains
-- **Real-time Processing**: All effects are applied in real-time with minimal latency
-- **Multiple Effect Types**: 
-  - **Input/Output**: Audio source with speed control and destination nodes
-  - **Effects**: Reverb, Delay, Distortion, Phaser, Flanger, Equalizer (with multiple filter types), Bitcrusher
-  - **Utilities**: Gain/Pan control with phase inversion, Limiter
-  - **Generators**: Tone Generator (sine, triangle, sawtooth, square waves)
-  - **Spectral Effects**: Spectral Gate, Spectral Compressor, Spectral Pitch Shifter
-- **Per-site Compatibility**: Works on most websites with HTML5 audio/video
-- **Persistent Settings**: Your effect chains are saved per session
+### Install from GitHub Release
 
-## Usage Tips
-
-### Quick Actions
-
-- **Right-click on empty space** → Opens the "Add Effect" menu instantly
-- **Double-click on any slider** → Enter precise values manually
-- **Drag nodes** → Rearrange your effect chain visually
-- **Click the power button** → Enable/disable all effects globally
+1. Download the latest `patchrome-ext.zip` from [Releases](https://github.com/jumang4423/patchrome-ext/releases)
+2. Unzip the file
+3. Open Chrome and go to `chrome://extensions/`
+4. Enable "Developer mode" (top right)
+5. Click "Load unpacked" and select the unzipped folder
+6. Click the extension icon in your toolbar to start!
 
-### Effect Parameters
+### How to Use
 
-#### Speed Control (Input Node)
-- Adjust playback speed from 0.5x to 1.5x
-- Preserves pitch automatically
+1. **Open any website** with audio/video (YouTube, SoundCloud, etc.)
+2. **Click the Patchrome icon** in your toolbar
+3. **Right-click in the panel** to add effects
+4. **Connect nodes** by dragging from output to input
+5. **Adjust parameters** with sliders or double-click for precise values
 
-#### Reverb
-- **Mix**: Dry/wet balance (0-100%)
-- **Size**: Room size simulation (0-100%)
-- **Decay**: Reverb tail length in milliseconds
+## ✨ Features
+
+<div align="center">
+  <img src="https://github.com/jumang4423/patchrome-ext/assets/demo.gif" alt="Demo" width="600"/>
+</div>
 
-#### Delay
-- **Delay Time**: Echo delay in milliseconds (0-2000ms)
-- **Feedback**: Echo repetitions (0-100%)
-- **Mix**: Dry/wet balance (0-100%)
+### 🎵 Audio Effects
+- **Reverb** - Add space and ambience
+- **Delay** - Create echoes and rhythmic patterns  
+- **Distortion** - Add grit and warmth
+- **EQ** - Shape your sound with filters
+- **Phaser/Flanger** - Classic modulation effects
+- **Bitcrusher** - Lo-fi digital destruction
+- **Spectral Effects** - Advanced frequency manipulation
 
-#### Utility
-- **Volume**: Gain control in dB (-60 to +12 dB)
-- **Pan**: Stereo positioning (-100 to +100)
-- **Phase Reverse**: Invert right channel phase
+### 🎛️ Visual Node Editor
+- Drag & drop interface
+- Real-time parameter control
+- Save effect chains per session
+- Visual signal flow
 
-#### Distortion
-- **Drive**: Distortion amount (0-100)
-- **Mix**: Dry/wet balance (0-100%)
+### ⚡ Performance
+- Low-latency processing
+- Minimal CPU usage
+- Works with all HTML5 audio/video
 
-#### Equalizer
-- **Filter Type**: Choose from lowpass, highpass, bandpass, or notch filters
-- **Frequency**: Adjustable from 20 Hz to 7777 Hz
-- **Q Factor**: Filter resonance/width (0.1-30)
+## 🎮 Keyboard Shortcuts
 
-#### Limiter
-- **Threshold**: Limiting threshold in dB (-60 to 0 dB)
+- `Space` - Toggle global bypass
+- `Delete` - Remove selected node
+- `Ctrl+Z` - Undo last action
 
-#### Phaser
-- **Rate**: LFO speed (0.1-10 Hz)
-- **Depth**: Modulation depth (0-100%)
-- **Feedback**: Resonance amount (0-100%)
-- **Mix**: Dry/wet balance (0-100%)
+## 🌟 Examples
 
-#### Flanger
-- **Rate**: LFO speed (0.1-10 Hz)
-- **Depth**: Modulation depth (0-100%)
-- **Feedback**: Resonance amount (-100 to +100%)
-- **Delay**: Base delay time (1-20ms)
-- **Mix**: Dry/wet balance (0-100%)
+### YouTube Enhancement
+```
+Input → EQ (boost bass) → Reverb (small room) → Output
+```
 
-#### Tone Generator
-- **Waveform**: Sine, triangle, sawtooth, or square wave
-- **Frequency**: 20-20000 Hz
-- **Volume**: Output level (-60 to 0 dB)
+### Podcast Production
+```
+Input → EQ (voice enhance) → Limiter → Output
+```
 
-#### Bitcrusher
-- **Mix**: Dry/wet balance (0-100%)
-- **Sample Rate**: Reduce sample rate (2000-40000 Hz)
-- **Bit Depth**: Reduce bit resolution (1-16 bits)
+### Creative Sound Design
+```
+Input → Pitch Shift → Delay → Phaser → Reverb → Output
+```
 
-#### Spectral Gate
-- **Cutoff**: Frequency magnitude threshold (-60 to +24 dB)
+## 🤝 Contributing
 
-#### Spectral Compressor
-- **Threshold**: Compression threshold (-60 to 0 dB)
-- **Ratio**: Compression ratio (0.5-1.5)
-- **Attack**: Attack time (0.1-100ms)
-- **Release**: Release time (1-500ms)
-- **Input Gain**: Pre-compression gain (-24 to +24 dB)
+We welcome contributions! Feel free to:
+- Report bugs
+- Suggest new effects
+- Submit pull requests
+- Share your effect presets
 
-#### Spectral Pitch Shifter
-- **Pitch**: Pitch shift in cents (-1200 to +1200, ±1 octave)
-- **Mix**: Dry/wet balance (0-100%)
+## 📝 Development
 
-## Performance Notes
+### Building from Source
 
-The extension uses Web Audio API for processing, which means:
-- Effects are applied at the browser level
-- CPU usage scales with effect complexity
-- Some effects (especially spectral processing) may be CPU-intensive
-
-## Known Issues & TODO
-
-### Platform-Specific Issues
-
-- **YouTube**: Heavy CPU usage when multiple effects are chained, especially with spectral effects. Consider using simpler effect chains for better performance.
-- **Twitter/X**: Video players may experience higher latency with complex effect chains due to the platform's audio handling.
-- **SoundCloud**: Works well with most effects. The extension has special handling for SoundCloud's audio system.
-
-### TODO List
-
-- [ ] Implement preset system for saving/loading effect chains
-- [ ] Add visualization (spectrum analyzer, waveform display)
-- [ ] Optimize performance for complex effect chains
-- [ ] Create effect chain templates for common use cases
-- [ ] Add A/B comparison feature
-- [ ] Implement effect automation/LFO modulation
-- [ ] Add more modulation effects (Chorus, Tremolo, Ring Modulator)
-- [ ] Implement sidechain compression
-- [ ] Add frequency analyzer node for visual feedback
-
-## Development
-
-### Setup
 ```bash
+# Clone the repository
+git clone https://github.com/jumang4423/patchrome-ext.git
+cd patchrome-ext
+
+# Install dependencies
 npm install
-npm run dev  # Watch mode for development
-npm run build  # Production build
+
+# Development build (with watch mode)
+npm run dev
+
+# Production build
+npm run build
 ```
 
 ### Project Structure
 ```
 patchrome-ext/
 ├── src/
-│   ├── background.ts      # Extension background script
-│   ├── content.ts         # Content script injected into pages
-│   ├── inject.js          # Main audio processing logic
-│   ├── sidepanel/         # React-based side panel UI
-│   │   ├── App.tsx
-│   │   └── components/    # UI components
+│   ├── inject.js          # Core audio processing
+│   ├── sidepanel/         # React UI
 │   ├── worklets/          # Audio worklet processors
 │   └── types/             # TypeScript definitions
-├── manifest.json          # Chrome extension manifest
+├── manifest.json          # Extension manifest
 └── webpack.config.js      # Build configuration
 ```
 
 ### Adding New Effects
 
-See [ADD_EFFECT_INSTRUCTIONS.md](ADD_EFFECT_INSTRUCTIONS.md) for detailed instructions on adding new effects.
+See [ADD_EFFECT_INSTRUCTIONS.md](ADD_EFFECT_INSTRUCTIONS.md) for detailed instructions.
 
-For audio worklet-based effects, see [ADD_AUDIO_WORKLET_CUSTOM_EFFECT_INSTRUCTIONS.md](ADD_AUDIO_WORKLET_CUSTOM_EFFECT_INSTRUCTIONS.md).
+## 📄 License
 
-## License
+MIT License - feel free to use in your own projects!
 
-This project is open source. Feel free to use and modify as needed.
+---
 
-## Contributing
-
-Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.
+<div align="center">
+  Made with ❤️ by <a href="https://github.com/jumang4423">jumang4423</a>
+</div>

RELEASE.md

@@ -0,0 +1,76 @@
+# GitHub Release Guide
+
+## Creating a Release
+
+### 1. Build the Extension
+
+```bash
+# Make sure you have a clean build
+npm run build
+```
+
+### 2. Create Distribution Package
+
+```bash
+# Create a zip file containing the built extension
+zip -r patchrome-ext.zip dist/ manifest.json icon*.png logo.png
+```
+
+### 3. Create GitHub Release
+
+1. Go to your repository on GitHub
+2. Click on "Releases" → "Create a new release"
+3. Choose a tag (e.g., `v1.0.0`)
+4. Fill in release details:
+   - **Release title**: `Patchrome v1.0.0`
+   - **Description**: Include changelog and features
+5. Upload `patchrome-ext.zip` as a release asset
+6. Publish release
+
+### 4. Update README
+
+Update the version badge in README.md to match the new release version.
+
+## Release Checklist
+
+- [ ] Update version in `manifest.json`
+- [ ] Update version in `package.json`
+- [ ] Test the extension thoroughly
+- [ ] Build production version (`npm run build`)
+- [ ] Create zip file
+- [ ] Create GitHub release
+- [ ] Upload zip file to release
+- [ ] Update README version badge
+- [ ] Announce release (optional)
+
+## Version Naming
+
+Follow semantic versioning:
+- `MAJOR.MINOR.PATCH` (e.g., 1.0.0)
+- MAJOR: Breaking changes
+- MINOR: New features
+- PATCH: Bug fixes
+
+## Example Release Description
+
+```markdown
+## 🎉 Patchrome v1.0.0
+
+First public release of Patchrome - Real-time audio effects for any website!
+
+### ✨ Features
+- Visual node-based audio routing
+- 15+ audio effects including reverb, delay, distortion, and more
+- Real-time processing with minimal latency
+- Per-site effect chains
+- Works with YouTube, SoundCloud, and any HTML5 audio/video
+
+### 📦 Installation
+1. Download `patchrome-ext.zip` from the assets below
+2. Unzip the file
+3. Open `chrome://extensions/`
+4. Enable "Developer mode"
+5. Click "Load unpacked" and select the folder
+
+Enjoy transforming your browser audio! 🎵
+```

main.py

@@ -0,0 +1,46 @@
+import anyio
+from claude_code_sdk import query, Config, CLINotFoundError
+import sys
+
+
+async def main():
+    try:
+        # Simple example - ask Claude a question
+        print("Asking Claude: What is 2 + 2?")
+        print("-" * 40)
+        
+        async for message in query(prompt="What is 2 + 2?"):
+            print(message, end="", flush=True)
+        
+        print("\n" + "-" * 40)
+        
+        # More complex example with configuration
+        config = Config(
+            system_prompt="You are a helpful Python programming assistant.",
+            max_conversation_turns=3,
+            allowed_tools=["Read", "Write", "Bash"],
+            working_directory="."
+        )
+        
+        print("\nAsking Claude to help with Python:")
+        print("-" * 40)
+        
+        async for message in query(
+            prompt="Create a simple hello world function in Python and explain it",
+            config=config
+        ):
+            print(message, end="", flush=True)
+        
+        print("\n" + "-" * 40)
+        
+    except CLINotFoundError:
+        print("Error: Claude Code CLI not found. Please install it with:")
+        print("npm install -g @anthropic-ai/claude-code")
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    anyio.run(main)