Audio bitcrusher with real-time preview.
Created by CATHOUSEMP3.
- Bit Depth Reduction — 16-bit down to 1-bit quantization
- Downsampling — Sample rate reduction with aliasing artifacts
- Waveshaping — Tanh-based harmonic saturation
- Noise Injection — Gaussian white noise
- Wet/Dry Mix — Blend processed and original signals
- Subtle — Light processing
- Retro — Classic 8-bit character
- Harsh — Aggressive digital distortion
- Destroy — Maximum bit reduction
- Lo-Fi — Warm low-fidelity tone
- Gameboy — 4-bit console style
- Telephone — Band-limited degradation
- Supports WAV, MP3, FLAC, OGG, AIFF
- Real-time parameter updates during playback
- Export processed audio to WAV, FLAC, OGG, AIFF
- Python 3.8+
- Windows, macOS, or Linux
git clone https://github.com/CATHOUSEMP3/ghostkitty-bitcrusher.git
cd ghostkitty-bitcrusher
pip install -r requirements.txt
python main.pynumpy— Numerical processingscipy— Signal processingsoundfile— Audio file I/Opygame— Audio playbackcustomtkinter— GUI frameworkPillow— Image support for GUI
- Load an audio file (Ctrl+O or click Load File)
- Adjust the processing controls — changes apply immediately
- Play to preview (Space bar or click Play)
- Save the processed result (Ctrl+S or click Save to File)
| Key | Action |
|---|---|
Space |
Play / Pause |
Ctrl+O |
Open file |
Ctrl+S |
Save file |
- Sample rate: 44.1 kHz (matches source file)
- Bit depth: Variable (1–16 bit)
- Processing: Full-file with pygame playback
- Bit Crushing — Quantization-based bit depth reduction
- Downsampling —
scipy.signal.resamplewith proper axis handling for stereo - Waveshaping —
tanhsoft-clipping with adjustable drive - Noise — Gaussian white noise injection
- Fork the repository
- Create a feature branch
- Commit changes
- Open a Pull Request
MIT License — see LICENSE for details.
Created by CATHOUSEMP3.
Dependencies: CustomTkinter, Pygame, NumPy, SoundFile, SciPy.