Skip to content

ScanScratch v1.0.0 - Initial Release

Choose a tag to compare

View all tags
@mitchaiet mitchaiet released this 15 Dec 17:31
· 17 commits to main since this release
v1.0.0
d0816cf

SCANSCRATCH v1.0.0

SSTV Glitch Art Generator

⚠️ Mac App Status

The packaged Mac app (.dmg) has been removed due to PyInstaller/scipy incompatibility.

The transmit button does not work in the bundled app due to a known PyInstaller bug with scipy.

Please run from source instead - it works perfectly! See installation instructions below.

🎨 Features

Core Functionality

  • SSTV Encoding/Decoding: Convert images to SSTV audio and back
  • Multiple SSTV Modes: Martin M1/M2, Scottie S1/S2, Robot 36
  • Glitch Art Pipeline: 10 audio effects for creative distortion
  • Professional UI: Audio plugin-style rotary knobs and real-time visualization

16 Curated Presets

Aesthetic (Instagram-ready):

  • Vintage VHS, Lo-Fi Aesthetic, Analog Warmth
  • Retro Broadcast, Film Grain, Pastel Dream
  • Subtle Glitch, Soft Corruption

Moderate (Recognizable glitching):

  • Transmission Error, Signal Drift, Color Bleed

Extreme (Abstract art):

  • Total Corruption, Frequency Hell, Reality Break
  • Glitch Storm, Data Nightmare

Audio Effects

  • Noise (White/Pink/Crackle)
  • Bit Crushing & Sample Rate Reduction
  • Phase Modulation
  • Amplitude Modulation
  • Harmonic Distortion
  • Frequency Shifting
  • Band-pass Filtering
  • Delay/Echo
  • Time Stretching
  • Scanline Corruption

Advanced Features

  • A/B Comparison: Toggle between clean and glitched output
  • Real-time Waveform: Visualize the SSTV audio signal
  • Audio Playback: Hear the transmission in real-time
  • Advanced Export:
    • Multiple formats (PNG, JPEG, TIFF, WebP, BMP)
    • Size presets (1080p, 2K, 4K, Instagram)
    • Custom dimensions with aspect ratio lock
    • Auto-increment filenames

📦 Installation

Run from Source (Recommended - All Platforms)

# Clone the repository
git clone https://github.com/mitchaiet/ScanScratch.git
cd ScanScratch

# Install dependencies
pip3 install -r requirements.txt

# Run
python3 main.py

Works perfectly on macOS, Windows, and Linux!

🎯 Quick Start

  1. Load an image: Click OPEN or drag & drop
  2. Choose a preset: Try "Vintage VHS" or "Lo-Fi Aesthetic"
  3. Hit TRANSMIT: Watch the real-time decoding
  4. Toggle A/B: Compare glitched vs original
  5. Export: Save your glitch art

🛠️ Technical Details

  • Python 3.12+
  • PyQt6 for UI
  • pysstv for SSTV encoding
  • scipy for signal processing (custom decoder)
  • numpy for audio manipulation
  • sounddevice for audio playback

📸 Use Cases

  • Glitch art creation
  • Aesthetic Instagram/TikTok content
  • Album artwork
  • VHS/retro effects
  • SSTV experimentation
  • Ham radio image transmission testing

🤖 Generated with Claude Code

Built with assistance from Claude Code

What's New in v1.0.0:

  • Initial public release
  • 16 presets across aesthetic/moderate/extreme intensity levels
  • Professional rotary knob UI
  • Comprehensive export features
  • A/B comparison mode
  • Run from source for full functionality
Assets 2
Loading